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-01và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.
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.
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ộc | Khi thay đổi |
|---|---|---|
vpc_id | Có | Không đổi được sau khi tạo. |
name | Có | Đổi tên tại chỗ. Với disk EXTERNAL, tên không được trùng disk khác trong VPC. |
type | Có | Không đổi được: apply báo lỗi. Giá trị: EXTERNAL, LOCAL. |
size_gb | Có | Tăng dung lượng tại chỗ. |
storage_policy_id | Có | Đổi storage policy tại chỗ. |
instance_id | Không | Vớ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_ids | Không | Cậ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.
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.
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.