3.3. Installation des collections à l'aide de l'interface de programmation

Les collections sont un format de distribution pour le contenu Ansible qui peut inclure des playbooks, des rôles, des modules et des plugins.

Vous pouvez installer Collections par l'intermédiaire d'Ansible Galaxy, du navigateur ou de la ligne de commande.

Conditions préalables

  • Accès et autorisations à une ou plusieurs managed nodes.

  • Accès et permissions à un control node, qui est un système à partir duquel Red Hat Ansible Core configure d'autres systèmes.

    Sur le nœud de contrôle :

    • Les paquets ansible-core et rhel-system-roles sont installés.
    • Un fichier d'inventaire qui répertorie les nœuds gérés.

Procédure

  • Installez la collection via un paquetage RPM : 

    # dnf install rhel-system-roles

Une fois l'installation terminée, les rôles sont disponibles à l'adresse redhat.rhel_system_roles.<role_name>. En outre, vous pouvez trouver la documentation de chaque rôle à l'adresse /usr/share/ansible/collections/ansible_collections/redhat/rhel_system_roles/roles/<role_name>/README.md.

Verification steps

Pour vérifier l'installation, exécutez le rôle kernel_settings avec le mode check sur votre hôte local. Vous devez également utiliser le paramètre --become car il est nécessaire pour le module Ansible package. Cependant, ce paramètre ne modifiera pas votre système :

  1. Exécutez la commande suivante : 

    $ ansible-playbook -c local -i localhost, --check --become /usr/share/ansible/collections/ansible_collections/redhat/rhel_system_roles/tests/kernel_settings/tests_default.yml

La dernière ligne de la sortie de la commande doit contenir la valeur failed=0.

Note

La virgule après localhost est obligatoire. Vous devez l'ajouter même s'il n'y a qu'un seul hôte dans la liste. Sans elle, ansible-playbook identifierait localhost comme un fichier ou un répertoire.

Ressources supplémentaires