Configuration de Git Repos and Issue Tracking

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

L'intégration de l'outil Git Repos and Issue Tracking repose sur GitLab Community Edition, un service d'hébergement en ligne pour les référentiels (repos) Git. Vous pouvez avoir des copies en local et à distance de vos référentiels. Pour en savoir plus, consultez Git Repos and Issue Tracking.

Si vous configurez Git Repos and Issue Tracking lors de la création de la chaîne d'outils, procédez comme suit :

  1. Dans la section Intégrations configurables, cliquez sur Git Repos and Issue Tracking.
  2. Passez en revue les emplacements cible par défaut pour les référentiels Git. Ces référentiels sont clonés à partir des référentiels exemple. Si nécessaire, modifiez les noms des référentiels cible.

Si vous disposez d'une chaîne d'outils et que vous souhaitez faire migrer un référentiel Git de votre chaîne d'outils vers Git Repos and Issue Tracking, procédez comme suit :

Ces instructions s'appliquent aux chaînes d'outils qui contiennent déjà le référentiel Git que vous souhaitez faire migrer vers Git Repos and Issue Tracking. Pour savoir comment ajouter différents types de référentiels Git à votre chaîne d'outils, voir Configuration de GitHub et Configuration de GitLab.

  1. Dans la IBM Cloud console, cliquez sur l'icône Menu (icône hamburger ) > Automatisation de la plateforme > Chaînes d'outils. Sur la page Chaînes d'outils, cliquez sur la chaîne d'outils afin d'ouvrir sa page Vue d'ensemble.
  2. Cliquez sur Ajouter.
  3. Dans la section Intégrations d'outils, cliquez sur Git Repos and Issue Tracking.
  4. Sélectionnez le serveur sur lequel vous souhaitez déployer les modifications de code. Après avoir créé l'intégration, vous pouvez l'éditer pour gérer la liste des serveurs avec lesquels vous êtes autorisé à travailler. Cliquez sur Gérer l'autorisation pour afficher la liste de tous les serveurs et supprimer le jeton que vous avez fourni pour être autorisé pour le serveur.
  5. Pour créer une copie d'un référentiel Git, cliquez sur Cloner pour le type de référentiel. Saisissez un nouveau nom de référentiel et l'URL du référentiel source.
  6. Votre nom d'utilisateur est automatiquement sélectionné pour affecter la propriété de cette nouvelle intégration à vous-même. Une fois l'intégration créée, un autre utilisateur autorisé peut se réaffecter la propriété de l'intégration à lui-même en l'éditant.
  7. Si vous voulez créer un référentiel privé, cochez la case Rendre ce référentiel privé.
  8. Si vous voulez utiliser Problèmes pour le suivi des problèmes, cochez la case Activer Problèmes .
  9. Si vous voulez suivre le déploiement des changements du code en créant des étiquettes et des commentaires sur les validations, ainsi que des libellés et des commentaires sur les problèmes référencés par les validations, cochez la case Suivi du déploiement des changements du code.
  10. Cliquez sur Créer une intégration.

Après avoir cloné le référentiel Git, vous pouvez le retirer de votre chaîne d'outils.

Si vous disposez d'une chaîne d'outils et que vous lui ajoutez Git Repos and Issue Tracking, procédez comme suit :

  1. Dans la IBM Cloud console, cliquez sur l'icône Menu (icône hamburger ) > Automatisation de la plateforme > Chaînes d'outils. Sur la page Chaînes d'outils, cliquez sur la chaîne d'outils afin d'ouvrir sa page Vue d'ensemble.

  2. Cliquez sur Ajouter un outil.

  3. Dans la section Intégrations d'outils, cliquez sur Git Repos and Issue Tracking.

  4. Sélectionnez le serveur sur lequel vous souhaitez déployer les modifications de code. Après avoir créé l'intégration, vous pouvez l'éditer pour gérer la liste des serveurs avec lesquels vous êtes autorisé à travailler. Cliquez sur Gérer l'autorisation pour afficher la liste de tous les serveurs et supprimer le jeton que vous avez fourni pour être autorisé pour le serveur.

  5. Sélectionnez un type de référentiel :

    a. Pour créer un référentiel vide, cliquez sur Nouveau pour le type de référentiel et saisissez un nom de référentiel. b. Pour dévier un référentiel Git afin de pouvoir participer aux modifications via des demandes de fusion, cliquez sur Dévier pour le type de référentiel. Saisissez l'URL du référentiel source. c. Pour créer une copie d'un référentiel Git, cliquez sur Cloner pour le type de référentiel. Saisissez un nouveau nom de référentiel et l'URL du référentiel source. d. Si vous disposez d'un référentiel Git et désirez l'utiliser, cliquez sur Existant pour le type de référentiel. Saisissez l'URL du référentiel source.

  6. Votre nom d'utilisateur est automatiquement sélectionné pour affecter la propriété de cette nouvelle intégration à vous-même. Une fois l'intégration créée, un autre utilisateur autorisé peut se réaffecter la propriété de l'intégration à lui-même en l'éditant.

  7. Si vous voulez créer un référentiel privé, cochez la case Rendre ce référentiel privé.

  8. Si vous voulez utiliser Problèmes pour le suivi des problèmes, cochez la case Activer Problèmes .

  9. Si vous voulez suivre le déploiement des changements du code en créant des étiquettes et des commentaires sur les validations, ainsi que des libellés et des commentaires sur les problèmes référencés par les validations, cochez la case Suivi du déploiement des changements du code.

  10. Cliquez sur Créer une intégration.

  11. A partir de la page Présentation de la chaîne d'outils, sur la carte Référentiels, cliquez sur le référentiel Git avec lequel vous souhaitez travailler. La page de présentation de votre projet s'ouvre.

Si vous ne disposez pas d'un droit Maître ou Propriétaire sur le référentiel que vous liez, votre intégration sera limitée car vous ne pouvez pas utiliser un webhook. Les webhooks sont nécessaires pour exécuter un pipeline automatiquement lorsqu'une validation est envoyée par commande push au référentiel. Sans webhook, vous devez démarrer manuellement vos pipelines.

Configuration d' Git Repos and Issue Tracking à l'aide de l'API

L'intégration d'outils Git Repos and Issue Tracking prend en charge les paramètres de configuration suivants que vous pouvez utiliser avec l'API et les SDK de la chaîne d'outils HTTP lorsque vous créez, lisez et mettez à jour des intégrations d'outils.

Vous devez spécifier la propriété tool_type_id dans le corps de la demande avec la valeur hostedgit.

paramètres d'intégration de l'outilGit Repos and Issue Tracking
Paramètre Utilisation Type Argument Terraform Description
url_racine_API facultatif, pouvant être mis à jour Chaîne url_racine_API URL s de l'API Git Repos and Issue Tracking.
jeton_API facultatif, pouvant être mis à jour Mot de passe jeton_API Le jeton d'accès personnel (PAT). Ce paramètre est requis uniquement si auth_type est défini sur pat, sinon il est ignoré.
auth_type facultatif, pouvant être mis à jour, Default: oauth Chaîne auth_type Définissez la méthode d'authentification à utiliser pour accéder au fournisseur Git.
branch_par_défaut facultatif, pouvant être mis à jour Chaîne branch_par_défaut Nom de la branche par défaut du référentiel Git.
enable_traceability facultatif, pouvant être mis à jour, Default: false Booléen enable_traceability Définissez cette valeur sur pour true suivre le déploiement des modifications de code en créant des balises, des étiquettes et des commentaires sur les commits, les pull requests et les tickets référencés.
git_id facultatif, non modifiable Chaîne git_id Définissez cette valeur sur hostedgit pour cibler Git Repos and Issue Tracking.
has_issues facultatif, pouvant être mis à jour, Default: true Booléen problèmes_chaîne_d'outils_activés Définissez cette valeur sur true pour activer les problèmes sur le référentiel Git Repos and Issue Tracking et ajoutez une carte d'intégration d'outil Problèmes à la chaîne d'outils. Définissez cette valeur sur false pour supprimer la carte d'intégration d'outils de la chaîne d'outils. Cette action n'a aucune incidence sur l'activation des problèmes sur le référentiel Git Repos and Issue Tracking lui-même.
propriété_intégration facultatif, pouvant être mis à jour Chaîne propriété_intégration Sélectionnez l'utilisateur pour lequel les opérations Git sont effectuées.
owner_id facultatif, non modifiable Chaîne owner_id Utilisateur ou groupe Git Repos and Issue Tracking propriétaire du référentiel. Ce paramètre est obligatoire lorsque vous créez un référentiel ou que vous clonez ou déviez un référentiel. Cette valeur est calculée lorsque vous établissez un lien vers un référentiel existant.
rep_privé facultatif, non modifiable, Default: true Booléen rep_privé Définissez cette valeur sur true pour rendre le référentiel privé lorsque vous créez un référentiel ou lorsque vous clonez ou déviez un référentiel. Ce paramètre n'est pas utilisé lorsque vous établissez un lien vers un référentiel existant.
repo_id facultatif, non modifiable Chaîne repo_id L'identifiant du projet Git Repos and Issue Tracking.
repo_name facultatif, non modifiable Chaîne repo_name Nom du dépôt Git Repos and Issue Tracking à créer. Ce paramètre est obligatoire lorsque vous créez un référentiel ou que vous clonez ou déviez un référentiel. Cette valeur est calculée lorsque vous établissez un lien vers un référentiel existant.
repo_url facultatif, non modifiable Chaîne repo_url Le URL du repo Git Repos and Issue Tracking pour l'intégration de cet outil. Ce paramètre est obligatoire lorsque vous établissez un lien vers un référentiel existant. Cette valeur est calculée lorsque vous créez un référentiel ou que vous clonez ou bifurquez un référentiel.
url_repo_source facultatif, non modifiable Chaîne url_repo_source Le URL du repo que vous voulez forker ou cloner. Ce paramètre est obligatoire lorsque vous déviez ou clonez un référentiel, mais il n'est pas utilisé lorsque vous créez un référentiel ou un lien vers un référentiel existant.
url_jeton facultatif, pouvant être mis à jour Chaîne url_jeton Le jeton URL qui est utilisé pour autoriser le serveur Git Repos and Issue Tracking.
type requis, non modifiable Chaîne type Opération à effectuer pour initialiser la nouvelle intégration d'outils. Utilisez new pour créer un référentiel Git, clone pour cloner un référentiel Git existant dans un nouveau référentiel Git, fork pour dévier un référentiel Git existant ou link pour le lier à un référentiel Git existant.

Si vous êtes connecté à IBM Cloud à l'aide d'un profil approuvé, lorsque vous configurez une intégration Git Repos and Issue Tracking d'outil, vous devez utiliser la méthode d'authentification par jeton d'accès personnel. La méthode d'authentification OAuth est incompatible avec Trusted Profiles.The L'authentification par jeton d'accès personnel (PAT) vous permet de configurer l'intégration de l'outil Git Repos and Issue Tracking à l'aide de l'interface graphique, de l'API ou de Terraform. En effet, le PAT est lié à l'utilisateur réel qui possède le profil de confiance. Les utilisateurs peuvent utiliser leurs jetons d'accès personnels pour créer ou reconfigurer les intégrations d'outils Git Repos and Issue Tracking dans la chaîne d'outils. Cependant, ils doivent se connecter en tant qu'utilisateur normal pour accéder à l'interface utilisateur du répertoire Git.