Avant de commencer

1. Créez un référentiel pour stocker l'architecture déployable personnalisée, par exemple, un référentiel GitHub. Pour plus d'informations, voir Création d'un nouveau référentiel.
2. Vérifiez que vous disposez d'un éditeur de votre choix pour modifier l'architecture déployable, par exemple, Visual Studio Code. Pour plus d'informations, voir Visual Studio Code.
3. Assurez-vous de disposer des outils de votre choix pour tester votre architecture déployable et vous assurer qu'elle fonctionne. Par exemple, vous pouvez utiliser l'environnement d'exécution Terraform, qui fournit la ligne de commande Terraform.

Recherche d'une architecture déployable

IBM Cloud fournit plusieurs architectures déployables que vous pouvez utiliser telles qu'elles sont ou que vous pouvez personnaliser. Pour trouver une architecture, procédez comme suit:

1. Dans le catalogueIBM Cloud, sélectionnez une architecture déployable.
2. Téléchargez le bundle de personnalisation en sélectionnant Passer en revue les options de déploiement > Utiliser le code > Télécharger le bundle.

Personnalisation de l'architecture déployable

Lorsque vous téléchargez le bundle, vous recevez un ensemble de fichiers conçus pour vous aider à vous initier à la personnalisation.

module "landing-zone" {
  source           = "https://cm.globalcatalog.cloud.ibm.com/api/v1-beta/offering/source//examples/power-sap?archive=tgz&catalogID=7df1e4ca-d54c-4fd0-82ce-3d13247308cd&flavor=power&kind=terraform&name=slz-vpc-with-vsis&version=0.0.22"
  ibmcloud_api_key = var.ibmcloud_api_key
  ssh_public_key   = var.ssh_public_key
  region           = "us-south"
  prefix           = "slz"
}

output "vsi_names" {
  value       = var.vsi_names
  description = "A list of the vsis names provisioned within the VPCs"
}

#output "transit_gateway_name" {
#  value       = var.transit_gateway_name
#  description = "The name of the transit gateway"
#}

provider "ibm" {
  ibmcloud_api_key = var.ibmcloud_api_key
  region           = var.region
}

Test de votre architecture déployable

Avant d'intégrer votre architecture déployable à un catalogue privé, testez votre personnalisation et assurez-vous que l'architecture s'exécute comme prévu. Pour tester votre architecture à l'aide de la ligne de commande Terraform, procédez comme suit:

1. Après avoir personnalisé l'architecture, initialisez l'interface de ligne de commande Terraform. Pour plus d'informations, voir Initialisation des répertoires de travail.

   terraform init
   

2. Mettez à disposition les ressources. Pour plus d'informations, voir Mise à disposition d'une infrastructure avec Terraform.

   1. Exécutez terraform plan pour générer un plan d'exécution Terraform afin de prévisualiser les actions proposées.

      terraform plan
      

   2. Exécutez terraform apply pour créer les ressources définies dans le plan.

      terraform apply
      

Création d'une édition

Si vos tests ont abouti, vous pouvez préparer l'intégration de votre architecture à un catalogue privé en vous assurant que vos fichiers se trouvent dans le référentiel et en créant une édition. Pour plus d'informations, voir Création d'une édition.

Optimisation de l'automatisation pour le partage dans un catalogue privé

Le bundle de personnalisation possède un répertoire automation qui inclut quelques options pour les pipelines de démarrage. Ces pipelines peuvent être utilisés pour automatiser le cycle de vie de vos produits personnalisés que vous partagez à l'aide d'un catalogue privé sur IBM Cloud. Cela inclut la gestion de l'intégration, de la validation et du partage de la version de l'architecture déployable dans un catalogue privé. Les fichiers README sont inclus pour chaque option de pipeline qui fournit des détails sur la façon de l'optimiser. Pour plus d'informations sur chacun d'eux, voir ActionsGitHub et Création d'une chaîne d'outils.

Etapes suivantes

Les scripts fournis dans le bundle de personnalisation vous aident à automatiser le processus d'intégration à un catalogue privé pour le partage de votre produit avec d'autres utilisateurs. Toutefois, si vous souhaitez utiliser la console ou l'interface de ligne de commande pour intégrer votre architecture déployable, voir Intégration de votre architecture déployable personnalisée à un catalogue privé pour obtenir des conseils étape par étape. En utilisant des catalogues privés, les membres de votre entreprise doivent utiliser des architectures approuvées qu'ils peuvent déployer à l'aide de projets.