Se connecter à un dépôt GitHub Enterprise

Cette page explique comment connecter un dépôt GitHub Enterprise à Cloud Build. Pour en savoir plus sur les dépôts Cloud Build, consultez Dépôts Cloud Build.

Avant de commencer

  • Activez les API Cloud Build et Secret Manager, si ce n'est pas déjà fait.

    Rôles requis pour activer les API

    Pour activer les API, vous devez disposer de l'autorisation serviceusage.services.enable. Si vous avez créé le projet, vous disposez probablement déjà de cette autorisation grâce au rôle Propriétaire (roles/owner). Sinon, vous pouvez obtenir cette autorisation grâce au rôle Administrateur Service Usage (roles/serviceusage.serviceUsageAdmin). Découvrez comment attribuer des rôles.

    Activer les API

  • Suivez les instructions pour connecter un hôte GitHub Enterprise.
  • Assurez-vous de disposer d'un accès administrateur aux dépôts dans lesquels vous souhaitez activer les déclencheurs GitHub Enterprise.

Se connecter à un dépôt GitHub Enterprise

Console

Pour connecter un dépôt GitHub Enterprise à une connexion hôte, procédez comme suit :

  1. Ouvrez la page Dépôts dans la console Google Cloud .

    Ouvrir la page "Dépôts"

    La page Dépôts s'affiche.

  2. En haut de la page, sélectionnez l'onglet 2e génération.

  3. Cliquez sur Associer le dépôt pour associer des dépôts à votre connexion.

    Le panneau Associer des dépôts s'affiche.

  4. Dans le panneau Associer des dépôts, saisissez les informations suivantes :

    1. Connexion : sélectionnez une connexion dans le menu déroulant.

    2. Dépôt : sélectionnez un dépôt à associer à votre connexion.

    3. Nom du dépôt : saisissez un nom pour votre dépôt.

      1. Généré : sélectionnez cette option pour que Cloud Build génère automatiquement des noms de dépôts pour vous pour les dépôts sélectionnés.

      2. Manuelle : sélectionnez cette option pour spécifier manuellement les noms de vos dépôts sélectionnés.

        Si vous sélectionnez Manuel, vous pouvez modifier les noms des dépôts sélectionnés dans la section Noms des dépôts.

  5. Cliquez sur Associer pour associer votre dépôt à votre connexion.

Vous avez réussi à associer votre dépôt GitHub Enterprise à votre connexion.

gcloud

Pour ajouter un dépôt GitHub Enterprise à votre connexion, saisissez la commande suivante :

   gcloud builds repositories create REPO_NAME \
     --remote-uri=REPO_URI \
     --connection=CONNECTION_NAME --region=REGION

Où :

  • REPO_NAME est le nom du dépôt.
  • REPO_URI est le lien vers votre dépôt GitHub.
  • CONNECTION_NAME est le nom donné à la connexion hôte GitHub Enterprise créée dans Cloud Build à partir de Se connecter à un hôte GitHub Enterprise.
  • REGION correspond à la région de votre connexion.

Terraform

Pour ajouter un dépôt GitHub Enterprise à votre connexion, ajoutez l'extrait de code suivant à votre configuration Terraform :

    resource "google_cloudbuildv2_repository" "my-repository" {
      project = "PROJECT_ID"
      name = "REPO_NAME"
      location = :REGION"
      parent_connection = google_cloudbuildv2_connection.my-connection.name
      remote_uri = "REMOTE_URI'
  }

Où :

  • PROJECT_ID est l'ID de votre projet Google Cloud .
  • REPO_NAME par le nom de votre dépôt GitHub.
  • REGION correspond à la région de votre connexion.
  • URI est l'URI distant de votre dépôt. Exemple : https://github.com/myuser/myrepo.git.

Étapes suivantes