Documentation sur Oracle Cloud Infrastructure

Création d'un travail de planification

Créez une tâche de planification dans le gestionnaire de ressources.

La création (exécution) d'une tâche de planification analyse votre configuration Terraform et la convertit en plan d'exécution pour la pile associée. Le plan d'exécution indique la séquence des actions planifiées pour provisionner les ressources Oracle Cloud Infrastructure, notamment les actions attendues après l'exécution d'une tâche d'application. Nous recommandons d'exécuter une tâche de planification (génération d'un plan d'exécution) avant d'exécuter une tâche d'application. Il est transmis à la tâche d'application, qui exécute ensuite les instructions.

Pour les configurations stockées dans un système de contrôle de code source, comme GitHub ou GitLab, la tâche utilise la validation la plus récente.

    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 page des détails de la pile, sélectionnez Planifier.
    3. (Facultatif) Dans le panneau Planifier, modifiez le nom par défaut de la tâche. Évitez d'entrer des informations confidentielles.
    4. Pour extraire les dernières versions disponibles à partir de la source configurée des fournisseurs Terraform, sélectionnez Afficher les options avancées et sélectionnez Mettre à niveau les versions de fournisseur.
      La pile doit être Terraform 0.14 ou une version ultérieure et, si la pile est plus ancienne, elle doit être mise à niveau vers utiliser le registre Terraform. Cette étape est requise si les versions de fournisseur dans la configuration Terraform ont changé depuis la dernière exécution d'une tâche 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.
    5. 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.
    6. 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.
    7. 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.
    8. (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.
    9. Sélectionnez Planifier.

    La tâche de plan est créée. La nouvelle tâche est indiquée sous Tâches.

  • Utilisez la commande oci resource-manager job create-plan-job et les paramètres requis pour exécuter une tâche de planification.

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

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

    Pour un exemple de la partie operation de la demande, voir CreatePlanJobOperationDetails.