Documentation Oracle Cloud Infrastructure

Déclenchement d'une exécution de build

Dans Oracle Cloud Infrastructure (OCI) DevOps, une exécution de build peut être déclenchée automatiquement lorsque vous validez les modifications apportées à un référentiel de code.

Dans le service DevOps, vous pouvez créer vos propres référentiels de code privés ou vous connecter à des référentiels de code externes et déclencher le build. Pour plus d'informations, reportez-vous à Création d'une connexion externe.

Vous pouvez contrôler l'action de déclenchement en indiquant les fichiers modifiés du référentiel à inclure ou exclure lors de l'exécution de build. L'action déclencheur basé sur un fichier n'est applicable que pour l'événement de propagation.

Pour créer un déclencheur dans DevOps, vous devez associer un projet DevOps, un pipeline de build et un référentiel de code au projet.

Pour exécuter un build manuellement, reportez-vous à Exécution d'un build.

Pour accéder à DevOps à l'aide de la console Oracle Cloud, de l'API REST et de l'interface de ligne de commande, reportez-vous à Accès à DevOps.

    1. Ouvrez le menu de navigation et cliquez sur Services de développeur. Sous DevOps, cliquez sur Projets.
    2. Sur la page DevOps Projects, sélectionnez un projet.
    3. Sur la page de détails du projet, à gauche, cliquez sur Déclencheurs.
    4. Cliquez sur Créer un déclencheur.
    5. Saisissez le nom du déclencheur et sélectionnez une connexion source existante :
      • Référentiel de code OCI
      • GitHub
      • GitLab
      • Bitbucket Cloud
      • Visual Builder Studio
      • Bitbucket Server
      • GitLab Server
    6. Si vous choisissez Référentiel de code OCI, sélectionnez un référentiel de code pour valider les modifications.
    7. (Facultatif) Pour Bitbucket Cloud et Visual Builder Studio, sélectionnez une connexion contenant les informations d'identification d'authentification et l'URL de base.

      La connexion est requise pour les déclenchements basés sur un fichier avec événement de propagation.

    8. Cliquez sur Ajouter une action.
    9. Sélectionnez un pipeline de build à déclencher.
    10. (Facultatif) Sélectionnez un événement parmi les options suivantes pour déclencher l'exécution de build :
      • Propagation
      • Demande d'extraction créée
      • Demande d'extraction mise à jour
      • Demande d'extraction fusionnée
      • Demande d'extraction rouverte
      Remarque

      La disponibilité des événements varie en fonction du type de référentiel de code. Pour Bitbucket Cloud et Bitbucket Server, l'événement de demande d'extraction rouverte n'est pas pris en charge.
    11. Sélectionnez Conditions d'exécution de build.
      Pour l'événement de propagation, vous pouvez déclencher l'exécution de build en indiquant le nom du branchement source, ainsi que les fichiers à inclure ou à exclure dans l'exécution de build.
      • (Facultatif) Entrez le branchement de référentiel source sur lequel l'événement sélectionné déclenche l'exécution de build.

        Si vous sélectionnez l'un des événements de demande d'extraction, vous pouvez également sélectionner le branchement du référentiel de code cible.

      • (Facultatif) Entrez les fichiers à inclure pour l'action de déclenchement. Les fichiers sont spécifiés à l'aide de modèles glob.

        Par exemple, src/**/*.txt inclut tous les fichiers texte du dossier "src". Pour plus d'exemples et de détails, reportez-vous à Modèles glob.

      • (Facultatif) Entrez les fichiers à exclure pour l'action de déclenchement. Les fichiers sont spécifiés à l'aide de modèles glob.

        Par exemple, **.html exclut tous les fichiers HTML. Pour plus d'exemples et de détails, reportez-vous à Modèles glob.

    12. Enregistrez les modifications.
    13. Cliquez sur Créer pour créer le déclencheur.
    14. Dans la boîte de dialogue Clé secrète du déclencheur, copiez l'URL et la clé secrète du déclencheur car vous ne pourrez plus les extraire dans la console.

      La clé secrète de déclencheur est applicable uniquement pour GitHub, GitLab et Visual Builder Studio. Pour Bitbucket Cloud, la clé secrète est incluse dans l'URL de déclencheur. Pour accéder au service DevOps à partir de ces référentiels, vous devez configurer un webhook et une clé secrète dans les référentiels de code externes.

      Afin de configurer des webhooks pour les divers référentiels externes, reportez-vous aux liens suivants :

    15. Cliquez sur Fermer.

  • Pour créer un déclencheur de référentiel de code OCI, exécutez la commande create-devops-code-repo-trigger :

    oci devops trigger create-devops-code-repo-trigger --actions, --project-id

    Pour créer un déclencheur GitHub, exécutez la commande create-github-trigger :

    oci devops trigger create-github-trigger --actions, --project-id

    Pour créer un déclencheur GitLab, exécutez la commande create-gitlab-trigger :

    oci devops trigger create-gitlab-trigger --actions, --project-id

    Pour créer un déclencheur Bitbucket Cloud, exécutez la commande create-bitbucket-cloud-trigger :

    oci devops trigger create-bitbucket-cloud-trigger --actions, --project-id

    Pour créer un déclencheur Visual Builder Studio, exécutez la commande create-vbs-trigger :

    oci devops trigger create-vbs-trigger --actions, --project-id

    Pour créer un déclencheur Bitbucket Server, exécutez la commande create-bitbucket-server-trigger :

    oci devops trigger create-bitbucket-server-trigger --actions, --project-id

    Pour créer un déclencheur GitLab Server, exécutez la commande create-gitlab-server-trigger :

    oci devops trigger create-gitlab-server-trigger --actions, --project-id

    Afin d'obtenir toutes les commandes pour trigger, exécutez la commande suivante :

    oci devops trigger -h

  • Pour créer un déclencheur, utilisez l'opération CreateTrigger.