Intégration d'un projet avec un dépôt Git

Connectez un projet à un référentiel Git pour y enregistrer les configurations. Ce faisant, vous pouvez utiliser votre référentiel et les outils CI et CD de votre choix pour automatiser les pipelines sur les configurations d’un projet.

Il s'agit d'une fonctionnalité expérimentale disponible à des fins d'évaluation et de test et susceptible d'être modifiée sans préavis.

Les pipelines et les chaînes d'outils sont personnalisables, vous pouvez donc automatiser de nombreuses actions entre votre référentiel Git et votre projet en utilisant les méthodes API des projets ou les commandes CLI. Par exemple, vous pouvez créer un pipeline pour déclencher une mise à jour dans votre projet lorsque les modifications de configuration sont fusionnées dans la branche principale de votre référentiel. Pour plus d'informations, consultez Automatiser les actions des projets dans votre référentiel Git.

Dans un projet, les brouillons de configuration peuvent être enregistrés dans n'importe quelle branche de votre référentiel. Cependant, vous ne pouvez valider et déployer des brouillons de configuration qu'après leur fusion dans la branche de votre référentiel qui gère vos pipelines CD. Vous devez également synchroniser les mises à jour de votre référentiel dans votre projet en mettant à jour les configurations avant de pouvoir valider et déployer ces configurations. Vous pouvez automatiser cette mise à jour en utilisant la méthode API project.config.update ou en utilisant la commande CLI ibmcloud project config-update.

Avant de commencer

  1. Assurez-vous que vous disposez du rôle d'éditeur sur le service Projets IBM Cloud pour gérer les intégrations du référentiel Git.

  2. Enregistrez un jeton d'accès en tant que secret pour vous connecter à votre référentiel Git. Le jeton d'accès a besoin d'un accès en écriture aux branches que vous souhaitez utiliser et pour créer des commits dans votre référentiel. Le jeton d’accès doit également pouvoir répertorier les branches et les lire.

    1. Créez une instance de service Secrets Manager dans votre compte IBM Cloud. Pour créer un secret, vous devez avoir le rôle Writer ou un rôle plus élevé sur le service Secrets Manager.

    2. Après avoir créé votre instance de secret, assurez-vous de sélectionner Autre type de secret pour ajouter un secret arbitraire. Pour plus d’informations sur la création d’un secret arbitraire, voir Création de secrets arbitraires dans l’interface utilisateur. Votre secret arbitraire doit contenir le jeton d’accès à votre référentiel Git.

Connecter un projet à un référentiel Git

Connectez votre dépôt Git à votre projet. Ce faisant, les modifications de configuration sont enregistrées dans votre référentiel, par opposition au fichier JSON du projet. Étant donné que votre projet doit enregistrer des configurations dans votre référentiel, vous devez fournir un jeton d’accès pour vous authentifier auprès du référentiel à partir de votre projet.

  1. Dans la console IBM Cloud, cliquez sur l'icône du menu de navigation Icône du menu de navigation > Projets et sélectionnez un projet.
  2. Dans l’onglet Gérer, sélectionnez Intégrations.
  3. Dans la section Intégration du référentiel Git, cliquez sur Connecter.
  4. Dans le menu Type de référentiel, sélectionnez le type de référentiel que vous souhaitez utiliser pour gérer vos configurations. En règle générale, ce référentiel est celui que vous utilisez pour gérer vos pipelines et chaînes d’outils. Vous pouvez sélectionner GitHub, GitLab ou GitHub Enterprise.
  5. Saisissez l'adresse URL du référentiel.
  6. Vous pouvez également spécifier un dossier dans le référentiel. Pensez à spécifier un dossier si vous souhaitez intégrer votre référentiel à plusieurs projets. Chaque projet peut avoir son propre dossier.
  7. Survolez ou cliquez sur le champ du jeton d'accès, puis cliquez sur l'icône Secrets Icône clé pour sélectionner le secret qui contient votre jeton d'accès.
  8. Si votre projet contient déjà des configurations, sélectionnez Copier les fichiers de configuration existants dans ce référentiel pour enregistrer les configurations existantes dans votre référentiel.
  9. Cliquez sur Sauvegarder.

Etapes suivantes

Maintenant que votre référentiel Git est connecté à votre projet, vous êtes prêt à personnaliser les pipelines et les chaînes d'outils. Pour savoir comment créer un pipeline qui met à jour automatiquement les configurations de votre projet lorsque des modifications sont fusionnées dans votre branche principale, consultez Automatisation des actions des projets dans votre référentiel Git.