Ajout d'une étape de compilation gérée

Ajoutez une étape de compilation gérée dans le pipeline de compilation.

Vous devez ajouter des référentiels de code dans cette étape pour la compilation. Les référentiels doivent être configurés avant l'ajout de l'étape de compilation gérée. Pour créer des référentiels, voir Gestion des référentiels de code.

Avant d'ajouter une étape, vous devez avoir un pipeline de compilation.

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

    1. Ouvrez le menu de navigation et cliquez sur Services de développement. Sous DevOps, cliquez sur Projets.
    2. Sélectionnez un projet et un pipeline de compilation.
    3. Pour ajouter une étape au pipeline, cliquez sur l'icône + et sélectionnez Ajouter une étape.
    4. Pour le type d'étape, sélectionnez Compilation gérée, puis cliquez sur Suivant.
    5. Entrez un nom et une description pour l'étape. L'ajout d'une description est facultatif.
    6. Sélectionnez la forme de l'exécuteur de compilation.

      Vous pouvez sélectionner la forme par défaut (option de démarrage rapide) ou vous pouvez personnaliser la forme en sélectionnant le nombre d'OCPU et la quantité de mémoire (en Go) requis. En cas de personnalisation, le provisionnement prend plus de temps.

    7. Sélectionnez Oracle Linux 7 comme image de conteneur de base.
    8. (Facultatif) Pour accéder au réseau virtuel privé :
      1. Sélectionnez un réseau en nuage virtuel et un sous-réseau régional dans la location.
      2. (Facultatif) Pour restreindre l'accès au VCN, vous pouvez sélectionner des groupes de sécurité de réseau dans les réseaux en nuage virtuels.

      La résolution du système de noms de domaine (DNS) interne des réseaux en nuage virtuels n'est pas prise en charge pour l'accès privé. Utilisez des adresses IP pour communiquer avec les services hébergés dans le réseau privé.

    9. (Facultatif) Entrez le chemin du fichier de spécification de compilation.

      La spécification de compilation contient les étapes et les paramètres utilisés par le pipeline de compilation pour exécuter une compilation.

      Note

      Cette étape n'est requise que si le fichier de spécification de création, build_spec.yaml, ne se trouve pas dans le répertoire racine du référentiel de code principal.
    10. Sélectionnez le référentiel de code principal pour la compilation.
      • Sélectionnez le type de connexion et une connexion pour le référentiel. Les types de connexion pris en charge sont les suivants :

        Seules les connexions externes que vous avez déjà configurées peuvent être sélectionnées. Si aucune connexion n'existe, cliquez sur le lien Créer une connexion.

      • Si vous sélectionnez GitHub ou GitLab, sélectionnez un référentiel.
      • Si vous sélectionnez Bitbucket Cloud, sélectionnez un espace de travail et un référentiel.
      • Si vous sélectionnez Visual Builder Studio (VBS), sélectionnez un projet VBS externe et un référentiel.
      • Si vous sélectionnez Serveur Bitbucket ou Serveur GitLab, entrez l'URL du référentiel qui contient la source de compilation.
      • Sélectionnez ou entrez une branche pour le référentiel de code sélectionné.

        La compilation se produit dans la branche qui déclenche l'exécution de la compilation et non à partir de la branche configurée lors de l'ajout de l'étape de compilation. La branche configurée peut être utilisée lorsque l'exécution de la compilation est déclenchée manuellement au moyen de la console OCI.

      • Pour Nom de la source de compilation, entrez un nom unique pour le dossier où le code source est téléchargé dans l'exécuteur de la compilation. Exemples : Source1, Source2.
      • Enregistrez les modifications.
    11. Pour ajouter d'autres référentiels de code, cliquez sur Ajouter une source de compilation et sélectionnez les référentiels.
    12. (Facultatif) Entrez une valeur de temporisation (en secondes) pour l'étape.
    13. (Facultatif) Pour ajouter des marqueurs à l'étape, cliquez sur Afficher les options de marquage. Le marquage est un système de métadonnées permettant d'organiser les ressources de la location et d'en assurer le suivi.

      Si vous êtes autorisé à créer une ressource, vous êtes également autorisé à ajouter des marqueurs à structure libre à cette ressource.

      Pour ajouter un marqueur défini, vous devez être autorisé à utiliser l'espace de noms de marqueur.

      Pour plus d'informations, voir Marqueurs de ressource.

    14. Pour ajouter l'étape au pipeline, cliquez sur Ajouter.

      Un aperçu des étapes fournit un instantané de la configuration.

    Vous pouvez ajouter les étapes suivantes de manière séquentielle ou parallèle au pipeline :
    • Fournir des artefacts : Stockez les applications logicielles créées à partir de l'étape de compilation gérée dans les référentiels du registre ou du registre de conteneurs d'Oracle Cloud Infrastructure.
    • Déclencher le déploiement : Démarrez un pipeline de déploiement pour déployer la sortie du pipeline de compilation.
    • Attente : Définissez une pause d'une durée spécifique pour tester le pipeline de compilation.

    Vous pouvez exécuter manuellement la compilation ou déclencher automatiquement une exécution de compilation lorsque vous validez les modifications apportées au référentiel de code. L'exécution manuelle utilise la dernière validation du référentiel de code. Vous pouvez exécuter la compilation en fonction d'une validation spécifique en notant les détails de celle-ci.

  • Pour créer un pipeline de compilation, exécutez la commande create :

    oci devops build-pipeline create --project-id

    Pour ajouter une étape de compilation gérée pour le pipeline, exécutez la commande create-build-stage :

    oci devops build-pipeline-stage create-build-stage

    Les paramètres requis sont les suivants :

    • --build-pipeline-id
    • --build-source-collection
    • --image
    • --stage-predecessor-collection

    Paramètre facultatif pour configurer la forme de l'exécuteur de compilation :

    --build-runner-config

    Pour afficher toutes les commandes pour build-pipeline et build-pipeline-stage :

    oci devops build-pipeline -h
    oci devops build-pipeline-stage -h

    Pour obtenir de l'aide sur la commande create-build-stage :

    oci devops build-pipeline-stage create-build-stage -h
  • Pour créer un pipeline de compilation, utilisez l'opération CreateBuildPipeline.

    Pour ajouter une étape de compilation gérée pour le pipeline, utilisez l'opération CreateBuildPipelineStage. Pour l'attribut buildPipelineStageType, spécifiez la valeur BUILD.

    En plus de la demande CreateBuildStageDetails, vous devez ajouter l'un des attributs indiqués pour personnaliser la forme de l'exécuteur de compilation :

    .buildRunnerShapeConfig(CustomBuildRunnerShapeConfig.builder().ocpus(<no_of_ocpus>).memoryInGBs(<memory_in_gbs>).build())
    .buildRunnerShapeConfig(DefaultBuildRunnerShapeConfig.builder().build())