Chuyển tới nội dung chính

Tạo Instance đầu tiên

Bài hướng dẫn này giúp bạn tạo một Subnet và một Instance Linux đăng nhập bằng SSH key, chỉ với một file cấu hình. Sau bài này, bạn nắm được trọn vòng đời của tài nguyên trên Terraform: tra cứu, tạo, kiểm tra và xóa.

Điều kiện tiên quyết​

  • ✅ Đã hoàn thành Cài đặt và cấu hình: terraform init chạy thành công và biến môi trường đã được khai báo.
  • ✅ VPC còn quota cho một Subnet và một Instance.
  • ✅ Có cặp SSH key trên máy, ví dụ ~/.ssh/id_rsa và ~/.ssh/id_rsa.pub. Nếu chưa có, tạo bằng lệnh ssh-keygen -t rsa -b 4096.
ghi chú

FPT Cloud nhận public key định dạng OpenSSH: RSA từ 2048 bit, Ed25519 và ECDSA. Xem Tham chiếu SSH Key.

Xem các lựa chọn trong VPC​

Image, flavor và storage policy khác nhau giữa các region và VPC. Hãy xem danh sách của VPC trước khi chọn.

  1. Tạo file catalog.tf trong thư mục dự án. Thay example-vpc bằng tên VPC của bạn:

    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. Chạy terraform apply và nhập yes.

  3. Ghi lại tên image Linux và tên storage policy bạn muốn dùng.

  4. Xóa file catalog.tf.

Viết cấu hình​

Tạo file main.tf với ba phần dưới đây.

Tra cứu VPC, image, flavor và storage policy. Flavor được chọn theo số vCPU và dung lượng RAM, nên cấu hình chạy được ở mọi VPC có flavor 2 vCPU, 4 GB RAM:

# 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"] # Thay bằng tên image bạn ghi lại ở bước trước
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"] # Thay bằng tên storage policy bạn ghi lại
}
}

Tạo Subnet và Instance. Chọn dải CIDR không trùng với các Subnet đang có trong VPC:

# 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"
}

Xuất kết quả:

# main.tf
output "instance_id" {
value = fptcloud_instance.app.id
}

output "private_ip" {
value = fptcloud_instance.app.private_ip
}

Một vài điểm cần biết về cấu hình trên:

  • NAT_ROUTED cho phép Instance trong Subnet truy cập Internet chiều đi qua NAT gateway. Dùng ISOLATED cho Subnet không cần ra Internet.
  • ssh_key nhận chính nội dung public key, không phải tên key.
  • storage_size_gb là dung lượng root disk, tính bằng GB.

Tạo tài nguyên​

  1. Xem trước thay đổi:

    terraform plan

    Plan hiển thị Plan: 2 to add, 0 to change, 0 to destroy.

  2. Áp dụng thay đổi:

    terraform apply
  3. Nhập yes để xác nhận.

Terraform chờ tới khi Instance chạy, thường mất vài phút. Khi hoàn tất, Terraform in ra instance_id và private_ip. Instance quickstart-vm-01 xuất hiện trong danh sách Instance trên Portal với trạng thái Running.

mẹo

Instance hiện chỉ có địa chỉ private. Để truy cập từ Internet, gắn Security Group và Floating IP như trong Ví dụ Network.

Dọn dẹp​

Khi không cần nữa, xóa toàn bộ tài nguyên vừa tạo:

terraform destroy

Nhập yes để xác nhận. Terraform xóa Instance trước, rồi tới Subnet.

cảnh báo

terraform destroy xóa vĩnh viễn Instance và dữ liệu trên root disk. Hành động không thể hoàn tác.

Bước tiếp theo​