Création d'une instance de service Continuous Delivery à l'aide de la console

1. Connectez-vous à IBM Cloud.
2. Dans la console IBM Cloud, cliquez sur Catalogue puis sélectionnez Services.
3. Sélectionnez la catégorie Developer Tools.
4. Cliquez sur la vignette Continuous Delivery.
5. Sélectionnez la région dans laquelle vous voulez créer le service Continuous Delivery.
6. Choisissez une formule tarifaire Lite ou Professional. Les plans Lite offrent toutes les fonctionnalités de Continuous Delivery à de petites équipes, gratuitement, avec des limites d'utilisation. Si vous créez une instance de plan Lite, elle est automatiquement supprimée 30 jours après la création. Pour plus d'informations sur les plans de service Continuous Delivery, voir Utilisation des plans et limitations.
7. Dans la section Configurer votre ressource, spécifiez un nom pour l'instance Continuous Delivery que vous créez.
8. Sélectionnez le groupe de ressources dans lequel vous voulez créer l'instance de service Continuous Delivery. Vous ne pouvez pas modifier le groupe de ressources sélectionné après avoir créé l'instance de service Continuous Delivery. Pour plus d'informations sur la façon d'organiser des ressources dans votre compte IBM Cloud, voir Meilleures pratiques pour l'organisation des ressources dans un groupe de ressources.
9. Spécifiez les étiquettes que vous voulez utiliser pour organiser et filtrer les ressources de votre liste de ressources. Vous pouvez également utiliser des étiquettes pour vous aider à identifier l'utilisation spécifique des équipes ou l'allocation des coûts. Ces étiquettes sont visibles à l'échelle du compte. Pour plus d'informations sur l'utilisation des étiquettes, voir Utilisation d'étiquettes.
10. Si vous avez choisi une formule tarifaire Professional, vous pouvez sélectionner l’instance du service IBM® Key Protect for IBM Cloud® ou celle du service IBM Cloud® Hyper Protect Crypto Services, ainsi que la clé racine utilisée pour chiffrer vos informations personnelles. Assurez-vous que l’instance Key Protect ou l’instance Hyper Protect Crypto Services ainsi que la clé racine existent, et que les ressources de la chaîne d’outils sont autorisées à accéder à Key Protect ou Hyper Protect Crypto Services dans la section Gérer les autorisations. Seuls les noeuds finaux privés sont actuellement pris en charge pour l'instance de service Hyper Protect Crypto Services. Pour plus d'informations sur les types de données qui sont chiffrés, voir Protection de vos données personnelles lorsque vous utilisez le plan Professionnel.
11. Cliquez sur Créer.

Création d'une instance du service Continuous Delivery à partir de l'interface de ligne de commande (CLI)

1. Connectez-vous à IBM Cloud à l'aide de l'interface de ligne de commande IBM Cloud.

   ibmcloud login
   

   Si la connexion échoue, exécutez la commande ibmcloud login --sso pour réessayer. Le paramètre --sso est requis lorsque vous vous connectez avec un ID fédéré. Si vous utilisez cette option, accédez au lien répertorié dans la sortie de l'interface de ligne de commande pour générer un code d'accès à usage unique.

2. Sélectionnez le compte, la région et le groupe de ressources dans lesquels vous souhaitez créer une instance de service Continuous Delivery.

   ibmcloud target -c ACCOUNT -r REGION -g RESOURCE_GROUP
   

3. Créez une instance de Continuous Delivery dans le compte, la région et le groupe de ressources ciblés.

   ibmcloud resource service-instance-create INSTANCE_NAME continuous-delivery PLAN REGION -p ENCRYPTION
   

Le tableau suivant répertorie et décrit chacune des variables utilisées dans les étapes précédentes.

Pour plus d'informations sur les ID de plan ou sur la mise à jour de votre plan de service après la création d'une instance, voir Mise à jour de votre plan de service.

Création d'une instance du service Continuous Delivery à l'aide de l'API

1. Obtenez un jeton bearer IAM. Sinon, si vous utilisez un SDK, obtenez une clé d'API IAM et définissez les options client à l'aide de variables d'environnement.

   export RESOURCE_CONTROLLER_APIKEY={iam_api_key}
   

2. Recherchez l'ID du groupe de ressources dans lequel vous souhaitez créer votre instance.

3. Choisissez la région dans laquelle vous souhaitez créer votre instance.

4. Recherchez l'ID du plan de service de l'instance que vous souhaitez créer.

5. Créez une instance de Continuous Delivery dans le compte, la région et le groupe de ressources ciblés.

   curl -X POST \
     https://resource-controller.cloud.ibm.com/v2/resource_instances \
     -H 'Authorization: Bearer {token}' \
     -H 'Content-Type: application/json' \
       -d '{
       "name": "{instance_name}",
       "target": "{region}",
       "resource_group": "{resource_group_id}",
       "resource_plan_id": "{plan_id}"
       "parameters": "{parameters}"
     }'
   

   import com.ibm.cloud.platform_services.resource_controller.v2.ResourceController;
   import com.ibm.cloud.platform_services.resource_controller.v2.model.*;
   ...
   ResourceController resourceControllerService = ResourceController.newInstance();
   CreateResourceInstanceOptions createCdInstanceOptions = new CreateResourceInstanceOptions.Builder()
      .name({instance_name})
      .target({region})
      .resourceGroup({resource_group_id})
      .resourcePlanId({plan_id})
      .build();
   Response<ResourceInstance> response = resourceControllerService.createResourceInstance(createCdInstanceOptions).execute();
   ResourceInstance cdInstance = response.getResult();
   

   const ResourceControllerV2 = require('@ibm-cloud/platform-services/resource-controller/v2');
   const resourceControllerService = ResourceControllerV2.newInstance({});
   ...
   (async () => {
      const params = {
         name: {instance_name},
         target: {region},
         resourceGroup: {resource_group_id},
         resourcePlanId: {plan_id},
      };
      const res = await resourceControllerService.createResourceInstance(params);
      const cdInstanceGuid = res.result.guid;
   })();
   

   from ibm_platform_services import ResourceControllerV2
   ...
   resource_controller_service = ResourceControllerV2.new_instance()
   cd_instance = resource_controller_service.create_resource_instance(
      name={instance_name},
      target={region},
      resource_group={resource_group_id},
      resource_plan_id={plan_id}
   ).get_result()
   

   import {
      "github.com/IBM/platform-services-go-sdk/resourcecontrollerv2"
   }
   ...
   resourceControllerServiceOptions := &resourcecontrollerv2.ResourceControllerV2Options{}
   resourceControllerService, err := resourcecontrollerv2.NewResourceControllerV2UsingExternalConfig(resourceControllerServiceOptions)
   createCdInstanceOptions := resourceControllerService.NewCreateResourceInstanceOptions(
      {instance_name},
      {region},
      {resource_group_id},
      {plan_id},
   )
   cdInstance, response, err := resourceControllerService.CreateResourceInstance(createCdInstanceOptions)
   

Le tableau suivant répertorie et décrit chacune des variables utilisées dans les étapes précédentes.

Pour plus d'informations sur la création d'instances de service, voir Création d'instances de ressource à l'aide de l'API.

Création d'une instance du service Continuous Delivery avec Terraform

1. Pour installer l'interface de ligne de commande de Terraform et configurer le plug-in IBM Cloud Provider pour Terraform, suivez le tutoriel d'initiation à Terraform sur IBM Cloud.

2. Créez un fichier de configuration Terraform nommé main.tf. Dans ce fichier, ajoutez la configuration permettant de créer des instances de ressources à l'aide du langage de configuration HashiCorp. Pour plus d'informations sur l'utilisation de ce langage de configuration, voir la documentation Terraform.

   L'exemple suivant crée une instance du service Continuous Delivery à l'aide de la ressource ibm_resource_instance, où name est un nom unique et descriptif qui identifie l'instance de la ressource.

   data "ibm_resource_group" "group" {
     name = "default"
   }
   resource "ibm_resource_instance" "cd_service_instance" {
     name              = "my CD service instance"
     service           = "continuous-delivery"
     plan              = "lite"
     location          = "us-south"
     resource_group_id = data.ibm_resource_group.group.id
   }
   

   Pour plus d'informations sur ibm_resource_instance, voir les détails de référence des arguments dans la documentation du registre Terraform.

   Pour mettre à disposition votre instance de service afin d'utiliser le chiffrement géré par le client, ajoutez et remplissez l'attribut de paramètres avec votre ID d'instance de service de gestion de clés et votre ID de clé racine.

     parameters = {
       kms_instance = <kms_instance_id>
       kms_key = <kms_key>
     }
   

3. Initialisez l'interface de ligne de commande de Terraform.

   terraform init
   

4. Créez un plan d'exécution Terraform. Ce plan récapitule toutes les actions qui doivent être exécutées pour créer une instance de service Continuous Delivery.

   terraform plan
   

5. Appliquer le plan d'exécution Terraform. Terraform effectue toutes les actions requises pour créer l'instance de service Continuous Delivery.

   terraform apply