Documentation Oracle Cloud Infrastructure

Créer un travail de plan

Créez un travail de plan dans Resource Manager.

La création (exécution) d'un travail de plan analyse votre configuration Terraform et la convertit en plan d'exécution pour la pile associée. Le plan d'exécution répertorie la séquence d'actions spécifiques planifiées pour provisionner vos ressources Oracle Cloud Infrastructure, y compris les actions attendues après l'exécution d'un travail d'application. Nous vous recommandons d'exécuter un travail de plan (génération d'un plan d'exécution) avant d'exécuter un travail d'application. Le plan d'exécution est transmis au travail d'application, qui exécute ensuite les instructions.

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.

    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 Plan.
    5. (Facultatif) Dans le panneau Planifier, modifiez le nom par défaut du travail. Evitez de saisir des informations confidentielles.
    6. 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.
    7. 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.
    8. 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.
    9. 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.
    10. (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.
    11. Cliquez sur Planifier.

    Le travail de plan est créé. Le nouveau travail apparaît sous Tâches.

  • Utilisez la commande oci resource-manager job create-plan-job et les paramètres requis pour exécuter un travail de plan.

    oci resource-manager job create-plan-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.

  • Utilisez l'opération CreateJob pour créer un travail de plan.

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