Création d'un travail d'importation

Créez un travail d'import dans Resource Manager afin d'importer des fichiers d'état pour les ressources existantes déjà gérées par Terraform. Un travail d'import définit le fichier d'état Terraform fourni en tant qu'état en cours de la pile.

Par exemple, utilisez un travail d'import pour migrer un environnement Terraform local vers Resource Manager.

    1. Sur la page de liste Piles, sélectionnez la pile à utiliser. Si vous avez besoin d'aide pour rechercher la page de liste ou la pile, reportez-vous à Liste des piles.
    2. Accédez à Actions supplémentaires et sélectionnez Importer l'état.
    3. (Facultatif) Dans le panneau Importer, modifiez le nom par défaut du travail. Evitez de saisir des informations confidentielles.
    4. Pour Sélectionner un fichier d'état de Terraform à télécharger, ajoutez le fichier d'état de Terraform à importer dans la pile.
      Vous pouvez faire glisser le fichier dans la commande ou sélectionner Browse et accéder à 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 Mettre à niveau les versions de fournisseur.
      La pile doit être de version Terraform 0.14 ou ultérieure. Si elle 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 été modifiées 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.
    6. (Facultatif) Ajoutez des balises au travail : sélectionnez Afficher les options avancées pour afficher les options de balisage.
      Si vous disposez des droits d'accès nécessaires pour créer une ressource, vous pouvez également lui appliquer des balises à forme libre. Pour appliquer une balise defined, vous devez être autorisé à utiliser la balise namespace. Pour plus d'informations sur le balisage, reportez-vous à Balises de ressource. Si vous n'êtes pas sûr d'appliquer des balises, ignorez cette option ou demandez à un administrateur. Vous pouvez appliquer des balises ultérieurement.
    7. Sélectionnez Importer.

    Le travail d'importation est créé. Le nouveau travail apparaît sous Travaux.

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

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

    Afin d'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 d'import.

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

Suite

Après avoir exécuté un travail d'import, obtenez les détails du travail pour vérifier son statut. Vous pouvez éventuellement visualiser le fichier d'état Terraform et les journaux.

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é. En fonction de la complexité du travail, l'opération peut prendre un certain temps. Pendant l'exécution du travail ou une fois celui-ci 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), sélectionnez le nom du travail pour afficher la page Détails du travail, puis sélectionnez Afficher l'état sous Ressources. Sélectionnez éventuellement Afficher les modifications apportées à cette version.

Pour visualiser les journaux du travail, sélectionnez le travail pour ouvrir sa page de détails, puis sélectionnez Journaux sous Ressources.