Ajout de ressources non gérées

Ajoutez des ressources existantes à une pile dans le gestionnaire de ressources.

Note

Certaines étapes de ces instructions utilisent l'interface de ligne de commande Terraform; la plupart des étapes utilisent la console Oracle Cloud Infrastructure.
  1. Collectez des informations sur les ressources non gérées que vous voulez ajouter : Notez leurs OCID.

    Les ressources non gérées sont créées en dehors du gestionnaire de ressources.

    Conseil

    Vous pouvez générer une configuration Terraform qui liste toutes les ressources d'un compartiment. Pour obtenir des instructions, voir Création d'une pile à partir d'un compartiment existant.
  2. Collecter les informations sur la pile
    1. Dans la console, accédez à la page de détails de la pile à laquelle vous voulez ajouter les ressources.

      1. Ouvrez le menu de navigation et sélectionnez Services de développement. Sous Gestionnaire de ressources, sélectionnez Piles.
      2. Sous Portée de la liste, sélectionnez un compartiment que vous êtes autorisé à utiliser. La page est mise à jour pour afficher uniquement les ressources de ce compartiment. Si vous ne savez pas quel compartiment utiliser, communiquez avec un administrateur.

      3. Sélectionnez le nom de la pile pour afficher sa page de détails.

    2. Confirmez que les ressources gérées sont à jour : Générez un rapport de détection de dérive.

      1. Allez dans Actions supplémentaires et sélectionnez Exécuter la détection de dérive.

      2. Dans le panneau Exécuter la détection de dérive, sélectionnez Toutes les ressources.

      3. Sélectionnez Exécuter la détection de dérive.

        Une demande de travail est démarrée. Lorsque la demande de travail est terminée, le statut de dérivation s'affiche dans l'onglet informations sur la pile.

      4. Allez dans Plus d'actions et sélectionnez Voir le rapport de détection de dérive.

        Un panneau liste le statut de dérive des ressources spécifiées définies par la pile. Les ressources sont identifiées par des noms de ressource.

      5. Pour voir les détails du statut de dérive d'une ressource, développez la ressource.

        Les propriétés réelles et attendues sont indiquées.

      6. Si des différences entre les propriétés réelles et attendues sont signalées, faites en sorte que vos ressources correspondent aux propriétés de votre configuration Terraform : exécutez une tâche d'application. Dans la page Détails de la pile, sélectionnez Appliquer.

        Vous pouvez également corriger ces différences lors de la modification manuelle de la configuration Terraform ultérieurement.

    3. Téléchargez le fichier de configuration Terraform de la pile : Dans l'onglet informations sur la pile, à droite de la configuration Terraform, sélectionnez Télécharger.

    4. Téléchargez le fichier d'état de la pile :

      1. Allez à la page des détails de la tâche d'application la plus récente : Sélectionnez le lien de la tâche sous Tâches.
      2. Dans la page des détails de la tâche, sélectionnez Télécharger l'état Terraform.
  3. Mettre à jour le fichier d'état à l'aide de l'interface de ligne de commande Terraform
    1. Configurez l'interface de ligne de commande Terraform sur votre machine locale.

      Pour obtenir des instructions, voir Interface de ligne de commande Terraform.

    2. Sur votre ordinateur local, allez à l'interface de ligne de commande Terraform et naviguez jusqu'au répertoire contenant la configuration et le fichier d'état Terraform téléchargés.

    3. Pour chaque ressource non gérée identifiée précédemment, importez le fichier d'état en exécutant la commande terraform import :

      terraform import -state=<path_to_tfstate_file> -var-file="<path_to_credentials_file>" -var-file="<path_to_env_file>" <resource_name> <resource_ocid>

      Exemple :

      terraform import -state=example.tfstate -var-file="credentials.tfvars" -var-file="environments.tfvars" module.operations.oci_identity_compartment.move_compartment ocid1.compartment.oc1..exampleid

      Pour plus d'informations sur cette commande, voir Commande de l'interface de ligne de commande d'importation Terraform.

    4. Actualisez le fichier d'état en exécutant la commande terraform refresh :

      Note

      Pour actualiser une ressource spécifique, utilisez la cible d'actualisation -target=<resource>.

      Pour plus d'informations sur cette commande, voir Commande d'actualisation de l'interface de ligne de commande Terraform.

  4. Mettez à jour manuellement la configuration Terraform téléchargée pour inclure la ressource non gérée identifiée précédemment.

    Si une dérive non résolue reste dans le rapport de détection de dérive, corrigez ces différences dans la mise à jour manuelle.

  5. Mettre à jour la pile
    1. Accédez de nouveau à la page des détails de la pile.

      1. Ouvrez le menu de navigation et sélectionnez Services de développement. Sous Gestionnaire de ressources, sélectionnez Piles.
      2. Sous Portée de la liste, sélectionnez un compartiment que vous êtes autorisé à utiliser. La page est mise à jour pour afficher uniquement les ressources de ce compartiment. Si vous ne savez pas quel compartiment utiliser, communiquez avec un administrateur.

      3. Sélectionnez le nom de la pile pour afficher sa page de détails.

    2. Importez le fichier d'état actualisé dans la pile.

      1. Sélectionnez Actions supplémentaires et Importer l'état.

      2. Dans la boîte de dialogue Importer l'état, ajoutez le fichier d'état Terraform en faisant glisser-déposer vers le contrôle de la boîte de dialogue ou en sélectionnant Parcourir et en naviguant jusqu'à l'emplacement du fichier.

      3. Sélectionnez Importer.

    3. Chargez la configuration Terraform modifiée manuellement dans la pile.

      1. Dans l'onglet Informations sur la pile, à côté de Configuration Terraform, sélectionnez Charger.

      2. Dans la boîte de dialogue Modifier la pile, sous Configuration de la pile, sélectionnez Fichier .Zip et ajoutez votre configuration Terraform révisée.

        Vous pouvez glisser-déposer votre fichier de configuration Terraform .zip dans le contrôle ou sélectionner Parcourir et naviguer jusqu'à l'emplacement du fichier .zip.

      3. Sélectionnez Suivant selon les besoins, puis Enregistrer les modifications.

  6. Confirmer que l'infrastructure est à jour
    1. Sélectionnez Planifier.

    2. Dans la boîte de dialogue Planifier, vérifiez le nom de la tâche de planification et mettez-le à jour au besoin.

    3. Sélectionnez Planifier.

      La nouvelle tâche de planification est indiquée sous Tâches, avec l'état initial Accepté. Le statut passe bientôt à En cours. Une fois le travail terminé, consultez le journal du travail pour confirmer qu'aucune modification n'a été apportée.

      Exemple de journal de travaux signalant aucune modification :

      No changes. Infrastructure is up-to-date.
      This means that Terraform did not detect any differences between your
      configuration and real physical resources that exist. As a result, no
      actions need to be performed. 

    Félicitations! Vous avez ajouté des ressources non gérées précédemment à la pile. Les ressources ajoutées sont maintenant gérées par le gestionnaire de ressources.