Documentation sur Oracle Cloud Infrastructure

Déploiement vers un groupe d'instances

Créez un pipeline pour déployer des artefacts vers des groupes d'instances.

Préalables

Les préalables au déploiement d'artefacts dans un groupe d'instances sont les suivants :

  • Vous disposez d'un pipeline de déploiement, d'un environnement de groupe d'instances vers lequel effectuer le déploiement et d'artefacts. Les artefacts peuvent être insérés ou se trouver dans le registre d'artefacts.

    Le déploiement DevOps prend en charge le déploiement de plusieurs artefacts au cours d'une étape. Pour le déploiement vers un groupe d'instances, un fichier de configuration de déploiement définit les commandes et exécute les étapes de téléchargement de l'artefact de l'ensemble d'applications à partir du registre d'artefacts spécifié et le place dans le système de fichiers de l'instance de calcul cible. Voir Fichier de configuration de déploiement.

  • Le plugiciel de commande d'exécution d'instance de calcul doit être activé sur l'instance et il doit être en cours d'exécution. Pour activer ce plugiciel, procédez de la façon suivante :
    1. Dans la console, ouvrez le menu de navigation et cliquez sur Calcul. Sous Calcul, cliquez sur Instances.
    2. Sélectionnez une instance du groupe vers laquelle effectuer le déploiement.
      Note

      DevOps prend uniquement en charge les déploiements de groupe d'instances vers Oracle Linux et CentOS.
    3. Cliquez sur l'onglet Agent Oracle Cloud.

    4. Pour le plugiciel de commande d'exécution d'instance de calcul, basculez le commutateur Activer le plugiciel sur Activé.

      La prise en compte de la modification peut prendre jusqu'à 10 minutes.

      Attention

      Les fonctionnalités qui dépendent du plugiciel, telles que la surveillance, l'ajustement automatique, le déploiement ou la gestion du système d'exploitation, ne fonctionnent pas lorsque le plugiciel est désactivé.
      Attention

      Pour déployer des applications à l'aide du plugiciel de commande d'exécution d'instance de calcul, vous devez configurer et tenir à jour des politiques appliquant le principe de moindre privilège. Pour plus d'informations, voir Exécution de commandes dans une instance.

      Pour plus d'informations sur la gestion des plugiciels, voir Gestion des plugiciels avec Oracle Cloud Agent. Pour le dépannage, voir Dépannage d'Oracle Cloud Agent.

  • Vous devez être autorisé à exécuter des commandes sur l'instance. Voir la politique de gestion des identités et des accès (GIA) requise.

Pour créer des groupes dynamiques et des politiques pour les pipelines de déploiement, voir Politiques de pipeline de déploiement. Pour plus de détails, voir Politiques GIA pour DevOps.

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 déploiement.
    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 Déployer un groupe d'instances, puis cliquez sur Suivant.
    5. Entrez un nom et une description pour l'étape. L'ajout d'une description est facultatif.
    6. Pour Environnement, sélectionnez un groupe d'instances existant.
    7. Cliquez sur Sélectionner l'artefact et sélectionnez les artefacts de configuration de déploiement de groupe d'instances disponibles à déployer.

      Le fichier de configuration de déploiement définit les artefacts à télécharger dans l'instance et l'emplacement où ils doivent être copiés. Pour plus d'informations, voir Fichier de configuration de déploiement.

    8. (Facultatif) Cliquez sur Sélectionner un artefact pour ajouter d'autres artefacts, qui sont téléchargés dans les instances de calcul pendant le déploiement.

      Ces artefacts supplémentaires ne doivent pas être insérés.

    9. (Facultatif) Cliquez sur Sélectionner un équilibreur de charge. L'équilibreur de charge doit être disponible dans la console.
      1. Sélectionnez la région et le compartiment de l'équilibreur de charge.
      2. Sélectionnez un équilibreur de charge dans la liste.

      L'équilibreur de charge répartit le trafic de production lors du déploiement. Pour plus d'informations, voir Gestion de l'équilibreur de charge.

    10. Pour ajouter un module d'écoute à l'équilibreur de charge, cliquez sur Sélectionner un module d'écoute.

      Les modules d'écoute vérifient le trafic entrant sur l'adresse IP de l'équilibreur de charge. Pour plus d'informations, voir Gestion des modules d'écoute.

    11. Pour revenir automatiquement à la dernière version réussie en cas d'échec de la validation, sélectionnez Oui. Pour plus d'informations, voir Repositionnement d'un déploiement.
    12. La politique de déploiement contrôle le taux et le comportement du déploiement d'instances dans l'environnement cible. Sélectionnez une des options suivantes :
      • Déploiement par pourcentage : Entrez une valeur en pourcentage comprise entre 1 et 100. Cette valeur contrôle le pourcentage maximal d'instances qui sont déployées ou qui ne sont pas en cours d'exécution à un moment donné.
      • Déploiement par nombre : Entrez une valeur numérique. Cette valeur contrôle le nombre maximal d'instances qui sont déployées ou qui ne sont pas en cours d'exécution à un moment donné.
    13. (Facultatif) Pour Durée entre deux lots, entrez une durée en secondes.
    14. (Facultatif) La politique en cas d'échec définit les critères d'échec d'une étape. Elle peut être définie en fonction du nombre d'hôtes de calcul défaillants dans un groupe d'instances. Sélectionnez une des options suivantes :
      • Aucune
      • Échec par pourcentage : Entrez une valeur en pourcentage comprise entre 1 et 100. Cette valeur définit le pourcentage d'hôtes de calcul dont la défaillance entraîne l'échec de l'étape.
      • Échec par nombre : Entrez une valeur numérique. Cette valeur définit le nombre d'hôtes de calcul dont la défaillance entraîne l'échec de l'étape.
    15. (Facultatif) Pour ajouter des marqueurs au pipeline, 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.

    16. 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.

    Vous pouvez ajouter 100 étapes parallèles au pipeline de déploiement, mais le plugiciel d'exécution de commande ne prend en charge que cinq commandes sur une instance. Vous devez donc disposer d'un nombre suffisant d'instances pour exécuter 100 déploiements de groupe d'instances en parallèle.

    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 une étape de groupe d'instances, exécutez la commande create-deploy-compute-instance-group-stage :

    oci devops deploy-stage create-deploy-compute-instance-group-stage

    Paramètres requis pour la commande create-deploy-compute-instance-group-stage :

    • --compute-instance-group-environment-id
    • --deployment-spec-artifact-id
    • --rollout-policy
    • --pipeline-id
    • --stage-predecessor-collection

    Pour afficher toutes les commandes pour deploy-stage :

    oci devops deploy-stage -h

    Pour obtenir de l'aide sur la commande create-deploy-compute-instance-group-stage :

    oci devops deploy-stage create-deploy-compute-instance-group-stage -h

  • Pour créer une étape de déploiement de groupe d'instances pour le pipeline, utilisez l'opération CreateDeployStage. Pour l'attribut deployStageType, spécifiez la valeur COMPUTE_INSTANCE_GROUP_ROLLING_DEPLOYMENT.