Création d'une action à l'aide de la console

Créez une action « Schematics » et indiquez le playbook « Ansible » que vous souhaitez exécuter sur vos ressources Cloud.

1. Connectez-vous à la console IBM Cloud.

2. Cliquez sur l'icône Menu Icône > Automatisation de la plate-forme > Schematics > Ansible et naviguez jusqu'à Créer un playbook.

   • Créer un cahier des charges.

     1. Saisissez un nom et une description pour votre action. Le nom peut comporter jusqu'à 128 caractères et peut inclure des caractères alphanumériques, des espaces, des tirets et des traits de soulignement.
     2. Entrez le fichier URL du référentiel GitHub ou GitLab dans lequel votre playbook Ansible est stocké. L'URL peut pointer vers la branche maître ou tout autre branche, ou vers un sous-répertoire. Si votre référentiel stocke plusieurs jeux de lecture, vous devez sélectionner le playbook à exécuter. Une action Schematics peut pointer vers un protocole à la fois. Pour exécuter plusieurs protocoles, vous devez créer une action distincte pour chaque protocole.

     Si vous n'avez pas de cahier de jeu, essayez l'un de vos exemples de cahier de jeu.

     3. Facultatif : indiquez la branche (facultatif) et le dossier (facultatif).
     4. Facultatif: Si vous souhaitez utiliser un référentiel GitHub privé, entrez votre jeton d'accès personnel. Le jeton d'accès personnel est utilisé pour authentifier le référentiel de GitHub privé pour accéder à votre protocoleAnsible. Pour plus d'informations sur la création d'un jeton d'accès, consultez la section « Création d'un jeton d'accès personnel pour l'interface de ligne de commande ».

     Pour plus d'informations, consultez la liste des extensions de fichiers autorisées et bloquées pour le clonage à partir du dépôt Git. Pour valider et cloner le modèle en toute sécurité, vous pouvez cliquer sur « Open reference picker » afin de sélectionner votre référence de clé « Secrets Manager ». Pour plus d'informations, consultez la section « Création d'une instance d' Secrets Manager ».

   • Renseignements supplémentaires

     1. Facultatif : Entrez les balises que vous souhaitez ajouter à votre action. Les balises facilitent la recherche rapide de votre action.
     2. Sélectionnez le fichier Groupe de ressources dans lequel vous souhaitez créer l'action.
     3. Sélectionnez l'emplacement où vous souhaitez créer l'action. L'emplacement détermine où s'exécute votre action et où les données d'action sont stockées. Vous pouvez choisir une géographie, telle que Dallas, ou Frankfurt. Si vous sélectionnez une zone géographique, Schematics décide d'un emplacement dans cette zone géographique en fonction de la disponibilité. Assurez-vous que vous pouvez stocker vos données d'action dans cet emplacement car vous ne pouvez pas modifier l'emplacement après la création de l'action. Pour plus d'informations, voir où sont stockées les informations? Assurez-vous que l'emplacement de votre action est indépendant de celui de la ressource Cloud sur laquelle vous souhaitez exécuter votre playbook « Ansible ».

   • Choisissez un inventaire Vous pouvez définir les groupes d'hôtes sur lesquels vous souhaitez exécuter votre playbook « Ansible ».

     1. Cliquez sur Créer un inventaire.

     2. Entrez un nom pour votre inventaire.

     3. Choisissez le type de connexion SSH ou WinRM en fonction des besoins de l'hôte distant. La valeur par défaut est SSH.

        Le type de connexion prend en charge à la fois SSH et WinRM pour la connexion aux hôtes distants. Pour SSH, assurez-vous que l'accès à l'hôte Bastion est configuré. WinRM est utilisé pour se connecter aux hôtes distants Windows. Actuellement, WinRM ne prend en charge que les systèmes Windows via l'interface publique IPs et ne prend pas en charge l'accès via un hôte bastion.

     4. Vérifiez votre location et sélectionnez le Resource group où vous voulez créer l'inventaire.

     5. Cliquez sur Créer un groupe d'hôtes.

     6. Entrez un nom pour votre groupe d'hôtes et sélectionnez l'espace de travail Schematics qui a mis à disposition les hôtes cible que vous souhaitez ajouter à votre groupe d'hôtes.

     7. Facultatif : cliquez sur Ajouter une requête pour ajouter une autre condition à votre requête et limiter le nombre d'hôtes cible qui sont ajoutés à votre groupe d'hôtes. Vous pouvez choisir d'identifier vos hôtes à l'aide du nom de ressource ou d'une étiquette. Pour plus d'informations, voir les requêtes de ressources prises en charge.

     8. Cliquez sur Ajouter une autre condition et répétez les étapes 6 à 8 pour ajouter d'autres groupes d'hôtes.

     9. Facultatif : Cliquez sur l'onglet Définir manuellement pour définir les hôtes et le groupe d'hôtes sur lesquels votre playbook fonctionne.

     10. Entrez les détails de l'hôte en utilisant le format de fichier.ini dans l'option Fichier.

     11. Dans la liste des tableaux, sélectionnez les groupes d'hôtes que vous souhaitez inclure dans votre inventaire de ressources.

     12. Cliquez sur Créer un inventaire pour définir un fichier d'inventaire qui définit les hôtes et le groupe d'hôtes sur lesquels votre playbook fonctionne.

3. Dans le tableau des inventaires de ressources, sélectionnez un inventaire de ressources existant et cliquez sur l'icône Modifier.

   • Cliquez sur Gérer les informations d'identification pour configurer les informations d'identification de l'inventaire. Pour plus d'informations, voir Gestion des informations d'identification.
   • Cliquez sur Gérer les variables pour configurer les variables d'inventaire. Pour plus d'informations, voir Gestion des variables.
   • Cliquez sur Supprimer pour supprimer l'inventaire.

4. Cliquez sur Créer. Votre action est créée avec le statut « Normal », et vous êtes redirigé vers la section « Détails ».

5. Cliquez sur Vérifier l'action pour vérifier que les tâches que vous essayez d'exécuter et vos ressources sont liées à votre playbook. Vous pouvez consulter la section Historique des actions pour voir les résultats dans les journaux. Ce contrôle permet de vérifier que les tâches que vous essayez d'exécuter et vos ressources sont correctement liées à votre playbook.

   Vous ne pouvez pas supprimer ou arrêter un travail en cours d'exécution de votre action Schematics. Pour modifier votre action, attendez que la tâche soit terminée, modifiez vos paramètres, puis cliquez à nouveau sur « Vérifier l'action » ou « Exécuter l'action ».

6. Cliquez sur Exécuter l'action pour exécuter l'action. Vous pouvez surveiller la progression d'une action en examinant les journaux sur la page Travaux. Toutes les 30 seconds les journaux de travaux sont automatiquement actualisés.

Création d'une action à l'aide de l'interface de programmation

1. Depuis votre interface CLI locale, configurez le plug-in Schematics.
2. Créez une action en utilisant la commande ibmcloud schematics action create.
3. Créez un inventaire en utilisant la commande ibmcloud schematics inventory create.
4. Vérifiez dans les journaux que la création a réussi.

Création d'une action à l'aide de l'API

1. Récupérez votre jeton d'accès IAM et authentifiez-vous avec Schematics.
2. Optionnel : Créez une action en envoyant une requête POST.
3. Créer un inventaire en envoyant une requête POST.
4. Vérifiez l'état de la réponse pour vous assurer que la création a réussi.