Création d'un protocole Ansible

Pour créer votre playbook Ansible à utiliser avec Schematics, suivez les conditions préalables et les étapes générales.

Vous souhaitez utiliser des protocoles Ansibles existants pour commencer ? Essayez l'un des playbooks Ansible fournis par IBM ou parcourez les collections et rôles Ansible existants dans Ansible Galaxy.

Préparez l'inventaire des ressources à l'endroit où vous avez l'intention d'exécuter votre playbook Ansible. Vous pouvez également utiliser les fonctionnalités Terraform intégrées à Schematics pour provisionner les hôtes cibles. Pour plus d'informations, voir Déploiement de l'infrastructure avec des espaces de travail Schematics.
Élaborez votre manuel de jeu Ansible. Utilisez l'un des playbooks fournis par IBM ou explorez les rôles et collections existants dans Ansible Galaxy. Faites référence à ces rôles et collections](/docs/schematics?topic=schematics-create-playbook#schematics-collections) dans votre playbook si nécessaire.
Créez un référentiel GitHub ou GitLab et organisez votre playbook Ansible, vos modules, vos rôles et vos collections selon la structure de répertoire requise. Un exemple de structure peut être trouvé dans cet exemple de manuel de jeu.
Téléchargez votre protocole, vos modules, vos rôles et vos collections Ansible dans votre référentiel GitHub.
Créez une action Schematics en utilisant le playbook téléchargé.

Veillez à ce que votre playbook respecte la structure nécessaire et référence tous les rôles et collections requis pour une exécution transparente sur Schematics. Pour plus d'informations, consultez la documentation de Ansible ou la création d'un playbook.

Référencement des collections Ansible dans votre protocole

Ansible les collections sont des groupes de ressources réutilisables Ansible, telles que les playbooks, les modules et les rôles, que vous pouvez installer et utiliser dans votre playbook. Les collections sont disponibles sur le site Ansible Galaxy.

A l'instar des rôles Ansible, les collections requièrent une structure de dossier spécifique dans votre référentiel GitHub.

Suivez les étapes suivantes pour utiliser les collections dans votre playbook Schematics

Parcourez le site Ansible Galaxy pour trouver la collection que vous souhaitez utiliser dans votre playbook.
Créez un fichier requirements.yml pour spécifier les collections que vous souhaitez installer à partir de Ansible Galaxy. La structure du fichier doit être conforme à la documentation de Ansible. Voici un exemple en utilisant la collection community.kubernetes.
```
collections:
  - name: community.kubernetes
    version: 0.9.0
```
Ajoutez un dossier collections à votre dépôt GitHub, relativement à votre playbook, et placez le fichier requirements.yml dans ce dossier.
```
├── collections
        └── requirements.yml
├── playbook.yaml
├── README.md
```
Référencez une ressource de votre collection dans votre protocole. Pour plus d'informations, voir la documentation de Ansible. Assurez-vous que la structure du dossier de votre playbook respecte les exigences et référence correctement les collections pour une exécution transparente dans Schematics.

Préparer votre Ansible Playbook pour Schematics

Avant d'exécuter votre playbook Ansible dans Schematics, tenez compte des points suivants :

Stockez votre playbook Ansible dans un référentiel GitHub ou GitLab.
Soyez conscient des limitations lorsque vous spécifiez des hôtes cibles pour votre inventaire de ressources Ansible. Pour plus d'informations, consultez les lignes directrices sur la création d'inventaires de ressources pour les actions Schematics.
Assurez-vous que vos playbooks sont compatibles avec une version de Ansible prise en charge par Schematics. Pour vérifier les versions prises en charge, exécutez la commande ibmcloud schematics version commande.
Vous pouvez également explorer les fonctionnalités des playbooks Ansible dans Schematics en utilisant l'un des playbooks Ansible fournis par IBM.

Etapes suivantes

Après avoir compris les conditions préalables et les étapes de préparation de votre playbook Ansible, l'étape suivante consiste à créer une action Schematics. Ce processus implique la spécification de votre playbook Ansible, la configuration de l'inventaire des ressources et la mise en place de toutes les informations d'identification ou variables nécessaires. Suivez le guide sur la création d'une action Schematics pour continuer.