Documentation sur Oracle Cloud Infrastructure

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

Créez une tâche d'importation dans le gestionnaire de ressources pour importer des fichiers d'état pour les ressources existantes déjà gérées par Terraform. Une tâche d'importation définit le fichier d'état Terraform fourni comme état courant de la pile.

Par exemple, utilisez une tâche d'importation pour migrer un environnement Terraform local vers le gestionnaire de ressources.

    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. Sélectionnez Actions supplémentaires et Importer l'état.
    3. (Facultatif) Dans le panneau Importer, modifiez le nom par défaut de la tâche. Évitez d'entrer des informations confidentielles.
    4. Pour Sélectionner un fichier d'état Terraform à charger, ajoutez le fichier d'état Terraform que vous voulez importer dans la pile.
      Vous pouvez faire glisser le fichier dans le contrôle ou sélectionner Parcourir et naviguer jusqu'à l'emplacement du fichier.
    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. (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.
    7. Sélectionnez Importer.

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

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

    oci resource-manager job create-import-tf-state-job --stack-id <stack_OCID> --tf-state-file <job_details>

    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 d'importation.

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

Étape suivante

Après avoir exécuté une tâche d'importation, obtenez les détails de la tâche pour vérifier son statut. Vous pouvez éventuellement voir le fichier d'état Terraform et les journaux.

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.