PeterMosmans.virtualbox-guest
Rôle Ansible : virtualbox-guest
Statut de construction pour ce rôle :
Ce rôle construit, installe et configure les ajouts invités VirtualBox demandés. Il cherche dans l'invité un ISO monté contenant les VBoxGuestAdditions, ou un fichier ISO. Si aucun n'est trouvé, il peut télécharger le fichier ISO nécessaire directement depuis download.virtualbox.org
.
Exigences
Aucune, tous les prérequis seront installés (et peuvent être supprimés par la suite). Si vous ne définissez pas la variable virtualbox_keep à vrai, tous les paquets qui ont été installés pour la construction seront supprimés (les paquets installés seront exactement les mêmes qu'avant l'exécution du rôle).
- bzip2
- dkms
- gcc
- make
- headers linux
Variables du Rôle
Les variables disponibles sont listées ci-dessous, avec les valeurs par défaut.
virtualbox_keep : Un booléen indiquant si les paquets nécessaires à la compilation doivent être conservés sur le système. Si non spécifié, la valeur par défaut est non.
virtualbox_iso : L'emplacement sur l'invité où l'ISO est attendu. Notez que ce fichier sera supprimé après une compilation réussie.
local_virtualbox_iso : Emplacement sur l'hôte où se trouve l'ISO. Sur Linux, il est situé sous /usr/share/virtualbox/VBoxGuestAdditions.iso
. Si cette variable est définie, le rôle copiera le fichier ISO de l'hôte vers l'invité.
virtualbox_remove_os_packages : Un booléen indiquant s'il faut supprimer les paquets VirtualBox précédemment installés. Si non spécifié, la valeur par défaut est non.
virtualbox_version : La version demandée de VirtualBox. Si la version actuelle ne correspond pas à cette version, elle essaiera de (ré)installer les ajouts invités VirtualBox. Si défini sur auto
, il essaiera de déterminer la version de VirtualBox du système hôte. Les valeurs par défaut peuvent être trouvées dans defaults/main.yml
.
virtualbox_version: auto
virtualbox_x11 : Un booléen indiquant si les ajouts invités VirtualBox seront compilés avec le support x11. Si non spécifié, la valeur par défaut est non.
Dépendances
Aucune.
Exemple de Playbook
- hosts: all
become: yes
become_method: sudo
roles:
- role: PeterMosmans.virtualbox-guest
Cet exemple installera les ajouts invités VirtualBox et ne gardera pas les paquets de construction sur le système s'ils sont nécessaires pour les installer.
Licence
GPLv3
Informations sur l'Auteur
Créé par Peter Mosmans.
Les contributions sont plus que bienvenues ! Merci à tous les contributeurs jusqu'à présent : voir [https://github.com/PeterMosmans/ansible-role-virtualbox-guest/graphs/contributors]
Builds and installs VirtualBox guest additions - either from ISO file or downloads the necessary files.
ansible-galaxy install PeterMosmans.virtualbox-guest