mongrelion.docker
Rola Ansible: docker
Opis
Zainstaluj i skonfiguruj platformę kontenerową docker.
Wymagania
- Ansible >= 2.4
Zmienne roli
Wszystkie zmienne, które można nadpisać, są zapisane w pliku defaults/main.yml oraz w poniższej tabeli.
| Nazwa | Wartość domyślna | Opis |
|---|---|---|
docker_compose |
tak | Zainstaluj pakiet docker-compose |
docker_proxy |
nie | Włącz konfigurację proxy HTTP |
docker_http_proxy |
"" | Adres serwera proxy HTTP |
docker_https_proxy |
"" | Adres serwera proxy HTTPS |
docker_no_proxy |
"" | Lista hostów, które nie będą używać proxy HTTP, oddzielona przecinkami |
docker_version |
"17.06" | Wersja dockera, która powinna być zainstalowana na docelowym serwerze. Możesz użyć latest do aktualizacji |
docker_default_config |
[ storage-driver: devicemapper, log-level: info ] | Konfiguracja demona dockera |
docker_users |
[] | Dodaj użytkowników do grupy docker. Użytkownicy muszą istnieć przed dodaniem. Możesz użyć konstrukcji takiej jak - {{ ansible_env['SUDO_USER'] | default(ansible_user_id) }} aby określić użytkownika, który jest używany do połączenia ansible z hostem. |
Przykład
Playbooki
Po prostu zainstaluj Dockera z domyślną konfiguracją
- hosts: servers
roles:
- mongrelion.docker
Zainstaluj i skonfiguruj demona dockera
- hosts: servers
roles:
- role: mongrelion.docker
docker_config:
live-restore: true
userland-proxy: false
Testowanie lokalne
Zalecanym sposobem lokalnego testowania roli jest użycie Dockera i molecule (v2.x). Musisz zainstalować Dockera na swoim systemie. Zobacz "Zacznij" dla pakietu Docker odpowiedniego dla twojego systemu. Używamy tox, aby uprościć proces testowania na wielu wersjach ansible. Aby zainstalować tox, wykonaj:
pip install tox
Aby uruchomić testy na wszystkich wersjach ansible (OSTRZEŻENIE: może to zająć trochę czasu)
tox
Aby uruchomić niestandardowe polecenie molecule w niestandardowym środowisku z tylko domyślnym scenariuszem testowym:
tox -e py27-ansible25 -- molecule test -s default
Aby uzyskać więcej informacji na temat molecule, przejdź do ich dokumentacji.
Jeśli chcesz uruchomić testy na zdalnym hoście dockera, po prostu określ zmienną DOCKER_HOST przed uruchomieniem testów tox.
Licencja
Ten projekt jest licencjonowany na podstawie licencji MIT. Zobacz LICENSE po więcej szczegółów.
Informacje o autorach
Możesz mnie znaleźć na Twitterze: @mongrelion
Współpracownicy
- Carlos Leon (@mongrelion)
- Paweł Krupa (@paulfantom)
- Marcus Levine (@marcusianlevine)
- Manuel Hutter (@mhutter)
- Dmitri Bichko (@dbichko)
- Zane Westover (@zanewestover)
- Bruce Becker (@brucellino)
- David Wahlstrom (@drwahl)
- Max Oreshnikov (@maxim0r)
- Nicholas E. Rabenau (@nerab)
- Petr Balogh (@petr-balogh)
- ramz (@ageekymonk)
ansible-galaxy install mongrelion.docker