mongrelion.docker
Rôle Ansible : docker
Description
Installer et configurer la plateforme de conteneurisation docker.
Exigences
- Ansible >= 2.4
Variables de rôle
Toutes les variables qui peuvent être remplacées sont stockées dans le fichier defaults/main.yml ainsi que dans le tableau ci-dessous.
Nom | Valeur par défaut | Description |
---|---|---|
docker_compose |
oui | Installer le package docker-compose |
docker_proxy |
non | Activer la configuration du proxy HTTP |
docker_http_proxy |
"" | Adresse du serveur proxy HTTP |
docker_https_proxy |
"" | Adresse du serveur proxy HTTPS |
docker_no_proxy |
"" | Liste séparée par des virgules des hôtes qui ne doivent pas utiliser le proxy HTTP |
docker_version |
"17.06" | Version de docker à installer sur le serveur cible. Peut utiliser latest pour les mises à jour |
docker_default_config |
[storage-driver: devicemapper, log-level: info] | Configuration du démon Docker |
docker_users |
[] | Ajouter des utilisateurs au groupe docker. Les utilisateurs doivent exister avant l'ajout. La construction comme `- {{ ansible_env['SUDO_USER'] |
Exemple
Playbooks
Installer Docker avec la configuration par défaut
- hosts: serveurs
roles:
- mongrelion.docker
Installer et configurer le démon docker
- hosts: serveurs
roles:
- role: mongrelion.docker
docker_config:
live-restore: true
userland-proxy: false
Test local
La méthode préférée pour tester le rôle localement est d'utiliser Docker et molecule (v2.x). Vous devrez installer Docker sur votre système. Consultez "Démarrer" pour un package Docker adapté à votre système. Nous utilisons tox pour simplifier le processus de test sur plusieurs versions d'ansible. Pour installer tox, exécutez :
pip install tox
Pour exécuter les tests sur toutes les versions d'ansible (AVERTISSEMENT : cela peut prendre du temps)
tox
Pour exécuter une commande molecule personnalisée dans un environnement personnalisé avec uniquement le scénario de test par défaut :
tox -e py27-ansible25 -- molecule test -s default
Pour plus d'informations sur molecule, consultez leurs docs.
Si vous souhaitez exécuter des tests sur un hôte docker distant, spécifiez simplement la variable DOCKER_HOST
avant de lancer les tests tox.
Licence
Ce projet est sous licence MIT. Voir LICENSE pour plus de détails.
Informations sur l'auteur
Vous pouvez me trouver sur Twitter : @mongrelion
Contributeurs
- 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