bootstrap

Préparer votre système à être géré par Ansible.

Exemple de Playbook

Cet exemple est tiré de molecule/resources/playbook.yml et est testé à chaque push, pull request et publication.

---
- name: Convergence
  hosts: all
  become: yes
  gather_facts: no

  roles:
    - robertdebock.bootstrap

La machine sur laquelle vous exécutez cela doit peut-être être préparée, j'utilise ce playbook pour m'assurer que tout est en place pour que le rôle fonctionne.

Aucune préparation requise.

Après avoir exécuté ce rôle, ce playbook s'exécute pour vérifier que tout fonctionne, cela peut être un bon exemple de la façon dont vous pouvez utiliser ce rôle.

---
- name: Vérifier
  hosts: all
  become: no
  gather_facts: yes

  tasks:
    - name: tester la connexion
      ping:

Voir également une explication complète et un exemple sur la façon d'utiliser ces rôles.

Variables de Rôle

Ces variables sont définies dans defaults/main.yml :

---
# fichier de valeurs par défaut pour bootstrap

# L'utilisateur à utiliser pour se connecter aux machines.
bootstrap_user: root

# Voulez-vous attendre que l'hôte soit disponible ?
bootstrap_wait_for_host: no

# Le nombre de secondes que vous souhaitez attendre pendant le test de connexion avant d'échouer.
bootstrap_timeout: 3

# Le nombre de tentatives pendant l'installation
bootstrap_retries: 3

Exigences

• Accès à un dépôt contenant des packages, probablement sur Internet.
• Une version récente d'Ansible. (Les tests sont effectués sur la version actuelle, la version précédente et la prochaine version d'Ansible.)

Les rôles suivants peuvent être installés pour garantir que toutes les exigences sont satisfaites, en utilisant ansible-galaxy install -r requirements.yml :

- aucun

Contexte

Ce rôle fait partie de nombreux rôles compatibles. Consultez la documentation de ces rôles pour plus d'informations.

Voici un aperçu des rôles connexes :

Compatibilité

Ce rôle a été testé sur ces images de conteneur :

conteneur	tags
amazon	tous
alpine	tous
archlinux	tous
debian	tous
el	7, 8
fedora	tous
opensuse	tous
sles	tous
ubuntu	artful, bionic

La version minimale d'Ansible requise est 2.8, mais des tests ont été réalisés pour :

• La version précédente, sur une version inférieure.
• La version actuelle.
• La version de développement.

Tests

Tests unitaires effectués à chaque commit, pull request, publication et périodiquement.

Si vous trouvez des problèmes, veuillez les signaler sur GitHub.

Les tests sont effectués à l'aide de Tox et Molecule :

Tox teste plusieurs versions d'Ansible. Molecule teste plusieurs distributions.

Pour tester en utilisant les valeurs par défaut (toute version d'Ansible installée, namespace : robertdebock, image : fedora, tag : latest) :

molecule test

# Ou sélectionnez une image spécifique :
image=ubuntu molecule test
# Ou sélectionnez une image spécifique et un tag spécifique :
image="debian" tag="stable" tox

Vous pouvez également tester plusieurs versions d'Ansible et sélectionner des images : Tox permet de tester plusieurs versions d'Ansible. Pour exécuter les tests par défaut (namespace : robertdebock, image : fedora, tag : latest) :

tox

# Pour exécuter CentOS (namespace : `robertdebock`, tag : `latest`)
image="centos" tox
# Ou personnalisez davantage :
image="debian" tag="stable" tox

Licence

Apache-2.0

Informations sur l'Auteur

Robert de Bock