メインコンテンツまでスキップ

既存リソースをインポートする

インポートを使うと、FPT Cloud Portal で作成済みのリソースを、削除や再作成をせずに Terraform で管理できるようになります。インポート後は、他のリソースと同様に Terraform でリソースを変更します。また、構成はリソースの現在の状態を正確に記述している必要があります。

前提条件​

  • ✅ セットアップと設定 を完了していること。
  • ✅ import ブロックと構成の自動生成を使用するために、Terraform 1.5 以降であること。
  • ✅ FPT Cloud provider がバージョン 0.3.81 以降であること。Instance と disk のインポートに対応した最初のバージョンです。
  • ✅ リソースが安定した状態にあり、作成、resize、削除などの操作中でないこと。

インポートに対応するリソース​

Resourceインポート ID の形式対応する provider バージョン
fptcloud_instancevpc/<vpc_id>/instance/<instance_id> または vpc/<vpc_id>/instance_name/<instance_name>0.3.81
fptcloud_storagevpc/<vpc_id>/storage/<storage_id>0.3.81
fptcloud_snapshotvpc/<vpc_id>/snapshot/<snapshot_id>0.3.74
fptcloud_ssh_key<ssh_key_id>以下の注意を参照
fptcloud_tagging<tag_id>—

ID は Portal のリソース詳細ページ、または対応する data source で取得します。

警告

fptcloud_ssh_key をインポートした後、provider は FPT Cloud から public_key を読み直しません。対処しない場合、plan は SSH key を forces replacement としてマークします。public_key に既存の key の内容を正確に設定し、resource に lifecycle { ignore_changes = [public_key] } を追加するか、インポートの代わりに data source fptcloud_ssh_key を使用してください。

Instance をインポートする​

  1. import ブロックを含む import.tf ファイルを作成します。

    import {
    to = fptcloud_instance.legacy_app
    id = "vpc/<vpc_id>/instance/<instance_id>"
    }
  2. Terraform に初期構成を自動生成させます。

    terraform plan -generate-config-out=generated.tf
  3. generated.tf を開き、Instance の作成時に使用した値と同じ値を ssh_key または password に入力します。FPT Cloud はこの 2 つの値を返しません。image_name が null の場合は、Instance の作成に使用した image の名前を入力します。

  4. terraform plan を再度実行します。plan に forces replacement の行がなくなった場合にのみ先に進みます。

  5. terraform apply を実行し、インポートの結果を state に保存します。

インポート後の最初の plan では、ssh_key または password が新たに追加されると表示される場合があります。この plan を apply しても値が state に保存されるだけで、Instance は変更されません。

危険

インポートしたばかりのリソースについて forces replacement と表示される plan を apply しないでください。Terraform は実行中の Instance を root disk 上のデータとともに削除します。plan がリソースを再作成しなくなるまで構成を修正してください。

Instance をインポートする際の注意点は次のとおりです。

  • 同じ名前の Instance が複数ある場合は、ID でインポートします。
  • NVMe disk を使用する Instance は、まだインポートに対応していません。

データ disk をインポートする​

import {
to = fptcloud_storage.legacy_data
id = "vpc/<vpc_id>/storage/<storage_id>"
}

インポートできるのは、利用可能な状態にある EXTERNAL タイプの disk のみです。

警告

disk が Instance に接続されている場合は、構成内の instance_id 引数がその Instance を正しく指すようにしてください。instance_id がないと、plan は instance_id が null に変わると表示し、apply すると disk が Instance から 取り外されます。

複数のリソースを一度にインポートする​

同じファイルに複数の import ブロックを宣言し、構成を一度に生成します。

import {
to = fptcloud_instance.web["web-01"]
id = "vpc/<vpc_id>/instance_name/web-01"
}

import {
to = fptcloud_instance.web["web-02"]
id = "vpc/<vpc_id>/instance_name/web-02"
}

fptcloud_instance.web["web-01"] のような形式のアドレスを使う場合は、terraform plan を実行する前に、for_each = toset(["web-01", "web-02"]) を指定した resource fptcloud_instance.web を構成内に自分で宣言してください。

terraform import コマンドでインポートする​

Terraform 1.5 より前のバージョンでは、terraform import コマンドを使用します。先に構成内で resource を宣言してから、次のコマンドを実行します。

terraform import fptcloud_instance.legacy_app vpc/<vpc_id>/instance/<instance_id>

インポートにまだ対応していないリソース​

Subnet、Security Group、Security Group の rule、Floating IP、Instance Group はまだインポートできません。これらのリソースを構成で使用するには、data source で参照します。

data "fptcloud_subnet" "existing" {
vpc_id = data.fptcloud_vpc.example.id

filter {
key = "name"
values = ["legacy-subnet"]
}
}

その後、subnet_id が必要なすべての箇所で data.fptcloud_subnet.existing.subnets[0].id を使用します。data source で情報を参照する も参照してください。

次のステップ​