Créer des dépôts à partir de GitLab

Cloud Build permet de créer des déclencheurs à partir desquels effectuer des compilations hébergés sur GitLab, ce qui vous permet d'exécuter des compilations en réponse à des événements tels que des commits ou des demandes de fusion associés à votre dépôt GitLab.

Cette page explique comment activer la fonctionnalité de déclenchement sur un GitLab. En savoir plus sur les déclencheurs Cloud Build et les dépôts Cloud Build.

Avant de commencer

  • Activer les API Cloud Build and Secret Manager.

    Activer les API

Créer un déclencheur GitLab

Console

Pour créer un déclencheur GitLab à l'aide de la console Google Cloud:

  1. Ouvrez la page Déclencheurs :

    Ouvrir la page Déclencheurs

  2. Sélectionnez votre projet Google Cloud en haut de la page, puis cliquez sur Ouvrir.

  3. Cliquez sur Créer un déclencheur.

  4. Entrez les paramètres de déclencheur suivants :

    • Nom : nom de votre déclencheur.

    • Région: sélectionnez la région de votre déclencheur.

      • Si le fichier de configuration de compilation associé au déclencheur spécifie un pool privé, Cloud Build utilise le pool privé pour exécuter votre build. Dans ce cas, la région que vous spécifiez dans votre déclencheur doit correspondre à celle dans laquelle vous avez créé le pool privé.
      • Si le fichier de configuration de compilation associé au déclencheur ne spécifie pas de pool privé, Cloud Build utilise la version par défaut pour exécuter votre build dans la même région comme déclencheur.

    • Description (facultatif) : description de votre déclencheur.

    • Événement : sélectionnez l'événement lié au dépôt qui appelle votre déclencheur.

      • Déployer sur une branche : configurez votre déclencheur pour lancer une compilation sur les commits réalisés dans une branche spécifique.

      • Transférer le nouveau tag : configurez votre déclencheur pour lancer une compilation sur des commits contenant un tag particulier.

      • Demande d'extraction: définissez votre déclencheur pour démarrer une compilation sur les commits effectués vers la demande de fusion.

    • Source: sélectionnez 2nd gen comme source.

      • Dépôt : sélectionnez le dépôt de votre choix dans la liste des dépôts disponibles. Pour connecter un nouveau dépôt, consultez Se connecter à un dépôt GitLab.

      • Branche ou tag : spécifiez une expression régulière à laquelle faire correspondre la valeur de la branche ou du tag. Pour en savoir plus sur la syntaxe des expressions régulières acceptables, consultez la page Syntaxe RE2.

      • Contrôle des commentaires: si vous avez sélectionné Demande d'extraction comme Événement, choisissez l'une des options suivantes pour déterminez si une compilation sera automatiquement exécutée par le déclencheur:

        • Obligatoire sauf pour les propriétaires et les collaborateurs: lorsqu'une fusion créé ou mis à jour par un propriétaire ou un collaborateur de dépôt, compilations seront automatiquement exécutées par le déclencheur. Si un serveur contributeur initie l'action, les compilations ne seront exécutées qu'après un propriétaire ou un collaborateur commente /gcbrun sur la demande de fusion.

        • Obligatoire: lorsqu'une demande de fusion est créée ou mise à jour par les constructions ne seront exécutées qu'après qu'un propriétaire un collaborateur commente /gcbrun sur la demande de fusion. Compilations sont exécutés chaque fois qu'une modification est apportée à une demande de fusion.

        • Facultatif: lorsqu'une demande de fusion est créée ou mise à jour par les builds sont automatiquement exécutés par des déclencheurs.

    • Configuration: sélectionnez le fichier de configuration de compilation situé dans votre dépôt ou de configurer votre build de manière intégrée le déclencheur.

    • Type: sélectionnez le type de configuration à utiliser pour votre compilation.

      • Fichier de configuration Cloud Build (yaml or json) : utilisez un fichier de configuration de compilation pour votre configuration.
      • Dockerfile : utilisez un fichier Dockerfile pour votre configuration.

    • Emplacement: spécifiez l'emplacement de votre configuration.

      • Dépôt: si votre fichier de configuration se trouve dans votre vous devez indiquer l'emplacement fichier de configuration de compilation ou Dockerfile et un nom pour l'image obtenue. Si votre configuration est un Dockerfile, vous pouvez éventuellement fournir un délai d'expiration pour votre compilation. Une fois le fichier Dockerfile et le nom de l'image fournis, vous obtenez un aperçu de la commande docker build que votre compilation va exécuter.

      • Intégré : si vous avez sélectionné Fichier de configuration Cloud Build (yaml ou json) comme option de configuration, vous pouvez spécifier votre configuration de compilation de manière intégrée. Cliquez sur Ouvrir l'éditeur pour écrire votre fichier de configuration de compilation dans le la console Google Cloud à l'aide de la syntaxe YAML ou JSON. Cliquez sur OK pour enregistrer la configuration de compilation.

  5. Cliquez sur Créer pour créer votre déclencheur GitLab.

gcloud

Pour créer des déclencheurs GitLab à l'aide des commandes gcloud, exécutez la commande suivante : commande:

gcloud builds triggers create gitlab \
  --name=TRIGGER_NAME \
  --repository=projects/PROJECT_ID/locations/REGION/connections/CONNECTION_NAME/repositories/REPO_NAME \
  --branch-pattern=BRANCH_PATTERN # or --tag-pattern=TAG_PATTERN \
  --build-config=BUILD_CONFIG_FILE \
  --region=REGION

Où :

  • TRIGGER_NAME correspond au nom de votre déclencheur.
  • PROJECT_ID correspond à votre ID de projet Google Cloud.
  • REGION est la région du déclencheur.
  • CONNECTION_NAME est le nom de votre connexion GitLab.
  • REPO_NAME est le nom de votre dépôt.
  • BRANCH_PATTERN est le nom de la branche de votre dépôt sur lequel appeler la compilation.
  • TAG_PATTERN est le nom du tag de votre dépôt sur lequel appeler la compilation.
  • BUILD_CONFIG_FILE correspond au chemin d'accès à votre fichier de configuration de compilation.

Partage des données

Les données envoyées à GitLab depuis Cloud Build vous permettent d'identifier les déclencheurs grâce à leur nom et d'afficher les résultats des compilations dans vos dépôts GitLab.

Les données suivantes sont actuellement partagées entre Cloud Build et votre hôte GitLab:

  • ID de projet Google Cloud
  • Nom du déclencheur

Étape suivante