Ajout de ressources non gérées

Ajoutez des ressources existantes à une pile dans Resource Manager.

1. Collectez des informations sur les ressources non gérées à ajouter : notez leurs OCID.

   Les ressources non gérées sont créées en dehors de Resource Manager.

   Conseil
   
   Vous pouvez générer une configuration Terraform qui répertorie toutes les ressources d'un compartiment. Pour obtenir des instructions, reportez-vous à Procédure de représentation des ressources par Terraform.
2. Collecter les informations de pile

   1. Dans la console, accédez à la page de détails de la pile à laquelle ajouter les ressources.

      1. Ouvrez le menu de navigation et cliquez sur Services de développeur. Sous Gestionnaire de ressources, cliquez sur Piles.

      2. Sous Portée de la liste, sélectionnez un compartiment dans lequel vous êtes autorisé à travailler. La page est mise à jour et affiche uniquement les ressources contenues dans ce compartiment. Si vous ne savez pas quel compartiment utiliser, contactez un administrateur.

      3. Cliquez sur le nom de la pile pour l'afficher.

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

      1. Accédez à 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. Cliquez sur Exécuter la détection de dérive.

         Une demande de travail est démarrée. Une fois la demande de travail terminée, le statut de dérive apparaît dans l'onglet Informations sur la pile.

      4. Accédez à Actions supplémentaires et sélectionnez Afficher le rapport de détection de dérive.

         Un panneau répertorie l'état 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 afficher les détails du statut de dérive d'une ressource, cliquez sur la flèche pointant vers le bas.

         Les propriétés réelles et attendues sont répertorié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 un travail d'application. Sur la page Détails de la pile, cliquez sur Appliquer.

         Vous pouvez également résoudre ces différences lorsque vous modifiez manuellement la configuration Terraform ultérieurement.

   3. Téléchargez en local le fichier de configuration Terraform de la pile : dans l'onglet Informations sur la pile, à droite de Configuration de Terraform, cliquez sur Télécharger.

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

      1. Accédez à la page de détails du travail d'application le plus récent : cliquez sur le lien du travail sous Travaux.
      2. Sur la page des détails du travail, cliquez sur Télécharger l'état de Terraform en local.
3. Mise à jour du fichier d'état à l'aide de l'interface de ligne de commande Terraform

   1. Configurez l'interface de ligne de commande Terraform sur votre ordinateur local.

      Pour obtenir des instructions, reportez-vous à l'interface de ligne de commande Terraform.

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

   3. Pour chaque ressource non gérée précédemment identifiée, 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, reportez-vous à Commande d'interface de ligne de commande d'import Terraform.

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

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

      Pour plus d'informations sur cette commande, reportez-vous à Commande de l'interface de ligne de commande d'actualisation Terraform.

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

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

5. Mettre à jour la pile

   1. Accédez à nouveau à la page de détails de la pile.

      1. Ouvrez le menu de navigation et cliquez sur Services de développeur. Sous Gestionnaire de ressources, cliquez sur Piles.

      2. Sous Portée de la liste, sélectionnez un compartiment dans lequel vous êtes autorisé à travailler. La page est mise à jour et affiche uniquement les ressources contenues dans ce compartiment. Si vous ne savez pas quel compartiment utiliser, contactez un administrateur.

      3. Cliquez sur le nom de la pile pour l'afficher.

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

      1. Accédez à Actions supplémentaires, puis sélectionnez Etat d'importation.

      2. Dans la boîte de dialogue Etat d'import, ajoutez votre fichier d'état Terraform, en le faisant glisser dans la commande de la boîte de dialogue ou en cliquant sur Parcourir et en accédant à l'emplacement du fichier.

      3. Cliquez sur Importer.

   3. Téléchargez la configuration Terraform modifiée manuellement vers la pile.

      1. Dans l'onglet Informations sur la pile, en regard de Configuration de Terraform, cliquez sur Télécharger.

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

         Vous pouvez glisser-déplacer le fichier .zip de configuration Terraform vers le contrôle ou cliquer sur Parcourir et accéder à l'emplacement du fichier .zip.

      3. Cliquez sur Suivant si nécessaire, puis sur Enregistrer les modifications.

6. Vérifiez que l'infrastructure est à jour

   1. Cliquez sur Planifier.

   2. Dans la boîte de dialogue Planifier, vérifiez le travail de planification Nom et modifiez-le si nécessaire.

   3. Cliquez sur Planifier.

      Le nouveau travail de planification apparaît sous Travaux, avec l'état initial Accepté. Rapidement, le statut devient En cours. Une fois le travail terminé, consultez le journal des travaux pour confirmer l'absence de modifications.

      Exemple de journal de travaux signalant l'absence de modifications :

      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 désormais gérées par Resource Manager.