Xử lý sự cố
Dùng trang này khi terraform plan hoặc terraform apply báo lỗi, hoặc khi plan muốn thay đổi nhiều hơn bạn mong đợi. Mỗi mục nêu triệu chứng, nguyên nhân và cách khắc phục.
Lỗi kết nối và xác thực
| Thông báo hoặc triệu chứng | Nguyên nhân | Cách khắc phục |
|---|---|---|
| Lỗi khi đọc tenant hoặc VPC | Token hết hạn, tenant_name sai, hoặc tài khoản không có quyền với VPC. | Kiểm tra FPTCLOUD_TOKEN và FPTCLOUD_TENANT_NAME. Tạo token mới nếu cần. |
please enter vpc name | Data source fptcloud_vpc thiếu tham số name. | Tra cứu VPC theo name. |
UnknownError: System error, please try again ! | FPT Cloud từ chối request, và provider không hiển thị chi tiết của lỗi. | Xem Lỗi "System error" bên dưới. |
timeout while waiting for state | Thao tác lâu hơn timeout của provider, mặc định 15 phút. | Kiểm tra tài nguyên trên Portal. Nếu thao tác vẫn đang chạy, tăng timeout trong khối provider rồi chạy lại. |
Lỗi "System error"
Khi gặp UnknownError: System error, please try again !, kiểm tra lần lượt:
- Token chưa hết hạn.
- Role của bạn cho phép thao tác đó trên VPC. Nhờ quản trị viên của tenant kiểm tra nếu cần.
- Tài nguyên liên quan vẫn còn trên Portal.
- ID truyền vào đúng loại tài nguyên, ví dụ
subnet_idlà ID của Subnet chứ không phải tên. - Thực hiện cùng thao tác trên Portal để xem thông báo lỗi đầy đủ.
Lỗi cấu hình
| Thông báo | Nguyên nhân | Cách khắc phục |
|---|---|---|
Invalid index tại images[0], flavors[0] hoặc storage_policies[0] | Bộ lọc của data source không khớp kết quả nào. | Liệt kê toàn bộ danh sách như trong Tra cứu bằng data source rồi sửa giá trị lọc. |
name cannot contain whitespace | Tên tài nguyên chứa khoảng trắng. | Dùng dấu gạch ngang - thay cho khoảng trắng. |
Missing required argument | Thiếu tham số bắt buộc. | Bổ sung tham số được nêu trong thông báo. |
The root storage size of an instance can only be increased | storage_size_gb nhỏ hơn dung lượng root disk hiện tại. | Đặt giá trị bằng hoặc lớn hơn dung lượng hiện tại. |
Storage name ... already exists | Đã có disk khác trùng tên trong VPC. | Đặt tên khác cho disk. |
Storage type can not be changed | Đổi type của disk đã tạo. | Giữ nguyên type. Muốn đổi loại disk, tạo disk mới. |
Với Subnet, kiểm tra thêm: dải CIDR không chồng lấn với Subnet khác trong VPC, và gateway_ip nằm trong dải CIDR.
Không xóa được Security Group
Triệu chứng: terraform destroy chờ lâu rồi báo lỗi khi xóa Security Group.
Nguyên nhân: FPT Cloud chỉ xóa được Security Group khi nó không còn gắn vào tài nguyên nào.
Cách khắc phục:
- Đặt
apply_to = []cho Security Group. - Chạy
terraform apply. - Chạy lại
terraform destroy.
Xem cách dùng biến để làm việc này gọn hơn trong Dựng hạ tầng ứng dụng web hoàn chỉnh.
Plan luôn báo thay đổi
Triệu chứng: sau khi apply thành công, lần terraform plan nào cũng báo cùng một thay đổi.
| Nguyên nhân | Cách khắc phục |
|---|---|
| Tài nguyên bị sửa trên Portal. | Cập nhật cấu hình theo hiện trạng, hoặc chỉ thay đổi tài nguyên bằng Terraform. |
Instance khai báo security_group_ids trong khi Security Group được gắn qua apply_to. | Bỏ security_group_ids khỏi Instance, chỉ dùng apply_to. |
apply_to để trống nhưng Security Group được gắn thêm trên Portal. | Đưa IP vào apply_to, hoặc thêm lifecycle { ignore_changes = [apply_to] } cho Security Group. |
private_ip hoặc public_ip của Instance bị sửa sau khi tạo. | Hai tham số này chỉ dùng khi tạo. Trả về giá trị cũ, dùng fptcloud_floating_ip_association để đổi IP public. |
Plan muốn tạo lại tài nguyên
Triệu chứng: plan hiển thị must be replaced và # forces replacement.
Nguyên nhân: bạn đổi một tham số không cập nhật tại chỗ được. Với Instance, đó là vpc_id, subnet_id, image_name, ssh_key và password. Với Subnet, đó là mọi tham số trừ DNS và tag.
Cách khắc phục: nếu không chủ ý tạo lại, trả tham số về giá trị cũ. Nếu image_name lấy từ bộ lọc image, bộ lọc có thể đã trả về image mới hơn; cố định tên image cho Instance đó.
Tạo lại Instance xóa root disk và toàn bộ dữ liệu trên đó. Không apply plan có forces replacement khi chưa hiểu rõ nguyên nhân.
Tài nguyên bị xóa ngoài Terraform
Triệu chứng: terraform plan báo lỗi không tìm thấy tài nguyên, ví dụ Storage not found hoặc Failed to retrieve instance.
Nguyên nhân: tài nguyên đã bị xóa trên Portal, nhưng vẫn còn trong state của Terraform.
Cách khắc phục: sau khi xác nhận trên Portal rằng tài nguyên không còn, xóa tài nguyên khỏi state:
terraform state rm fptcloud_storage.app_data
Lệnh này chỉ xóa tài nguyên khỏi state, không gọi tới FPT Cloud. Lần terraform apply sau sẽ tạo lại tài nguyên nếu nó vẫn có trong cấu hình.
IP private của Instance rỗng
Triệu chứng: output hoặc apply_to chứa chuỗi rỗng ngay sau khi tạo Instance.
Nguyên nhân: Instance vừa tạo có thể chưa báo IP private trong thời gian ngắn.
Cách khắc phục: chạy lại terraform apply. Nên đọc IP qua data source fptcloud_instance như trong Ví dụ Instance, vì data source được đọc lại mỗi lần plan.
Thu thập thông tin khi liên hệ hỗ trợ
Bật log chi tiết rồi chạy lại lệnh lỗi:
export TF_LOG=DEBUG
export TF_LOG_PATH=terraform-debug.log
terraform apply
Khi liên hệ FPT Cloud, gửi kèm:
- Thời điểm chạy lệnh.
- Địa chỉ tài nguyên lỗi, ví dụ
fptcloud_instance.web[0]. - Toàn bộ thông báo lỗi.
- Phiên bản provider, lấy từ
terraform version.
File log có thể chứa thông tin nhạy cảm. Xóa token và mật khẩu khỏi log trước khi gửi.