Documentation sur Oracle Cloud Infrastructure

Ajout d'une étape d'interpréteur de commandes

Une étape d'interpréteur de commandes permet d'exécuter des commandes personnalisées dans le pipeline de déploiement. Cette étape peut être ajoutée à tout moment dans le pipeline de déploiement.

Vous devez préparer un fichier YAML de spécification de commande contenant toutes les étapes à exécuter lors du déploiement. La spécification de commande est exécutée sur un hôte d'instance de conteneur dans le compartiment et le sous-réseau de votre location sélectionnés. Vous avez la possibilité de choisir une autre configuration d'instance avant le déploiement. Voir Informations détaillées sur les environnements d'exécution de l'image de conteneur de l'interpréteur de commandes. Lorsque vous exécutez le pipeline de déploiement, vous pouvez voir l'exécution des étapes définies dans la spécification des commandes dans la sortie et les journaux du pipeline. Pour obtenir la syntaxe et un exemple de spécification de commande, voir Spécification de commande.

Principaux avantages de l'ajout d'une étape d'interpréteur de commandes

  • Automatiser les déploiements sur les plates-formes OCI telles que le maillage de services et les instances de conteneur à l'aide de l'interface de ligne de commande OCI et d'autres outils préinstallés. Voir Informations détaillées sur les environnements d'exécution de l'image de conteneur de l'interpréteur de commandes.

    L'interface de ligne de commande OCI est préauthentifiée pour utiliser le principal de ressource du pipeline pour accéder aux ressources OCI.

  • Exécuter une migration de schéma de base de données à l'aide d'outils de ligne de commande tels qu'Oracle SQL Developer Command Line (SQLcl).
  • Utiliser tous les paramètres de pipeline en les référençant dans la spécification. Remplacer les paramètres et les variables lors de l'exécution du déploiement.
  • Effectuer des tests d'intégration sur les artefacts avant le déploiement en production.
  • Personnaliser le flux de travail DevOps. Par exemple, vous pouvez attendre que certaines ressources soient prêtes avant que le pipeline déploie des ressources supplémentaires.

Avant de créer le pipeline, vous devez disposer d'un projet DevOps et d'un artefact de spécification de commande. Les artefacts peuvent être insérés ou se trouver dans le registre d'artefacts.

    1. Ouvrez le menu de navigation et cliquez sur Services de développement. Sous DevOps, cliquez sur Projets.
    2. Sélectionnez un projet et cliquez sur Créer un pipeline.
    3. Entrez le nom et la description du pipeline. L'ajout d'une description est facultatif.
    4. Pour Type de pipeline, sélectionnez Créer un pipeline de déploiement.
    5. Cliquez sur Créer un pipeline.
    6. Pour ajouter une étape au nouveau pipeline, cliquez sur l'icône + et sélectionnez Ajouter une étape.
    7. Sélectionnez Intégrations : Interpréteur de commandes, puis cliquez sur Suivant.
    8. Entrez le nom de l'étape et une description facultative.
    9. Cliquez sur Sélectionner un artefact, puis sélectionnez l'artefact de spécification de commande disponible à déployer.

    10. Sélectionnez le compartiment pour créer l'instance de conteneur dans laquelle la spécification est exécutée.

      Vous pouvez conserver le compartiment par défaut affiché.

    11. Sélectionnez un domaine de disponibilité.

    12. Sélectionnez une forme pour l'instance de conteneur à partir des options fournies. Vous pouvez également sélectionner le nombre d'OCPU et la quantité de mémoire pour l'instance.

      Vous êtes facturé pour l'instance de conteneur (en fonction de la forme de calcul sélectionnée) pendant le déploiement, en fonction du modèle de tarification des instances de conteneur. Voir Tarifs des instances de conteneur.

      1. Sélectionnez un réseau en nuage virtuel et un sous-réseau régional dans la location. Vous pouvez sélectionner un sous-réseau public ou privé.

        Lors de l'exécution de la commande, une carte d'interface réseau virtuelle (vNIC) est créée dans le sous-réseau sélectionné. Assurez-vous que le sous-réseau a un chemin de réseau vers le registre de conteneurs OCI. Si une commande doit gérer d'autres ressources OCI, il faut également que le chemin de réseau et la politique soient configurés correctement.

      2. (Facultatif) Vous pouvez sélectionner des groupes de sécurité de réseau dans vos réseaux en nuage virtuels pour restreindre l'accès à ceux-ci.
      3. (Facultatif) Entrez une valeur de temporisation (en secondes) pour l'étape.
    13. (Facultatif) Pour ajouter des marqueurs au pipeline, cliquez sur Afficher les options de marquage. Le marquage est un système de métadonnées qui vous permet d'organiser les ressources de votre 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.

    Ajoutez des étapes de manière séquentielle ou parallèle au pipeline, en fonction de vos besoins. Pour déployer la sortie de la compilation dans l'environnement cible, exécutez le pipeline de déploiement.

    Pour déclencher automatiquement un déploiement à partir du pipeline de création, vous pouvez ajouter une étape Déclencher le déploiement au pipeline de création.

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

    oci devops deploy-pipeline create --project-id

    Pour créer une étape d'interpréteur de commandes, exécutez la commande create-shell-stage :

    oci devops deploy-stage create-shell-stage

    Paramètres requis pour la commande create-shell-stage :

    • --pipeline-id
    • --stage-predecessor-collection
    • --command-spec-artifact-id
    • --container-config

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

    oci devops deploy-pipeline -h
    oci devops deploy-stage -h

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

    oci devops deploy-stage create-shell-stage -h

  • Pour créer un pipeline de déploiement, utilisez l'opération CreateDeployPipeline.

    Pour ajouter une étape d'interpréteur de commandes au pipeline, utilisez l'opération CreateDeployStage. Pour l'attribut deployStageType, spécifiez la valeur SHELL.