Déploiement vers un groupe d'instances

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

Prérequis

Les prérequis pour déployer des artefacts vers un groupe d'instances sont les suivants :

  • Ayez un pipeline de déploiement, un environnement de groupe d'instances vers lequel effectuer le déploiement et des artefacts. Les artefacts peuvent être définis de façon incorporée ou se trouver dans Artifact Registry.

    Le déploiement DevOps prend en charge le déploiement de plusieurs artefacts dans une phase. Pour le déploiement de groupe d'instances, un fichier de configuration de déploiement définit les commandes et exécute les étapes permettant de télécharger l'artefact de package d'application à partir du registre d'artefacts indiqué et de le placer dans le système de fichiers de l'instance de calcul cible. Reportez-vous à Fichier de configuration de déploiement.

  • Le module d'extension Exécution de commandes sur les instances de calcul doit être activé sur l'instance et doit être en cours d'exécution. Pour activer le module d'extension, procédez comme suit :
    1. Dans la console, ouvrez le menu de navigation et cliquez sur Compute. Sous Compute, cliquez sur Instances.
    2. Sélectionnez une instance dans le groupe d'instances vers lequel effectuer le déploiement.
      Remarque

      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 module d'extension Exécution de commandes sur les instances de calcul, basculez le bouton Activer le module d'extension sur Activé.

      L'application de la modification prend jusqu'à 10 minutes.

      Attention

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

      Pour déployer des applications à l'aide du module d'extension Exécution de commandes sur les instances de calcul, vous devez configurer et gérer de façon appropriée les stratégies de moindre privilège. Pour plus d'informations, reportez-vous à Exécution de commandes sur une instance.

      Pour plus d'informations sur la gestion des modules d'extension, reportez-vous à Gestion des modules d'extension avec l'agent Oracle Cloud. Pour la résolution des problèmes, reportez-vous à Dépannage de l'agent Oracle Cloud.

  • Vous devez être autorisé à exécuter des commandes sur l'instance. Reportez-vous à la stratégie Identity and Access Management (IAM) requise.

Afin de créer des groupes dynamiques et des stratégies pour les pipelines de déploiement, reportez-vous à Stratégies de pipeline de déploiement. Pour plus de détails, reportez-vous à Stratégies IAM DevOps.

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. Sélectionnez un projet et un pipeline de déploiement.
    3. Pour ajouter une phase au pipeline, cliquez sur l'icône + et sélectionnez Ajouter une phase.
    4. Pour le type de phase, sélectionnez Déployer le groupe d'instances, puis cliquez sur Suivant.
    5. Entrez le nom et la description de la phase. L'ajout d'une description est facultatif.
    6. Pour Environnement, sélectionnez un groupe d'instances existant.
    7. Cliquez sur Sélectionner un artefact et sélectionnez les artefacts de configuration du déploiement de groupe d'instances disponibles pour le déploiement.

      Le fichier de configuration de déploiement définit les artefacts à télécharger vers l'instance et l'emplacement vers lequel les artefacts doivent être copiés. Pour plus d'informations, reportez-vous à Fichier de configuration de déploiement.

    8. (Facultatif) Cliquez sur Sélectionner un artefact pour ajouter d'autres artefacts téléchargés vers les instances de calcul lors du déploiement.

      Ces artefacts supplémentaires ne doivent pas être définis de façon incorporée.

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

      L'équilibreur de charge distribue le trafic de production lors du déploiement. Pour plus d'informations, reportez-vous à Gestion des équilibreurs de charge.

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

      Les processus d'écoute recherchent le trafic entrant sur l'adresse IP de l'équilibreur de charge. Pour plus d'informations, reportez-vous à Gestion des processus d'écoute.

    11. Pour revenir automatiquement à la dernière version ayant réussi si la validation échoue, sélectionnez Oui. Pour plus d'informations, reportez-vous à Annulation d'un déploiement.
    12. La stratégie de déploiement détermine le rythme et le comportement du déploiement de l'instance dans l'environnement cible. Sélectionnez l'une des options suivantes :
      • Déploiement par pourcentage : saisissez une valeur de pourcentage comprise entre 1 et 100. Cette valeur détermine le pourcentage maximal d'instances qui sont déployées, ou qui ne sont pas exécutées, simultanément.
      • Déploiement par nombre : saisissez une valeur numérique. Cette valeur détermine le nombre maximal d'instances qui sont déployées, ou qui ne sont pas exécutées, simultanément.
    13. (Facultatif) Pour Délai entre les batches, saisissez une durée en secondes.
    14. (Facultatif) La stratégie d'échec définit les critères d'échec d'une phase. Elle peut être définie en fonction du nombre d'hôtes de calcul en échec dans un groupe d'instances. Sélectionnez l'une des options suivantes :
      • Aucune.
      • Echec par pourcentage : saisissez une valeur de pourcentage comprise entre 1 et 100. Cette valeur définit le pourcentage d'hôtes de calcul en échec qui entraîne l'échec de la phase.
      • Echec par nombre : saisissez une valeur numérique. Cette valeur définit le nombre d'hôtes de calcul en échec qui entraîne l'échec de la phase.
    15. (Facultatif) Pour ajouter des balises au pipeline, cliquez sur Afficher les options de balisage. Le balisage est un système de métadonnées permettant d'organiser et de suivre les ressources dans la location.

      Si vous êtes autorisé à créer une ressource, vous disposez également des droits d'accès nécessaires pour lui ajouter des balises à format libre.

      Pour ajouter une balise définie, vous devez disposer des droits d'accès permettant d'utiliser l'espace de noms de balise.

      Pour plus d'informations, reportez-vous à Balises de ressource

    16. Pour ajouter la phase au pipeline, cliquez sur Ajouter.

      Un aperçu de phase fournit un cliché de la configuration.

    Ajoutez d'autres phases au pipeline de façon séquentielle ou en parallèle, si nécessaire. Pour déployer la sortie de build vers l'environnement cible, exécutez le pipeline de déploiement.

    Vous pouvez ajouter 100 phases parallèles au pipeline de déploiement, mais le module d'extension Exécuter la commande ne prend en charge que cinq commandes sur une instance. Vous devez donc disposer de suffisamment d'instances pour exécuter 100 déploiements de groupe d'instances parallèles.

    Pour déclencher automatiquement un déploiement à partir du pipeline de build, vous pouvez ajouter une étape de déclenchement de déploiement au pipeline de build.

  • Pour créer une phase 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

    Procédure d'obtention de toutes les commandes pour deploy-stage :

    oci devops deploy-stage -h

    Pour obtenir l'aide relative à la commande create-deploy-compute-instance-group-stage, exécutez la commande suivante :

    oci devops deploy-stage create-deploy-compute-instance-group-stage -h
  • Afin de créer une phase de déploiement de groupe d'instances pour le pipeline, utilisez l'opération CreateDeployStage. Pour l'attribut deployStageType, indiquez la valeur COMPUTE_INSTANCE_GROUP_ROLLING_DEPLOYMENT.