Se connecter à un dépôt GitHub

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

Avant de commencer

  • Enable the Cloud Build API.

    Roles required to enable APIs

    To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

    Enable the API

  • Préparez votre code source dans un dépôt GitHub.
  • Vous devez disposer d'un fichier de configuration Dockerfile ou Cloud Build dans votre dépôt source GitHub.
  • Si vous connectez initialement votre dépôt à Cloud Build, assurez-vous de disposer d'autorisations de niveau administrateur sur votre dépôt. Pour en savoir plus sur les autorisations associées aux dépôts GitHub, consultez la section Niveaux d'autorisation des dépôts pour une organisation.

  • Pour utiliser les commandes gcloud sur cette page, installez Google Cloud CLI.

Se connecter à un dépôt GitHub

Pour connecter votre dépôt GitHub à votre projet Cloud Build :

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

    Ouvrir la page "Dépôts"

  2. Dans le sélecteur de projet de la barre supérieure, sélectionnez votre projet Google Cloud .

  3. En haut de la page, sélectionnez l'onglet 1re génération.

  4. Cliquez sur Connecter un dépôt.

    Le panneau Connecter un dépôt s'affiche.

    1. Sous Sélectionner un fournisseur de gestion du code source, sélectionnez Application GitHub Cloud Build.

    2. Cliquez sur Continuer.

      Vous serez peut-être invité à authentifier votre connexion à GitHub ou à installer l'application GitHub. Si vous ne l'avez pas encore fait, procédez comme suit :

      1. Si vous ne vous êtes pas encore connecté à GitHub, faites-le maintenant.

        La page d'autorisation s'affiche et vous invite à autoriser l'application Google Cloud Build à se connecter à Google Cloud.

        Capture d'écran du bouton d'autorisation

      2. Cliquez sur Autoriser Google Cloud Build par GoogleCloudBuild.

      3. Cliquez sur Installer Google Cloud Build.

      4. Dans la boîte de dialogue qui s'affiche, sélectionnez votre nom d'utilisateur ou votre organisation GitHub.

      5. Sélectionnez l'une des options suivantes en fonction des besoins de votre entreprise :

        • Tous les dépôts : permet d'activer les dépôts GitHub actuels et futurs pour y accéder à l'aide de l'application Cloud Build.

        • Sélectionner uniquement les dépôts : utilisez la liste déroulante Sélectionner des dépôts pour n'autoriser l'accès qu'à certains dépôts à l'aide de l'application Cloud Build.

        Vous pourrez activer des dépôts supplémentaires ultérieurement. Si vous sélectionnez l'option Tous les dépôts, l'application Cloud Build est autorisée à accéder à tous vos dépôts. Toutefois, vous devez connecter chaque nouveau dépôt via Cloud Build en suivant les étapes décrites dans cette section.

      6. Cliquez sur Installer pour installer l'application Cloud Build.

        La boîte de dialogue se ferme et la page Dépôts s'affiche.

    3. Dans la section Sélectionner un dépôt, sélectionnez les champs suivants :

      • Compte GitHub : compte GitHub utilisé pour installer l'application GitHub Cloud Build. Ce champ peut être présélectionné.

      • Dépôt : dépôts que vous souhaitez connecter à Cloud Build.

      Si vous ne voyez pas un ou plusieurs de vos dépôts cibles, cliquez sur Modifier les dépôts sur GitHub pour activer d'autres dépôts dans l'application GitHub Cloud Build. Vous pouvez ensuite sélectionner votre nouveau dépôt cible dans la section Sélectionner un dépôt.

    4. Une fois que vous avez sélectionné votre compte et vos dépôts GitHub, lisez la clause de non-responsabilité et cochez la case à côté de celle-ci pour indiquer que vous acceptez les conditions d'utilisation.

    5. Cliquez sur Se connecter.

    6. (Facultatif) Dans la section Créer un déclencheur, sélectionnez les dépôts pour lesquels vous souhaitez créer un déclencheur dans le champ Créer un exemple de déclencheur pour ces dépôts. Une fois que vous avez sélectionné vos dépôts, cliquez sur Créer un déclencheur.

    7. Cliquez sur OK.

(Facultatif) Mettre à jour le compte GitHub authentifié

Si vous devez mettre à jour le compte GitHub associé à votre compte Google, vous pouvez accéder à la page S'authentifier avec GitHub. Vous devrez peut-être effectuer cette opération si vous remarquez que la page Connecter un dépôt à Cloud Build indique que l'application GitHub n'est installée sur aucun dépôt après l'installation de l'application Cloud Build sur GitHub.

Étapes suivantes