このページは機械翻訳したものです。

リソース検出

リソース・マネージャを使用して、すでにデプロイされているOracle Cloud Infrastructureリソースを検出します。

Oracle Cloud Infrastructure (OCI) Resource Managerを使用して、コンパートメント内のデプロイ済リソースを検索し、それらをTerraform構成ファイルおよび状態ファイルにエクスポートできます。

リソース検出により、手動管理インフラストラクチャからTerraform管理インフラストラクチャへの移行が簡略化されます。1つのコマンドを使用して、既存のコンパートメントのベースライン構成および状態を取得するファイルを生成できます。

重要

リソース検出は移行ツールではありません。リソースをクローニングまたは移行する場合、リソース検出によって生成される構成が開始点になります。これらは変更が必要な場合があります。

Terraformの新しい構成ファイルおよび状態ファイルの一般的なユースケースは次のとおりです:

  • TerraformがHashiCorp Configuration Language (HCL)構文を使用してOracle Cloud Infrastructureリソースを表す方法を学習します。
  • 新しいテナンシまたはリージョンでの既存のインフラストラクチャ・アーキテクチャの複製または再構築。
  • 状態ドリフトの検出。レポートを実行して、Terraform管理リソースの状態が変更され、基本構成と異なっているかどうかを確認します。

コンパートメントから作成されたスタックは、コンパートメント全体のサポートされているリソースすべてを適切なスコープで表します。テナンシのルート・コンパートメントを選択すると、スコープはユーザーやグループなどのテナンシ・レベルになります。非ルート・コンパートメントを選択した場合、スコープはコンピュート・インスタンスなどのコンパートメント・レベルになります。

スタックの作成がサポートされるのは、単一のコンパートメントからのみです。ネストされたコンパートメントからスタックを作成することはできません。

出力ファイルの内容

ノート

リソース検出を使用して取得された一部のサポートされているリソースに属性がありません。詳細は、一部の検出されたリソースでの属性の欠落を参照してください。

リソース検出では、アクティブまたは使用可能な状態のリソースが検出されます。終了したか非アクティブにされたリソースは、通常、生成される構成から除外されます。

デフォルトでは、検出されたリソースのTerraform名は、そのリソースの表示名と同じ名前を共有します(存在する場合)。

リソースの属性には、OCIサービスによって返された値が移入されます。

場合によっては、必須またはオプションの属性がOCIサービスから検出できず、生成されたTerraform構成から除外されることがあります。除外はこのサービスで想定された動作で、これによって特定の機密属性やシークレットの検出を妨げることができます。このような場合、プレースホルダ値が次のようなコメントとともに設定されます:

example-attribute = "<placeholder for missing required attribute>" #Required attribute not found in discovery, placeholder value set to avoid plan failure

欠落している必須属性もライフサイクルignore_changesに追加されます。この追加は、手動管理インフラストラクチャをTerraform管理インフラストラクチャに移行する際のTerraformプランの失敗を回避するために行われます。このようなフィールドに変更を加えても、Terraformプランには反映されません。このようなフィールドを更新する場合は、それらをignore_changesから削除します。

可用性ドメインに依存するリソースが、availability_domain.tfファイルの下に生成されます。これには次が含まれます。

  • oci_core_boot_volume
  • oci_file_storage_file_system
  • oci_file_storage_mount_target
  • oci_file_storage_snapshot

サポートされているリソース

サポートされている各サービスには、1つ以上の検出可能なリソースがあります。

この記事は役に立ちましたか。