Documentation sur Oracle Cloud Infrastructure

Création d'une tâche de repositionnement d'application

Créez une tâche de repositionnement d'application dans le gestionnaire de ressources.

Lorsque vous créez (exécutez) une tâche de repositionnement d'application pour une pile, Terraform provisionne les ressources et exécute l'action définie dans la configuration Terraform de la tâche cible, en appliquant le plan d'exécution à la pile associée. Cette tâche repositionne vos ressources Oracle Cloud Infrastructure à un état précédent.

Nous vous recommandons de créer (exécuter) une tâche de repositionnement de plan (générer un plan d'exécution) avant d'exécuter une tâche de repositionnement d'application, à l'aide du flux suivant.

  1. Identifiez la tâche d'application réussie vers laquelle vous voulez revenir.

    Le travail vers lequel vous souhaitez revenir en arrière est également appelé "travail cible".

  2. Créez une tâche de repositionnement de plan pour la tâche cible.

  3. Vérifiez que la tâche de repositionnement du plan a réussi.

  4. Vérifiez que le plan d'exécution généré répond aux attentes.

  5. Créez une tâche d'annulation d'application à l'aide du plan d'exécution généré (executionPlanRollbackStrategy).

    Les instructions sont sur cette page.

    1. Dans la page de liste Piles, sélectionnez la pile avec laquelle vous voulez travailler. Si vous avez besoin d'aide pour trouver la page de liste ou la pile, voir Liste des piles.
    2. Dans la liste Tâches, recherchez la tâche à utiliser pour créer une tâche de repositionnement d'application.
      Vous pouvez sélectionner une tâche de plan de repositionnement (recommandée) ou une tâche d'application.
    3. Dans le menu Actions (trois points) de la tâche, sélectionnez Repositionner.
      Le panneau Repositionner s'ouvre et affiche l'OCID et le nom de la tâche sélectionnée. La stratégie de repositionnement du plan d'exécution est automatiquement sélectionnée en fonction de la tâche sélectionnée que vous utilisez pour la tâche de repositionnement d'application : Utiliser le plan d'exécution à partir de la tâche de repositionnement du plan pour une tâche de repositionnement du plan et Approuver automatiquement pour une tâche d'application. Pour plus d'informations sur l'approbation automatique, voir Option d'approbation automatique pour la commande d'application Terraform
    4. Pour Type de tâche de repositionnement, sélectionnez Appliquer pour créer une tâche de repositionnement d'application.
    5. (Facultatif) Modifiez le nom par défaut de la tâche d'annulation. Évitez d'entrer des informations confidentielles.
    6. Pour générer un contenu de journal détaillé pour le débogage, sélectionnez Afficher les options avancées et sélectionnez le niveau de journal souhaité dans Niveau de journal détaillé.
      Pour plus d'informations, voir Débogage de Terraform.
    7. Pour ajuster le nombre maximal d'opérations concurrentes au fur et à mesure que Terraform parcourt le graphique, sélectionnez Afficher les options avancées et modifiez la valeur de Nombre maximal d'opérations parallèles. (Par défaut : 10.) Utilisez cette option pour accélérer la tâche.
      Note

      Une valeur élevée peut entraîner la limitation des ressources. Prenons l'exemple d'une configuration Terraform qui définit des centaines d'instances de calcul. Une tâche Appliquer tente de créer autant d'instances que possible en même temps. Dans cet exemple, une valeur de 100 peut entraîner une limitation par le service de calcul.
    8. Pour extraire le dernier état avant d'exécuter la tâche, sélectionnez Afficher les options avancées et sélectionnez Actualiser les états des ressources avant de rechercher les différences.

      Utilisez cette option pour actualiser d'abord l'état. Par exemple, envisagez d'utiliser cette option avec une tâche Appliquer que vous prévoyez d'exécuter sur une infrastructure mise à jour manuellement (existante).

      Note

      L'actualisation de l'état peut avoir une incidence sur la performance. Si la configuration inclut plusieurs ressources, envisagez de ne pas utiliser cette option.
    9. (Facultatif) Ajoutez un ou plusieurs marqueurs à la tâche : Sélectionnez Afficher les options avancées pour afficher les options de marquage.
      Si vous avez l'autorisation de créer une ressource, vous avez également l'autorisation d'appliquer des marqueurs à structure libre à cette ressource. Pour appliquer un marqueur défini, vous devez être autorisé à utiliser l'espace de noms de marqueur. Pour plus d'informations sur le marquage, voir Marqueurs de ressource. Si vous ne savez pas si vous devez appliquer des marqueurs, ignorez cette option ou demandez à un administrateur. Vous pouvez appliquer des marqueurs plus tard.
    10. Sélectionnez OK.

    La tâche de repositionnement d'application est créée. La nouvelle tâche est indiquée sous Tâches.

  • Utilisez la commande oci resource-manager job create-apply-rollback-job et les paramètres requis pour exécuter une tâche de repositionnement d'application.

    oci resource-manager job create-apply-rollback-job --stack-id <stack_OCID> --execution-plan-rollback-strategy <source_of_execution_plan>

    Pour la liste complète des paramètres et des valeurs des commandes de l'interface de ligne de commande, voir Informations de référence sur la ligne de commande pour le gestionnaire de ressources.

  • Utilisez l'opération CreateJob pour créer une tâche de repositionnement d'application.

    Pour des exemples de détails sur une tâche de repositionnement d'application, voir ApplyRollbackJobOperationDetails.

Étape suivante

La durée d'une tâche dépend du nombre et du type de ressources spécifiées.

Après avoir exécuté une tâche de repositionnement d'application, obtenez les détails de la tâche pour vérifier son statut. Vous pouvez éventuellement voir le fichier d'état Terraform, voir les journaux et vérifier l'existence de ressources provisionnées.

Surveillez le statut de la tâche (état du cycle de vie) en obtenant les détails de la tâche. Réussite (SUCCEEDED) indique que la tâche est terminée. Selon la complexité de la tâche, l'opération peut prendre un certain temps. Pendant l'exécution de la tâche ou une fois celle-ci terminée, vous pouvez obtenir le contenu des journaux de tâche.

Pour voir le fichier d'état Terraform (affiche l'état des ressources après l'exécution de la tâche), sélectionnez le nom de la tâche à afficher dans la page Détails de la tâche, puis Voir l'état sous ressources. Facultativement, sélectionnez Afficher les modifications dans cette version.

Pour voir les journaux de la tâche, sélectionnez la tâche pour ouvrir sa page de détails, puis sélectionnez Journaux sous Ressources.

Pour vérifier l'existence des ressources nouvellement provisionnées, inspectez les ressources dans le compartiment.