Ajout de ressources non gérées

Ajoutez des ressources existantes à une pile dans Resource Manager.

Remarque

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 à 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 à Création d'une pile à partir d'un compartiment existant.
  2. Collecte des 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 sélectionnez Services de développeur. Sous Gestionnaire de ressources, sélectionnez 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. Sélectionnez le nom de la pile pour afficher sa page de détails.

    2. Vérifiez que les ressources 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. Sélectionnez 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 Visualiser le rapport de détection de dérive.

        Un panneau répertorie 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 afficher les détails du statut de dérive d'une ressource, développez-la.

        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, 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 de Terraform de la pile : dans l'onglet Informations sur la pile, à droite de Configuration de Terraform, sélectionnez 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 : sélectionnez le lien du travail sous Travaux.
      2. Sur la page de détails du travail, sélectionnez Télécharger l'état Terraform en local.
  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 l'ordinateur local.

      Pour obtenir des instructions, reportez-vous à la 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 le fichier de configuration et d'état Terraform téléchargé.

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

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

      Pour plus d'informations sur cette commande, reportez-vous à 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 votre mise à jour manuelle.

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

      1. Ouvrez le menu de navigation et sélectionnez Services de développeur. Sous Gestionnaire de ressources, sélectionnez Piles.
      2. Sous portée de la liste, sélectionnez un compartiment sur lequel vous avez le droit de 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. 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. Accédez à Actions supplémentaires et sélectionnez Importer l'état.

      2. Dans la boîte de dialogue Importer l'état, ajoutez votre fichier d'état Terraform, soit en le faisant glisser dans la commande de la boîte de dialogue, soit en sélectionnant Rechercher et en accédant à l'emplacement du fichier.

      3. Sélectionnez 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, sélectionnez Télécharger vers le serveur.

      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éplacer le fichier .zip de configuration Terraform dans le contrôle ou sélectionner Parcourir et accéder à l'emplacement du fichier .zip.

      3. Sélectionnez Suivant si nécessaire, puis Enregistrer les modifications.

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

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

    3. Sélectionnez Plan.

      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 qu'aucune modification n'a été apportée.

      Exemple de journal de travaux ne 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 désormais gérées par Resource Manager.