既存リソースをインポートする
インポートを使うと、FPT Cloud Portal で作成済みのリソースを、削除や再作成をせずに Terraform で管理できるようになります。インポート後は、他のリソースと同様に Terraform でリソースを変更します。また、構成はリソースの現在の状態を正確に記述している必要があります。
前提条件
- ✅ セットアップと設定 を完了していること。
- ✅
importブロックと構成の自動生成を使用するために、Terraform 1.5 以降であること。 - ✅ FPT Cloud provider がバージョン
0.3.81以降であること。Instance と disk のインポートに対応した最初のバージョンです。 - ✅ リソースが安定した状態にあり、作成、resize、削除などの操作中でないこと。
インポートに対応するリソース
| Resource | インポート ID の形式 | 対応する provider バージョン |
|---|---|---|
fptcloud_instance | vpc/<vpc_id>/instance/<instance_id> または vpc/<vpc_id>/instance_name/<instance_name> | 0.3.81 |
fptcloud_storage | vpc/<vpc_id>/storage/<storage_id> | 0.3.81 |
fptcloud_snapshot | vpc/<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 をインポートする
-
importブロックを含むimport.tfファイルを作成します。import {to = fptcloud_instance.legacy_appid = "vpc/<vpc_id>/instance/<instance_id>"} -
Terraform に初期構成を自動生成させます。
terraform plan -generate-config-out=generated.tf -
generated.tfを開き、Instance の作成時に使用した値と同じ値をssh_keyまたはpasswordに入力します。FPT Cloud はこの 2 つの値を返しません。image_nameがnullの場合は、Instance の作成に使用した image の名前を入力します。 -
terraform planを再度実行します。plan にforces replacementの行がなくなった場合にのみ先に進みます。 -
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 で情報を参照する も参照してください。