Créer des dépôts depuis GitHub Enterprise

Restez organisé à l'aide des collections Enregistrez et classez les contenus selon vos préférences.

Cloud Build vous permet de créer des déclencheurs sur une instance GitHub Enterprise. Cette page explique comment utiliser des déclencheurs GitHub Enterprise pour appeler des compilations en réponse à des commits ou des demandes d'extraction à partir d'une instance GitHub Enterprise.

Avant de commencer

  • Activer les API Cloud Build and Secret Manager.

    Activer les API

Créer un déclencheur GitHub Enterprise

Cette section explique comment créer un déclencheur et l'associer à votre installation GitHub Enterprise. Si vous souhaitez utiliser les déclencheurs GitHub Enterprise sur un réseau privé, consultez la page Créer des dépôts à partir de GitHub Enterprise sur un réseau privé pour obtenir des instructions supplémentaires.

Console

Pour en savoir plus sur la création de déclencheurs à l'aide des déclencheurs GitHub, consultez la page Créer des déclencheurs GitHub.

API

Le modèle JSON suivant montre comment créer des déclencheurs via la ligne de commande:

  {
      "filename": "cloudbuild.yaml",
      "name": "trigger-name",
      "description": "trigger-description",
      "github": {
          "push": {
              "branch": ".*",
          },
          "owner": "owner",
          "name": "repo-name",
      "enterprise_config_resource_name": "projects/project-number/githubEnterpriseConfigs/id"
      },
      "include_build_logs": "INCLUDE_BUILD_LOGS_WITH_STATUS"
  }

Où :

  • trigger-name est le nom du déclencheur.
  • trigger-description est une description du déclencheur
  • owner est le propriétaire du dépôt GitHub.
  • repo-name est le nom du dépôt GitHub.
  • project-number est le numéro du projet Cloud.
  • id est l'ID de votre GitHubEnterpriseConfig.
  • [FACULTATIF] _include_build_logs est un champ que vous pouvez spécifier pour afficher les journaux de compilation de vos dépôts. Cette option est compatible avec les compilations provenant de dépôts GitHub et GitHub Enterprise.

Saisissez la commande curl suivante dans votre terminal, où project-id est l'ID du projet Cloud:

  curl -X POST -H "Authorization: Bearer "$(gcloud auth print-access-token) -H "Content-Type: application/json; charset=utf-8" https://cloudbuild.googleapis.com/v1/projects/project-id/triggers -d @trigger.json

Votre déclencheur est maintenant créé.

Partage des données

Les données envoyées à GitHub Enterprise depuis Cloud Build vous permettent d'identifier les déclencheurs par leur nom et d'afficher les résultats de compilation sur GitHub Enterprise.

Les données suivantes sont actuellement partagées entre Cloud Build et GitHub Enterprise:

  • ID du projet Cloud
  • Trigger name
  • Journaux de compilation

Si vous avez créé des déclencheurs avant le mois d'août 2020, le partage des données peut ne pas être activé pour votre projet. Vous pouvez activer le partage de données pour tous les déclencheurs GitHub Enterprise de votre projet en cliquant sur Activer dans l'onglet Partage des données Cloud Build.

Si les vérifications d'état requises sont activées pour un dépôt GitHub Enterprise, l'activation du partage des données peut temporairement interrompre les vérifications d'état. Vous pouvez ajuster les configurations de la vérification d'état pour rechercher le nom de votre déclencheur en procédant comme suit:

  • Désactiver les vérifications requises spécifiques à Cloud Build dans le dépôt GitHub
  • S'assurer que le partage des données est activé dans Cloud Build
  • Exécuter une nouvelle compilation dans Cloud Build qui publie des états dans votre dépôt
  • Réactivation des vérifications d'état requises en sélectionnant le nom du déclencheur

Étapes suivantes