Créer un travail d'application des modifications

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

Lorsque vous créez (exécutez) un travail d'application pour une pile, Terraform provisionne les ressources et exécute les actions définies dans votre configuration Terraform, en appliquant le plan d'exécution à la pile associée pour créer (ou modifier) vos ressources Oracle Cloud Infrastructure. Nous vous recommandons d'exécuter un travail de plan (générer un plan d'exécution) avant d'exécuter un travail d'application.

Pour une procédure pas à pas à l'aide de l'interface de ligne de commande pour le provisionnement cloud dans un pipeline d'intégration continue et de déploiement continu, reportez-vous à IaC dans le cloud : intégration de Terraform et de Resource Manager dans votre pipeline d'intégration continue et de déploiement continu - Création à l'aide de l'interface de ligne de commande OCI.

Pour les configurations stockées dans un système de contrôle de code source, tel que GitHub ou GitLab, le travail utilise la validation la plus récente. Le temps requis pour effectuer un travail d'application dépend du nombre de ressources cloud à créer et de leur type.

    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, cliquez sur Appliquer.
    5. (Facultatif) Dans le panneau Appliquer, modifiez le nom par défaut du travail. Evitez de saisir des informations confidentielles.
    6. (Facultatif) Dans Appliquer une résolution de plan de travail, sélectionnez le nom du dernier travail de plan généré. Seul le dernier travail de plan généré est disponible. Si aucun travail de planification n'a été généré pour cette pile, seule la valeur par défaut est disponible (Approuver automatiquement). Pour plus d'informations sur l'approbation automatique, reportez-vous à Option d'approbation automatique pour la commande Terraform Apply.
    7. Pour extraire les dernières versions disponibles à partir de la source configurée des fournisseurs Terraform, cliquez sur Afficher les options avancées et sélectionnez Mettre à niveau les versions des fournisseurs.
      La pile doit être Terraform 0.14 ou une version ultérieure. Si elle est plus ancienne, elle doit être mise à niveau vers l'utilisation du registre Terraform. Cette étape est requise si les versions de fournisseur dans la configuration Terraform ont changé depuis la dernière exécution d'un travail sur la pile. Les fichiers de verrouillage de dépendance sont gérés automatiquement pour les piles nouvelles et mises à jour. Les fournisseurs sont mis à jour dans les contraintes de version de la configuration Terraform.
    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 Appliquer.

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

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

    oci resource-manager job create-apply-job [OPTIONS]

    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.

    Exemples

    Exemple 1 : Référencez un travail de plan.

    oci resource-manager job create-apply-job --execution-plan-strategy <plan_job_ocid> --stack-id <stack_ocid>

    Exemple 2 : Approuver automatiquement (ne pas référencer un travail du plan).

    oci resource-manager job create-apply-job --execution-plan-strategy AUTO_APPROVED --stack-id <stack_ocid>
  • Utilisez l'opération CreateJob pour créer un travail d'application.

    Pour obtenir un exemple de la partie operation de la demande, reportez-vous à CreateApplyJobOperationDetails.

Etapes suivantes

Selon le nombre et le type de ressources indiqués, le travail d'application peut prendre plus ou moins de temps.

Après avoir exécuté un travail 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.