Import tài nguyên có sẵn
Import giúp Terraform quản lý một tài nguyên bạn đã tạo trên FPT Cloud Portal mà không xóa hay tạo lại tài nguyên đó. Sau khi import, bạn thay đổi tài nguyên bằng Terraform như mọi tài nguyên khác, và cấu hình của bạn phải mô tả đúng hiện trạng của tài nguyên.
Điều kiện tiên quyết
- ✅ Đã hoàn thành Cài đặt và cấu hình.
- ✅ Terraform 1.5 trở lên, để dùng khối
importvà tự sinh cấu hình. - ✅ FPT Cloud provider từ phiên bản
0.3.81trở lên, phiên bản đầu tiên hỗ trợ import Instance và disk. - ✅ Tài nguyên đang ở trạng thái ổn định, không đang trong một thao tác như tạo, resize hoặc xóa.
Tài nguyên hỗ trợ import
| Resource | Định dạng ID import | Từ phiên bản provider |
|---|---|---|
fptcloud_instance | vpc/<vpc_id>/instance/<instance_id> hoặc vpc/<vpc_id>/instance_name/<tên_instance> | 0.3.81 |
fptcloud_storage | vpc/<vpc_id>/storage/<storage_id> | 0.3.81 |
fptcloud_snapshot | vpc/<vpc_id>/snapshot/<snapshot_id> | 0.3.74 |
fptcloud_ssh_key | <ssh_key_id> | Xem lưu ý bên dưới |
fptcloud_tagging | <tag_id> | — |
Lấy các ID từ trang chi tiết tài nguyên trên Portal, hoặc bằng data source tương ứng.
Sau khi import fptcloud_ssh_key, provider không đọc lại public_key từ FPT Cloud. Nếu không xử lý, plan sẽ đánh dấu SSH key forces replacement. Đặt public_key đúng nội dung key đang có và thêm lifecycle { ignore_changes = [public_key] } cho resource, hoặc dùng data source fptcloud_ssh_key thay vì import.
Import Instance
-
Tạo file
import.tfvới khốiimport:import {to = fptcloud_instance.legacy_appid = "vpc/<vpc_id>/instance/<instance_id>"} -
Để Terraform tự sinh cấu hình khởi đầu:
terraform plan -generate-config-out=generated.tf -
Mở
generated.tfvà điềnssh_keyhoặcpasswordbằng đúng giá trị đã dùng khi tạo Instance. FPT Cloud không trả về hai giá trị này. Nếuimage_namelànull, điền tên image đã dùng để tạo Instance. -
Chạy lại
terraform plan. Chỉ tiếp tục khi plan không còn dòngforces replacement. -
Chạy
terraform applyđể lưu kết quả import vào state.
Plan đầu tiên sau khi import có thể báo ssh_key hoặc password được thêm mới. Apply plan này chỉ lưu giá trị vào state, Instance không bị thay đổi.
Không apply một plan báo forces replacement cho tài nguyên vừa import. Terraform sẽ xóa Instance đang chạy cùng dữ liệu trên root disk. Sửa cấu hình tới khi plan không còn tạo lại tài nguyên.
Một số lưu ý khi import Instance:
- Nếu nhiều Instance trùng tên, import theo ID.
- Instance dùng disk NVMe chưa hỗ trợ import.
Import disk dữ liệu
import {
to = fptcloud_storage.legacy_data
id = "vpc/<vpc_id>/storage/<storage_id>"
}
Chỉ disk loại EXTERNAL ở trạng thái sẵn sàng mới import được.
Nếu disk đang gắn vào Instance, giữ tham số instance_id trỏ tới đúng Instance đó trong cấu hình. Thiếu instance_id, plan báo instance_id đổi thành null và apply sẽ tháo disk khỏi Instance.
Import nhiều tài nguyên cùng lúc
Khai báo nhiều khối import trong cùng file, rồi sinh cấu hình một lần:
import {
to = fptcloud_instance.web["web-01"]
id = "vpc/<vpc_id>/instance_name/web-01"
}
import {
to = fptcloud_instance.web["web-02"]
id = "vpc/<vpc_id>/instance_name/web-02"
}
Với địa chỉ dạng fptcloud_instance.web["web-01"], tự khai báo resource fptcloud_instance.web với for_each = toset(["web-01", "web-02"]) trong cấu hình trước khi chạy terraform plan.
Import bằng lệnh terraform import
Với Terraform cũ hơn 1.5, dùng lệnh terraform import. Khai báo resource trong cấu hình trước, rồi chạy:
terraform import fptcloud_instance.legacy_app vpc/<vpc_id>/instance/<instance_id>
Tài nguyên chưa hỗ trợ import
Subnet, Security Group, rule của Security Group, Floating IP và Instance Group chưa import được. Để dùng các tài nguyên này trong cấu hình, tham chiếu chúng bằng data source:
data "fptcloud_subnet" "existing" {
vpc_id = data.fptcloud_vpc.example.id
filter {
key = "name"
values = ["legacy-subnet"]
}
}
Sau đó dùng data.fptcloud_subnet.existing.subnets[0].id ở mọi nơi cần subnet_id. Xem thêm Tra cứu bằng data source.