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

Ví dụ storage

Storage disk là ổ đĩa block tách biệt với root disk của Instance. Tách dữ liệu ứng dụng ra disk riêng giúp bạn tăng dung lượng, sao lưu hoặc chuyển dữ liệu sang Instance khác mà không ảnh hưởng hệ điều hành. Khái niệm chi tiết xem tại Tổng quan Storage Disks.

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

  • ✅ Đã hoàn thành Cài đặt và cấu hình.
  • ✅ Đã có Instance để gắn disk. Các ví dụ dưới đây đọc hai Instance có sẵn tên app-server-01 và app-server-02, ví dụ tạo theo Ví dụ Instance.

Khối dùng chung​

# shared.tf
data "fptcloud_vpc" "example" {
name = "example-vpc"
}

data "fptcloud_storage_policy" "ssd" {
vpc_id = data.fptcloud_vpc.example.id

filter {
key = "name"
values = ["Premium-SSD"]
}
}
# shared.tf
data "fptcloud_instance" "app" {
vpc_id = data.fptcloud_vpc.example.id
name = "app-server-01"
}

data "fptcloud_instance" "standby" {
vpc_id = data.fptcloud_vpc.example.id
name = "app-server-02"
}

Trong cấu hình thật, bạn có thể dùng thẳng fptcloud_instance.app.id nếu Instance được tạo trong cùng thư mục Terraform.

Disk dữ liệu gắn vào Instance​

Đây là trường hợp phổ biến nhất: một disk riêng cho dữ liệu ứng dụng. Terraform tạo disk và chờ tới khi disk được gắn vào Instance:

# disk.tf
resource "fptcloud_storage" "app_data" {
vpc_id = data.fptcloud_vpc.example.id
name = "app-data-disk"
type = "EXTERNAL"
size_gb = 200
storage_policy_id = data.fptcloud_storage_policy.ssd.storage_policies[0].id
instance_id = data.fptcloud_instance.app.id
}

Disk mới gắn vào là disk trống. Trước khi dùng, bạn cần định dạng disk trong hệ điều hành của Instance theo mục Disk mới tạo không xuất hiện bên trong Instance trong Xử lý sự cố Storage Disks.

Disk chưa gắn vào Instance​

Bỏ tham số instance_id để tạo disk độc lập, ví dụ chuẩn bị trước disk cho một Instance sẽ tạo sau:

# disk.tf
resource "fptcloud_storage" "spare" {
vpc_id = data.fptcloud_vpc.example.id
name = "spare-disk"
type = "EXTERNAL"
size_gb = 100
storage_policy_id = data.fptcloud_storage_policy.ssd.storage_policies[0].id
}

Khi cần gắn, thêm instance_id và chạy terraform apply.

Nhiều disk cho một Instance​

Tách dữ liệu và log ra hai disk riêng để mỗi disk có dung lượng và storage policy phù hợp:

# disks.tf
locals {
app_disks = {
data = 200
logs = 50
}
}

resource "fptcloud_storage" "app" {
for_each = local.app_disks

vpc_id = data.fptcloud_vpc.example.id
name = "app-${each.key}-disk"
type = "EXTERNAL"
size_gb = each.value
storage_policy_id = data.fptcloud_storage_policy.ssd.storage_policies[0].id
instance_id = data.fptcloud_instance.app.id
}

Chuyển disk sang Instance khác​

Disk EXTERNAL có thể chuyển giữa các Instance mà dữ liệu vẫn giữ nguyên. Đổi instance_id sang Instance mới rồi chạy terraform apply:

# disk.tf
resource "fptcloud_storage" "shared_data" {
vpc_id = data.fptcloud_vpc.example.id
name = "shared-data-disk"
type = "EXTERNAL"
size_gb = 100
storage_policy_id = data.fptcloud_storage_policy.ssd.storage_policies[0].id
instance_id = data.fptcloud_instance.standby.id # trước đây là Instance app
}

Để tháo disk khỏi Instance mà không gắn vào Instance nào khác, xóa dòng instance_id rồi chạy terraform apply.

cảnh báo

Unmount disk trong hệ điều hành trước khi chuyển hoặc tháo disk, như khuyến nghị trong Xử lý sự cố Storage Disks.

Tăng dung lượng và đổi storage policy​

Tăng size_gb để mở rộng disk, hoặc đổi storage_policy_id để chuyển disk sang mức hiệu năng khác. Cả hai thay đổi được thực hiện tại chỗ, dữ liệu được giữ nguyên:

# disk.tf
data "fptcloud_storage_policy" "fast" {
vpc_id = data.fptcloud_vpc.example.id

filter {
key = "name"
values = ["Premium-SSD-6000"] # Thay bằng storage policy có trong VPC của bạn
}
}
# disk.tf
resource "fptcloud_storage" "reports" {
vpc_id = data.fptcloud_vpc.example.id
name = "reports-disk"
type = "EXTERNAL"
size_gb = 300 # trước đây là 200
storage_policy_id = data.fptcloud_storage_policy.fast.storage_policies[0].id
instance_id = data.fptcloud_instance.app.id
}

Sau khi tăng dung lượng, bạn cần vào hệ điều hành của Instance để mở rộng phân vùng tương ứng, theo Quản lý Storage Disk của Instance.

cảnh báo

Dung lượng disk chỉ tăng được, không giảm được. Provider không chặn giá trị nhỏ hơn ở bước terraform plan, vì vậy hãy kiểm tra kỹ trước khi apply.

Snapshot Instance​

Chụp Snapshot trước một thay đổi lớn, ví dụ nâng cấp hệ điều hành, để có thể quay lại trạng thái cũ. Mỗi fptcloud_snapshot là một Snapshot, được tạo khi bạn apply và bị xóa khi bạn destroy:

# snapshot.tf
resource "fptcloud_snapshot" "before_upgrade" {
vpc_id = data.fptcloud_vpc.example.id
instance_id = data.fptcloud_instance.app.id
name = "app-before-upgrade"
}

Tên Snapshot dài từ 1 tới 30 ký tự, gồm chữ cái, chữ số, dấu gạch dưới, dấu gạch ngang, dấu chấm và khoảng trắng. Xem thêm Tổng quan Snapshots.

Tham số thường dùng của storage disk​

Tham sốBắt buộcKhi thay đổi
vpc_idCóKhông đổi được sau khi tạo.
nameCóĐổi tên tại chỗ. Với disk EXTERNAL, tên không được trùng disk khác trong VPC.
typeCóKhông đổi được: apply báo lỗi. Giá trị: EXTERNAL, LOCAL.
size_gbCóTăng dung lượng tại chỗ.
storage_policy_idCóĐổi storage policy tại chỗ.
instance_idKhôngVới EXTERNAL: chuyển hoặc tháo disk tại chỗ. Với LOCAL: bắt buộc khi tạo và không đổi được.
tag_idsKhôngCập nhật tag tại chỗ.

Nên dùng EXTERNAL cho disk dữ liệu. Disk LOCAL gắn cố định với một Instance và không chuyển hay tháo được.

ghi chú

Không dùng fptcloud_storage cho root disk của Instance. Root disk được quản lý bằng storage_size_gb và storage_policy_id của fptcloud_instance.

Xóa disk​

Khi bạn xóa một disk khỏi cấu hình hoặc chạy terraform destroy, Terraform tháo disk khỏi Instance, xóa disk và chờ tới khi việc xóa hoàn tất.

cảnh báo

Xóa disk sẽ xóa vĩnh viễn toàn bộ dữ liệu trên disk. Hành động không thể hoàn tác.

Bước tiếp theo​