Utilisation de chaînes d'outils
DevOps Insights Le service prendra fin et sera interrompu le 31 août 2026. Le service Continuous Delivery sera interrompu dans les régions suivantes le 12 février 2027 : au-syd, ca-tor, us-east. Code Risk Analyzer sera également retiré du marché dans toutes les régions à cette date. Si ces fonctionnalités ne sont pas activement utilisées dans une région donnée, elles pourraient y être supprimées plus tôt et ne plus accepter de nouvelles instances. En savoir plus
Les chaînes d'outils ouvertes sont disponibles sous IBM Cloud®. Vous pouvez utiliser une chaîne d'outils pour améliorer la productivité de votre travail quotidien de développement, de déploiement et de vos opérations. Après avoir configuré une chaîne d'outils, vous pouvez ajouter, supprimer ou configurer des intégrations d'outils et gérer l'accès à la chaîne d'outils. Pour plus d'informations sur l'utilisation des intégrations d'outils, voir Utilisation des intégrations d'outils.
Gestion de l'accès aux chaînes d'outils
Vous pouvez utiliser le service Identity and Access Management (IAM) pour gérer l'accès des utilisateurs aux chaînes d'outils dans les groupes de ressources. Pour plus d'informations sur la gestion du contrôle d'accès avec IAM, voir Gestion de l'accès utilisateur aux chaînes d'outils dans les groupes de ressources.
Les utilisateurs ayant accès aux chaînes d'outils peuvent être comptabilisés en tant qu'utilisateurs autorisés du service IBM Cloud® Continuous Delivery. Pour plus d'informations sur la façon dont les utilisateurs autorisés sont dénombrés, voir Utilisation des plans et limitations.
Organisation des chaînes d'outils
Vous pouvez ajouter des étiquettes à vos chaînes d'outils pour les organiser et les retrouver facilement plus tard. Une étiquette est un libellé que vous attribuez à une chaîne d'outils pour faciliter le filtrage des chaînes d'outils dans votre liste de chaînes d'outils.
- Dans la console IBM Cloud, cliquez sur l'
Menu > Automatisation de la plateforme > Chaînes d'outils.
- Sur la page Chaînes d'outils, recherchez la chaîne d'outils à laquelle vous souhaitez ajouter une étiquette et cliquez sur Ajouter des étiquettes.
- Entrez un nom pour l'étiquette que vous souhaitez ajouter à la chaîne d'outils. Vous pouvez ajouter plusieurs étiquettes, en les séparant par des virgules.
- Cliquez sur Sauvegarder.
Pour plus d'informations sur les balises, voir Utilisation de balises.
Affichage des connexions de chaîne d'outils à des applications, des clusters et des services
Vous pouvez consulter les connexions de votre chaîne d'outils aux clusters et services d' Kubernetes.
- Dans la console IBM Cloud, cliquez sur l'
Menu > Automatisation de la plateforme > Chaînes d'outils.
- Sur la page Chaînes d'outils, cliquez sur une chaîne d'outils afin d'ouvrir sa page Vue d'ensemble. Sinon, sur la page Détails de l'application de votre application, cliquez sur le nom de la chaîne d'outils.
- Sélectionnez l'onglet Connexions, puis sélectionnez l'application, le cluster ou le service que vous voulez afficher.
Suppression d'une chaîne d'outils
Vous pouvez supprimer une chaîne d'outils. Lorsque vous supprimez une chaîne d'outils, toutes les intégrations d'outils qui appartiennent à cette chaîne d'outils sont également supprimées. Cette suppression est irréversible.
Lorsque vous supprimez l'intégration d'un outil Delivery Pipeline, l'outil Delivery Pipeline associé est également supprimé.
Lorsque vous supprimez une intégration d'outils GitHub ou Git Repos and Issue Tracking, le référentiel associé n'est pas supprimé de GitHub ou de Git Repos and Issue Tracking. Vous devez le supprimer manuellement.
Suppression d'une chaîne d'outils à l'aide de la console
- Dans la console IBM Cloud, cliquez sur l'
Menu > Automatisation de la plateforme > Chaînes d'outils.
- Sur la page Chaînes d'outils, cliquez sur une chaîne d'outils afin d'ouvrir sa page Vue d'ensemble. Sinon, sur la page Détails de l'application de votre application, cliquez sur le nom de la chaîne d'outils.
- Cliquez sur le menu Actions, puis sélectionnez Supprimer. La suppression d'une chaîne d'outils supprime toutes ses intégrations d'outils, et donc éventuellement les ressources gérées par ces intégrations.
- Confirmez la suppression en entrant le nom de la chaîne d'outils et en cliquant sur Supprimer.
Suppression d'une chaîne d'outils à partir de l'interface de ligne de commande (bêta)
-
Connectez-vous à IBM Cloud à l'aide de l'interface de ligne de commande IBM Cloud.
ibmcloud loginSi la connexion échoue, exécutez la commande
ibmcloud login --ssopour réessayer. Le paramètre--ssoest 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. -
Optionnel. Répertoriez toutes les chaînes d'outils du compte, de la région et du groupe de ressources ciblés pour identifier l'instance que vous souhaitez supprimer.
ibmcloud dev toolchains -
Supprimez une chaîne d'outils en exécutant la commande
ibmcloud dev toolchain-delete.ibmcloud dev toolchain-delete TOOLCHAIN-NAME
Le tableau suivant répertorie et décrit chacune des variables utilisées dans les étapes précédentes.
| Variable | Description |
|---|---|
TOOLCHAIN_NAME |
Nom de la chaîne d'outils que vous souhaitez supprimer. |
Suppression d'une chaîne d'outils à l'aide de l'API
-
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 CD_TOOLCHAIN_AUTH_TYPE=iam && \ export CD_TOOLCHAIN_APIKEY={iam_api_key} && \ export CD_TOOLCHAIN_URL={base_url} -
Supprimez la chaîne d'outils que vous souhaitez retirer.
curl -X DELETE \ "{base_url}/toolchains/{toolchain_id}" \ -H 'Authorization: Bearer {token}'const CdToolchainV2 = require('@ibm-cloud/continuous-delivery/cd-toolchain/v2'); const toolchainService = CdToolchainV2.newInstance(); ... (async() => { const response = await toolchainService.deleteToolchain({ toolchainId: {toolchain_id} }); })();import ( "github.com/IBM/continuous-delivery-go-sdk/cdtoolchainv2" ) ... toolchainClientOptions := &cdtoolchainv2.CdToolchainV2Options{} toolchainClient, err := cdtoolchainv2.NewCdToolchainV2UsingExternalConfig(toolchainClientOptions) deleteToolchainOptions := toolchainClient.NewDeleteToolchainOptions({toolchain_id}) response, err := toolchainClient.DeleteToolchain(deleteToolchainOptions)from ibm_continuous_delivery.cd_toolchain_v2 import CdToolchainV2 ... toolchain_service = CdToolchainV2.new_instance() response = toolchain_service.delete_toolchain( toolchain_id = toolchain_id )import com.ibm.cloud.continuous_delivery.cd_toolchain.v2.CdToolchain; import com.ibm.cloud.continuous_delivery.cd_toolchain.v2.model.*; ... CdToolchain toolchainService = CdToolchain.newInstance(); DeleteToolchainOptions deleteToolchainOptions = new DeleteToolchainOptions.Builder() .toolchainId({toolchain_id}) .build(); Response<Void> response = toolchainService.deleteToolchain(deleteToolchainOptions).execute();
Le tableau suivant répertorie et décrit chacune des variables utilisées dans les étapes précédentes.
| Variable | Description |
|---|---|
{base_url} |
Le point de terminaison de l'API Toolchain URL, par exemple https://api.us-south.devops.cloud.ibm.com/toolchain/v2. Pour plus d'informations sur ce point de terminaison URL, y compris une liste de valeurs, voir Point de terminaison URL. |
{iam_api_key} |
Votre clé d'API IAM. |
{token} |
Un jeton IAM de type bearer valide. |
{toolchain_id} |
L'identifiant de la chaîne d'outils que vous souhaitez supprimer. |
Suppression d'une chaîne d'outils avec Terraform
-
Localisez le fichier Terraform (par exemple,
main.tf) qui contient le blocresourcepour la chaîne d'outils existante. Pour plus d'informations sur l'utilisation de Terraform avec des chaînes d'outils, voir Création d'une chaîne d'outils avec Terraform.Le fichier
resourcede l'exemple suivant décrit une chaîne d'outils existante.data "ibm_resource_group" "group" { name = "default" } resource "ibm_cd_toolchain" "cd_toolchain" { name = "my toolchain" resource_group_id = data.ibm_resource_group.group.id } -
Supprimez le bloc
resourcede votre fichier Terraform. -
Initialisez l'interface de ligne de commande de Terraform.
terraform init -
Créez un plan d'exécution Terraform. Ce plan récapitule toutes les actions qui doivent être exécutées pour supprimer la chaîne d'outils.
terraform plan -
Appliquer le plan d'exécution Terraform. Terraform effectue toutes les actions requises pour supprimer la chaîne d'outils.
terraform apply
Gérer des chaînes d'outils alternatives dans différentes régions
Vous pouvez définir votre chaîne d'outils en utilisant le langage de configuration Terraform, puis appliquer et maintenir votre définition de chaîne d'outils dans deux régions : une région principale avec des pipelines actifs, et une région alternative avec des pipelines inactifs. Si vous utilisez Git Repos and Issue Tracking, vous pouvez également créer un miroir de vos dépôts Git de la région principale vers la région alternative. Le maintien de chaînes d'outils et de dépôts Git primaires et alternatifs permet d'accélérer le basculement et la redondance. Cela garantit également un fonctionnement sans heurts en cas de problèmes dans la région principale. En codifiant votre chaîne d'outils dans Terraform, vous pouvez mettre à jour votre chaîne d'outils et appliquer les changements aux deux régions.
Pour plus d'informations sur l'utilisation de Terraform, voir Configuration de Terraform pour Continuous Delivery