Créer un travail d'annulation d'application des modifications

Créez un travail d'annulation d'application dans Resource Manager.

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

Nous vous recommandons de créer (exécuter) un travail d'annulation de plan (générer un plan d'exécution) avant d'exécuter un travail d'annulation d'application à l'aide du flux suivant.

  1. Identifiez le travail d'application des modifications sur lequel vous voulez revenir.

    Le travail que vous souhaitez restaurer est également appelé "travail cible".

  2. Créez un travail d'annulation de plan pour le travail cible.

  3. Vérifiez que le travail d'annulation de plan a réussi.

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

  5. Créez un travail d'annulation d'application à l'aide du plan d'exécution généré (executionPlanRollbackStrategy).

    Les instructions figurent sur cette page.

    1. Ouvrez le menu de navigation et cliquez sur Services de développeur. Sous Gestionnaire de ressources, cliquez sur Piles.
    2. Sur la page Piles, sélectionnez le compartiment contenant la pile souhaitée.
    3. Cliquez sur le nom de la pile souhaitée.
    4. Sur la page Détails de la pile, dans la liste Travaux, recherchez le travail à utiliser pour créer un travail d'annulation d'application.
      Vous pouvez choisir un travail d'annulation de plan (recommandé) ou un travail d'application.
    5. For the job you want, click the Actions menu (Menu Actions) and then select Rollback.
      Le panneau Annuler (rollback) s'ouvre et affiche l'OCID et le nom du travail sélectionné. La stratégie d'annulation de plan d'exécution est automatiquement sélectionnée en fonction du travail sélectionné que vous utilisez pour le travail d'annulation d'application : Utiliser le plan d'exécution du travail d'annulation de plan pour un travail d'annulation de plan et Approuver automatiquement pour un travail d'application. Pour plus d'informations sur l'approbation automatique, reportez-vous à Option d'approbation automatique pour la commande Terraform Apply.
    6. Pour Type de travail d'annulation, sélectionnez Appliquer afin de créer un travail d'annulation d'application.
    7. (Facultatif) Modifiez le nom par défaut du travail d'annulation. Evitez de saisir des informations confidentielles.
    8. Pour générer le contenu de journal détaillé pour le débogage, cliquez sur Afficher les options avancées et sélectionnez le niveau de journalisation souhaité dans Niveau de journalisation détaillé.
      Pour plus d'informations, reportez-vous à Débogage de Terraform.
    9. Pour ajuster le nombre maximal d'opérations simultanées lorsque Terraform parcourt le graphique, cliquez sur Afficher les options avancées et modifiez la valeur de Nombre maximal d'opérations parallèles. (Valeur par défaut : 10.) Utilisez cette option pour accélérer le travail.
      Remarque

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

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

      Remarque

      L'actualisation de l'état peut affecter les performances. Si la configuration inclut plusieurs ressources, envisagez de ne pas utiliser cette option.
    11. (Facultatif) Cliquez sur Afficher les options avancées et affectez des balises au travail.
      • Espace de noms de balise : pour ajouter une balise définie, sélectionnez un espace de noms existant. Pour ajouter une balise free-from, laissez la valeur vide.
      • Touche de balise : pour ajouter une balise définie, sélectionnez une clé de balise existante. Pour ajouter une balise à format libre, saisissez le nom de clé souhaité.
      • Valeur de balise : saisissez la valeur de balise souhaitée.
      • Ajouter une balise : cliquez sur cette option pour ajouter une autre balise.
    12. Cliquez sur OK.

    Le travail d'annulation d'application est créé. Le nouveau travail apparaît sous Tâches.

  • Utilisez la commande oci resource-manager job create-apply-rollback-job et les paramètres requis pour exécuter un travail d'annulation d'application.

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

    Pour obtenir la liste complète des paramètres et des valeurs pour les commandes d'interface de ligne de commande, reportez-vous à Référence de ligne de commande pour Resource Manager.

  • Utilisez l'opération CreateJob pour créer un travail d'annulation d'application.

    Pour obtenir des exemples de détails sur un travail d'annulation d'application, reportez-vous à ApplyRollbackJobOperationDetails.

Etapes suivantes

Selon le nombre et le type de ressources indiqués, un travail d'annulation d'application peut prendre un certain temps.

Après avoir exécuté un travail d'annulation d'application, obtenez les détails du travail pour vérifier son statut. Vous pouvez éventuellement afficher le fichier d'état Terraform, visualiser les journaux et confirmer l'existence de ressources provisionnées.

Surveillez le statut du travail (état de cycle de vie) en obtenant les détails du travail. Succès (SUCCEEDED) indique que le travail est terminé. Selon la complexité du travail, l'opération peut prendre un certain temps. Lorsque le travail est exécuté ou une fois terminé, vous pouvez obtenir le contenu des journaux de travail.

Pour visualiser le fichier d'état Terraform (qui montre l'état de vos ressources après l'exécution du travail), cliquez sur le nom du travail pour afficher la page Détails du travail, puis cliquez sur Afficher l'état sous Ressources. Sélectionnez éventuellement Afficher les modifications apportées à cette version.

Pour visualiser les journaux du travail, cliquez sur le nom du travail afin d'ouvrir la page Détails du travail, puis cliquez sur Journaux sous Ressources.

Pour vérifier que les ressources ont bien été provisionnées, inspectez les ressources dans le compartiment.