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óm | Resource | Data source |
|---|---|---|
| Compute | fptcloud_instance, fptcloud_instance_group, fptcloud_ssh_key, fptcloud_snapshot | fptcloud_instance, fptcloud_instances, fptcloud_flavor, fptcloud_image, fptcloud_instance_group_policy, fptcloud_ssh_key |
| Storage | fptcloud_storage | fptcloud_storage, fptcloud_storages, fptcloud_storage_policy |
| Network | fptcloud_subnet, fptcloud_security_group, fptcloud_security_group_rule, fptcloud_floating_ip, fptcloud_floating_ip_association | fptcloud_vpc, fptcloud_subnet, fptcloud_security_group, fptcloud_floating_ip |
| Tag | fptcloud_tagging | fptcloud_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 sourcefptcloud_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-place | Tà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 replaced | Tà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ào | Tham 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. |
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 plansau sẽ báo khác biệt vàterraform applysẽ đư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".