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

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 import và tự sinh cấu hình.
  • ✅ FPT Cloud provider từ phiên bản 0.3.81 trở 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 importTừ phiên bản provider
fptcloud_instancevpc/<vpc_id>/instance/<instance_id> hoặc vpc/<vpc_id>/instance_name/<tên_instance>0.3.81
fptcloud_storagevpc/<vpc_id>/storage/<storage_id>0.3.81
fptcloud_snapshotvpc/<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.

cảnh báo

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​

  1. Tạo file import.tf với khối import:

    import {
    to = fptcloud_instance.legacy_app
    id = "vpc/<vpc_id>/instance/<instance_id>"
    }
  2. Để Terraform tự sinh cấu hình khởi đầu:

    terraform plan -generate-config-out=generated.tf
  3. Mở generated.tf và điền ssh_key hoặc password bằng đúng giá trị đã dùng khi tạo Instance. FPT Cloud không trả về hai giá trị này. Nếu image_name là null, điền tên image đã dùng để tạo Instance.

  4. Chạy lại terraform plan. Chỉ tiếp tục khi plan không còn dòng forces replacement.

  5. 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.

cảnh báo

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.

cảnh báo

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.

Bước tiếp theo​