PeterMosmans.virtualbox-guest

Rôle Ansible : virtualbox-guest

Statut de construction pour ce rôle : Statut de construction

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]

À propos du projet

Builds and installs VirtualBox guest additions - either from ISO file or downloads the necessary files.

Installer
ansible-galaxy install PeterMosmans.virtualbox-guest
Licence
gpl-3.0
Téléchargements
1.5k
Propriétaire
Lead pentester, security consultant, trainer