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

最初の 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 の一覧を確認してください。

  1. プロジェクトディレクトリに 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
    }
  2. terraform apply を実行し、yes を入力します。

  3. 使用したい Linux image の名前と storage policy の名前を控えます。

  4. 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 です。

リソースを作成する​

  1. 変更をプレビューします。

    terraform plan

    plan には Plan: 2 to add, 0 to change, 0 to destroy. と表示されます。

  2. 変更を適用します。

    terraform apply
  3. 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 上のデータを完全に削除します。この操作は元に戻せません。

次のステップ​