Avant de commencer

Avant de pouvoir intégrer votre architecture déployable, assurez-vous de remplir les conditions préalables suivantes.

• Télécharger Visual Studio Code
• Vérifiez que vous disposez d'un compte Paiement à la carte ou Abonnement. Pour plus d'informations, voir Affichage de votre type de compte.
• Vérifiez que vous disposez des accès nécessaires pour travailler avec les catalogues privés et les architectures déployables.
  • Rôle de gestionnaire sur le IBM Cloud Schematics service
  • Rôle Editeur dans le service de gestion des catalogues
  • Rôle Afficheur dans tous les groupes de ressources de votre compte
  • SecretsReader sur le service Secrets Manager si vous prévoyez de stocker vos valeurs sécurisées dans une instance de Secrets Manager
  • Rôle du lecteur sur le Workload Protection service
  • Autres rôles requis pour des ressources spécifiques dans votre architecture déployable personnalisée.
• Assurez-vous que le code source de votre architecture déployable est stocké dans un GitHub. Pour obtenir de l'aide sur l'intégration de votre code source dans un référentiel, voir Mise en place de votre référentiel de code source.
• Un module Terraform dans un dépôt public ou privé GitHub qui est cloné dans un dossier local. Pour l'expérimentation, vous pouvez créer un fork de ce module Terraform exemple. Si votre référentiel est privé, vous avez besoin d'un jeton d'accès personnel avec des autorisations repo et read:user.

Obtenir l'extension VS Code

Pour obtenir l'extension, ouvrez VS Code, allez dans Extensions, recherchez et sélectionnez IBM Cloud Deployable Architecture Builder pour la télécharger. Après avoir téléchargé, vous pouvez suivre la procédure pour commencer ou utiliser les étapes suivantes. Si le guide ne s'ouvre pas automatiquement, vous pouvez utiliser la palette de commandes. Allez dans Affichage > Palette de commandes. Recherchez Walkthrough, cliquez sur Bienvenue : Visite libre..., puis sélectionnez Démarrer avec IBM Cloud Deployable Architecture Builder.

Mise en place d'une architecture déployable

La première fois que vous validez votre architecture déployable, vous passez par les étapes d'intégration à IBM Cloud Suivez les étapes suivantes pour mettre en place votre architecture déployable :

1. Connectez-vous à votre compte IBM Cloud.
   1. Pour vous connecter à votre compte, cliquez sur Affichage et sélectionnez Palette de commandes.
   2. Dans le champ de recherche, recherchez IBM Cloud - Log in.
   3. Sélectionnez IBM Cloud- Log in et connectez-vous avec une clé API, un identifiant fédéré ou un nom d'utilisateur et un mot de passe.
   4. (Facultatif) Vous pouvez modifier votre environnement de connexion. Cliquez sur Voir, sélectionnez Palette de commandes, recherchez IBM Cloud - Log in et sélectionnez IBM Cloud- Log in > Change login environment. Dans le menu, sélectionnez Production ou Staging.
2. Assurez-vous que vous êtes connecté à GitHub depuis VS Code.
   1. Sélectionnez l'icône > Sign in to Sync Settings.
   2. Sélectionnez votre compte.
   3. Cliquez sur Autoriser Visual-Studio-Code.
3. Clonez votre dépôt et ajoutez-le à un espace de travail VS Code.
   1. Clonez votre répertoire d'architectures déployables à partir de GitHub.
   2. Pour l'ajouter à votre espace de travail dans VS Code, cliquez sur Fichier > Ajouter un dossier à l'espace de travail..., puis sélectionnez le répertoire dans vos fichiers.
4. Ajouter les fichiers manifestes du catalogue au module Terraform.
   1. Pour ajouter le manifeste du catalogue, cliquez avec le bouton droit de la souris sur le dossier du module dans votre espace de travail.
   2. Sélectionnez IBM Cloud > Ajouter des fichiers manifestes d'architecture déployables.
5. Embarquez et validez votre architecture déployable.
   1. Cliquez avec le bouton droit de la souris sur le fichier ibm_catalog.json et sélectionnez IBM Cloud > Valider une architecture déployable sur IBM Cloud.
   2. Sélectionnez la branche du répertoire. Vous pouvez également cliquer sur + et saisir le nom d'un nouveau fichier qui sera créé.
   3. Sélectionnez un catalogue privé existant. Vous pouvez également cliquer sur + et saisir le nom d'un nouveau fichier qui sera créé.
   4. Saisir la version de l'offre.
   5. Sélectionnez un projet existant. Vous pouvez également cliquer sur + et saisir le nom d'un nouveau fichier qui sera créé pour vous.
   6. Saisissez votre IBM Cloud Pour le compte où les ressources seront déployées.
   7. Saisissez le chemin d'accès relatif au diagramme architectural. Si vous n'avez pas de diagramme, un espace réservé est fourni.
   8. (Facultatif) Si le dépôt GitHub est privé ou dans GitHub Enterprise, entrez votre jeton d'accès personnel.
   9. Le fichier d'entrée YAML est ouvert. Modifiez les valeurs de la propriété inputs et enregistrez le fichier.
   10. Cliquez sur Continuer

Lorsque la validation commence, un canal de sortie s'ouvre pour afficher les journaux de validation. Si ce n'est pas le cas, dans la vue Sortie, sélectionnez le canal DA Validation dans le menu. La validation peut prendre plusieurs minutes.