Documentation Oracle Cloud Infrastructure

Création d'un travail d'import

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 comme l'état en cours de la pile.

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

    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, accédez à Actions supplémentaires et sélectionnez Etat d'import.
    5. (Facultatif) Dans le panneau Importer, modifiez le nom par défaut du travail. Evitez de saisir des informations confidentielles.
    6. 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 le contrôle ou cliquer sur Parcourir et rechercher l'emplacement du fichier.
    7. 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.
    8. (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.
    9. Cliquez sur Importer.

    Le travail d'importation a été créé. Le nouveau travail apparaît sous Tâches.

  • 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>

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

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

Etapes suivantes

Après avoir exécuté un travail d'import, obtenez les détails du travail pour vérifier son statut. Vous pouvez éventuellement afficher 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é. Selon la complexité du travail, l'opération peut prendre un certain temps. Lorsque le travail est exécuté ou une fois 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), cliquez sur le nom du travail pour afficher la page Détails du travail, puis cliquez sur Afficher l'état sous Ressources. Sélectionnez éventuellement Afficher les modifications apportées à cette version.

Pour visualiser les journaux du travail, cliquez sur le nom du travail afin d'ouvrir la page Détails du travail, puis cliquez sur Journaux sous Ressources.