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

Tổng quan FPT Cloud provider

FPT Cloud provider (fpt-corp/fptcloud) là cầu nối giữa Terraform và FPT Cloud. Provider gọi các API của FPT Cloud để tạo, đọc, cập nhật và xóa tài nguyên theo đúng cấu hình bạn viết. Trang này giúp bạn hiểu provider làm việc thế nào trước khi viết cấu hình đầu tiên.

Tài nguyên được hướng dẫn trong phần này​

Các trang hướng dẫn tập trung vào nhóm FPT Cloud Server, FPT Storage và FPT Network:

NhómResourceData source
Computefptcloud_instance, fptcloud_instance_group, fptcloud_ssh_key, fptcloud_snapshotfptcloud_instance, fptcloud_instances, fptcloud_flavor, fptcloud_image, fptcloud_instance_group_policy, fptcloud_ssh_key
Storagefptcloud_storagefptcloud_storage, fptcloud_storages, fptcloud_storage_policy
Networkfptcloud_subnet, fptcloud_security_group, fptcloud_security_group_rule, fptcloud_floating_ip, fptcloud_floating_ip_associationfptcloud_vpc, fptcloud_subnet, fptcloud_security_group, fptcloud_floating_ip
Tagfptcloud_taggingfptcloud_tagging

Provider còn hỗ trợ nhiều dịch vụ khác như FPT Kubernetes Engine, FPT Database Engine, FPT Object Storage và Load Balancer. Danh sách đầy đủ resource và tham số của từng phiên bản nằm trong tài liệu tham chiếu provider.

Cách provider xác định tài nguyên của bạn​

Mỗi lần gọi API, provider dùng ba thông tin:

  • Token — xác định bạn là ai. Token có quyền giống tài khoản của bạn trên Portal, nên Terraform không làm được nhiều hơn những gì bạn làm được trên Portal.
  • Tenant (tenant_name) — tổ chức chứa tài nguyên, chính là tenant bạn chọn ở đầu Portal.
  • VPC (vpc_id) — hầu hết tài nguyên thuộc về một VPC. Bạn tra cứu ID của VPC theo tên bằng data source fptcloud_vpc.

Tham số region của provider chỉ được dùng bởi một số dịch vụ như FPT Kubernetes Engine và FPT Database Engine. Instance, disk và network đi theo vpc_id. Dù vậy, bạn nên luôn đặt region đúng với region của VPC để cấu hình chạy được khi bổ sung các dịch vụ đó.

Thay đổi tại chỗ và thay đổi tạo lại tài nguyên​

Khi bạn sửa cấu hình, Terraform xử lý theo một trong ba cách:

Ký hiệu trong planÝ nghĩa
~ update in-placeTài nguyên được cập nhật và giữ nguyên dữ liệu. Ví dụ: đổi tên Instance, tăng dung lượng disk.
-/+ ... must be replacedTài nguyên bị xóa rồi tạo lại. Dòng gây ra việc này có chú thích # forces replacement.
Không có thay đổi nàoTham số chỉ được dùng khi tạo tài nguyên, ví dụ private_ip của Instance. Sửa nó sau khi tạo không có tác dụng.
cảnh báo

Khi một Instance bị tạo lại, root disk và toàn bộ dữ liệu trên đó bị xóa. Với fptcloud_instance, đổi vpc_id, subnet_id, image_name, ssh_key hoặc password sẽ tạo lại Instance. Luôn đọc plan trước khi apply.

Terraform và Portal cùng quản lý​

  • Terraform chỉ quản lý những tài nguyên có trong state của nó. Tài nguyên bạn tạo trên Portal không bị Terraform đụng tới, trừ khi bạn import.
  • Nếu bạn sửa trên Portal một tài nguyên do Terraform quản lý, lần terraform plan sau sẽ báo khác biệt và terraform apply sẽ đưa tài nguyên về đúng cấu hình.
  • Chọn một nơi duy nhất để thay đổi mỗi tài nguyên — Terraform hoặc Portal — để tránh hai bên ghi đè nhau.

Phiên bản provider​

Provider được cập nhật thường xuyên. Hãy cố định phiên bản trong khối required_providers và đọc changelog trước khi nâng phiên bản:

terraform {
required_providers {
fptcloud = {
source = "fpt-corp/fptcloud"
version = "~> 0.3"
}
}
}

~> 0.3 cho phép mọi bản 0.3.x nhưng không tự nâng lên 0.4. Để kiểm soát chặt hơn, đặt một phiên bản cụ thể, ví dụ version = "0.3.90".

Bước tiếp theo​