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

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

Lorsque vous créez (exécutez) une tâche 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 recommandons d'exécuter une tâche de planification (générer un plan d'exécution) avant d'exécuter une tâche d'application.

Pour une présentation à l'aide de l'interface de ligne de commande pour le provisionnement en nuage dans un pipeline d'intégration et de développement en continu, voir IaC dans le nuage : Intégration de Terraform et du gestionnaire de ressources dans votre pipeline d'intégration et de développement en continu - Création avec l'interface de ligne de commande OCI.

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. Le temps nécessaire pour terminer une tâche d'application dépend du nombre et du type de ressources en nuage à créer.

    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 Appliquer.
    3. (Facultatif) Dans le panneau Appliquer, modifiez le nom par défaut de la tâche. Évitez d'entrer des informations confidentielles.
    4. (Facultatif) Pour Appliquer la résolution de plan de tâche, sélectionnez le nom de la dernière tâche de plan générée. Seule la dernière tâche de plan générée est disponible. Si aucune tâche de plan n'a été générée pour cette pile, seule la valeur par défaut est disponible (Approuver automatiquement). Pour plus d'informations sur l'approbation automatique, voir Option d'approbation automatique pour la commande Appliquer Terraform.
    5. 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.
    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 Appliquer.

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

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

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

    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 une tâche de 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 une tâche d'application.

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

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