最初の Instance を作成する
このチュートリアルでは、1 つの設定ファイルだけで、Subnet と SSH key でログインする Linux Instance を作成します。このチュートリアルを終えると、Terraform におけるリソースのライフサイクル全体(参照、作成、確認、削除)を把握できます。
前提条件
- ✅ セットアップと設定を完了していること。
terraform initが正常に実行され、環境変数が宣言されている必要があります。 - ✅ VPC に Subnet 1 つと Instance 1 つ分の quota が残っていること。
- ✅ マシン上に SSH key のペアがあること。例:
~/.ssh/id_rsaと~/.ssh/id_rsa.pub。まだない場合は、ssh-keygen -t rsa -b 4096コマンドで作成します。
FPT Cloud は OpenSSH 形式の public key を受け付けます。2048 ビット以上の RSA、Ed25519、ECDSA に対応しています。SSH Key のリファレンスを参照してください。
VPC 内の選択肢を確認する
image、flavor、storage policy は Region や VPC によって異なります。選ぶ前に VPC の一覧を確認してください。
-
プロジェクトディレクトリに
catalog.tfファイルを作成します。example-vpcを VPC の名前に置き換えてください。data "fptcloud_vpc" "example" {name = "example-vpc"}data "fptcloud_image" "all" {vpc_id = data.fptcloud_vpc.example.id}data "fptcloud_storage_policy" "all" {vpc_id = data.fptcloud_vpc.example.id}output "images" {value = data.fptcloud_image.all.images[*].name}output "storage_policies" {value = data.fptcloud_storage_policy.all.storage_policies[*].name} -
terraform applyを実行し、yesを入力します。 -
使用したい Linux image の名前と storage policy の名前を控えます。
-
catalog.tfファイルを削除します。
設定を記述する
次の 3 つの部分からなる main.tf ファイルを作成します。
VPC、image、flavor、storage policy を参照します。 flavor は vCPU 数と RAM 容量で選択するため、この設定は 2 vCPU、4 GB RAM の flavor がある任意の VPC で動作します。
# main.tf
data "fptcloud_vpc" "example" {
name = "example-vpc"
}
# main.tf
data "fptcloud_image" "ubuntu" {
vpc_id = data.fptcloud_vpc.example.id
filter {
key = "name"
values = ["UBUNTU-22.04"] # 前の手順で控えた image 名に置き換えます
match_by = "substring"
}
}
# main.tf
data "fptcloud_flavor" "small" {
vpc_id = data.fptcloud_vpc.example.id
filter {
key = "cpu"
values = ["2"]
}
filter {
key = "memory_mb"
values = ["4096"]
}
}
# main.tf
data "fptcloud_storage_policy" "ssd" {
vpc_id = data.fptcloud_vpc.example.id
filter {
key = "name"
values = ["Premium-SSD"] # 控えた storage policy 名に置き換えます
}
}
Subnet と Instance を作成します。 VPC 内の既存の Subnet と重複しない CIDR 範囲を選んでください。
# main.tf
resource "fptcloud_subnet" "app" {
vpc_id = data.fptcloud_vpc.example.id
name = "quickstart-subnet"
type = "NAT_ROUTED"
cidr = "10.20.1.0/24"
gateway_ip = "10.20.1.1"
}
resource "fptcloud_instance" "app" {
vpc_id = data.fptcloud_vpc.example.id
name = "quickstart-vm-01"
image_name = data.fptcloud_image.ubuntu.images[0].name
flavor_name = data.fptcloud_flavor.small.flavors[0].name
subnet_id = fptcloud_subnet.app.id
storage_size_gb = 40
storage_policy_id = data.fptcloud_storage_policy.ssd.storage_policies[0].id
ssh_key = file(pathexpand("~/.ssh/id_rsa.pub"))
status = "POWERED_ON"
}
結果を出力します。
# main.tf
output "instance_id" {
value = fptcloud_instance.app.id
}
output "private_ip" {
value = fptcloud_instance.app.private_ip
}
上記の設定について知っておくべき点は次のとおりです。
NAT_ROUTEDを指定すると、Subnet 内の Instance は NAT gateway 経由でインターネットへの送信方向のアクセスができます。インターネットへの接続が不要な Subnet にはISOLATEDを使います。ssh_keyには key の名前ではなく、public key の内容そのものを指定します。storage_size_gbは root disk の容量で、単位は GB です。
リソースを作成する
-
変更をプレビューします。
terraform planplan には
Plan: 2 to add, 0 to change, 0 to destroy.と表示されます。 -
変更を適用します。
terraform apply -
yesを入力して確定します。
Terraform は Instance が起動するまで待機します。通常は数分かかります。完了すると、Terraform は instance_id と private_ip を出力します。Instance quickstart-vm-01 は、Portal の Instance 一覧に Running 状態で表示されます。
この時点では、Instance には private アドレスしかありません。インターネットからアクセスするには、ネットワークの例のように Security Group と Floating IP を割り当てます。
クリーンアップ
不要になったら、作成したリソースをすべて削除します。
terraform destroy
yes を入力して確定します。Terraform はまず Instance を削除し、次に Subnet を削除します。
terraform destroy は Instance と root disk 上のデータを完全に削除します。この操作は元に戻せません。