PeterMosmans.virtualbox-guest
Rola Ansible: virtualbox-guest
Ta rola buduje, instaluje i konfiguruje żądane dodatki gościa VirtualBox. Szuka w gości zamontowanego ISO zawierającego VBoxGuestAdditions lub pliku ISO. Gdy nie zostanie znalezione, może pobrać potrzebny plik ISO bezpośrednio z download.virtualbox.org
.
Wymagania
Brak, wszystkie wymagane składniki będą instalowane (i mogą zostać usunięte później). Jeśli nie ustawisz zmiennej virtualbox_keep na true, wszystkie pakiety, które zostały zainstalowane do budowy, zostaną usunięte (pakiety zainstalowane będą dokładnie takie same jak przed uruchomieniem roli).
- bzip2
- dkms
- gcc
- make
- nagłówki jądra linux
Zmienne roli
Dostępne zmienne są wymienione poniżej, z domyślnymi wartościami.
virtualbox_keep: Zmienna logiczna informująca, czy pakiety potrzebne do kompilacji powinny pozostać w systemie. Jeśli nie określono, domyślnie jest to no.
virtualbox_iso: Miejsce w gościu, gdzie oczekiwane jest ISO. Należy pamiętać, że ten plik zostanie usunięty po pomyślnej kompilacji.
local_virtualbox_iso: Miejsce na hoście, gdzie znajduje się ISO. W systemie linux znajduje się pod /usr/share/virtualbox/VBoxGuestAdditions.iso
. Jeśli ta zmienna jest ustawiona, rola skopiuje plik ISO z hosta do gościa.
virtualbox_remove_os_packages: Zmienna logiczna informująca, czy usunąć jakiekolwiek wcześniej zainstalowane pakiety VirtualBox. Jeśli nie określono, domyślnie jest to no.
virtualbox_version: Żądana wersja VirtualBox. Jeśli bieżąca wersja nie zgadza się z żądaną wersją, spróbuje (ponownie) zainstalować dodatki gościa VirtualBox. Jeśli ustawiona na auto
, spróbuje określić wersję VirtualBox systemu gospodarza. Domyślne wartości można znaleźć w defaults/main.yml
.
virtualbox_version: auto
virtualbox_x11: Zmienna logiczna informująca, czy dodatki gościa VirtualBox będą kompilowane z obsługą x11. Jeśli nie określono, domyślnie jest to no.
Zależności
Brak.
Przykładowy playbook
- hosts: all
become: yes
become_method: sudo
roles:
- role: PeterMosmans.virtualbox-guest
Ten przykład zainstaluje dodatki gościa VirtualBox i nie zachowa pakietów do budowy w systemie, jeśli będą potrzebne do ich instalacji.
Licencja
GPLv3
Informacje o autorze
Stworzone przez Petera Mosmansa.
Wszystkie wkłady są mile widziane! Podziękowania dla wszystkich dotychczasowych współpracowników: zobacz [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