Fix lỗi Terraform 'Missing resource instance key' Khi Tham Chiếu Resource có count Mà Không Có Index

TL;DR

Bạn đang dùng resource count như một object đơn lẻ. Nhưng nó là một danh sách. Hãy thêm index: aws_instance.web[0] cho instance đầu tiên, aws_instance.web[count.index] bên trong một counted resource khác, hoặc aws_instance.web[*].id để lấy tất cả ID cùng lúc.

Nguyên nhân gây ra lỗi này

Ngay khi bạn thêm count vào một resource block, Terraform chuyển nó thành một danh sách có thứ tự — kể cả khi count = 1. Mọi tham chiếu đến resource đó đều phải chỉ rõ bạn muốn instance nào. Bỏ qua index và bạn sẽ nhận được:

Error: Missing resource instance key: Because aws_instance.web has "count" set, its attributes must be accessed on specific instances.

Đây là cấu hình gây ra lỗi:

resource "aws_instance" "web" {
  count         = 3
  ami           = "ami-0c55b159cbfafe1f0"
  instance_type = "t3.micro"
}

output "web_ip" {
  value = aws_instance.web.private_ip  # ← LỖI: thiếu index
}

Các cách sửa

1. Tham chiếu một index cụ thể

Biết chính xác instance nào bạn muốn? Chọn nó bằng index bắt đầu từ 0:

output "first_web_ip" {
  value = aws_instance.web[0].private_ip
}

Index bắt đầu từ 0 — instance thứ hai là [1], instance thứ ba là [2]. Đây là cách sửa đơn giản nhất trong hầu hết các trường hợp.

2. Dùng splat expression để lấy tất cả giá trị

Cần cùng một attribute từ mọi instance? Toán tử splat [*] trả về một danh sách chỉ với một lệnh:

output "all_web_ips" {
  value = aws_instance.web[*].private_ip
}

Dùng được trong outputs, locals, và bất kỳ nơi nào chấp nhận một list. Một lưu ý: đừng dùng nó ở những nơi mà tham số yêu cầu một chuỗi đơn — bạn sẽ gặp lỗi type mismatch thay vào đó.

3. Bên trong resource khác — dùng count.index

Cả hai resource đều dùng count? Ánh xạ chúng 1-1 với count.index:

resource "aws_eip" "web" {
  count    = 3
  instance = aws_instance.web[count.index].id
}

Mỗi EIP được ghép với web instance ở cùng vị trí — EIP 0 → web[0], EIP 1 → web[1], và tiếp tục như vậy.

4. Chuyển từ count sang for_each (khuyến nghị cho các trường hợp phức tạp)

Việc quản lý index trở nên lộn xộn? Đó là dấu hiệu nên chuyển sang for_each. Khóa dạng chuỗi thay thế index dạng số — dễ đọc hơn, và an toàn khi thêm hoặc xóa item giữa danh sách:

variable "web_names" {
  default = ["web-a", "web-b", "web-c"]
}

resource "aws_instance" "web" {
  for_each      = toset(var.web_names)
  ami           = "ami-0c55b159cbfafe1f0"
  instance_type = "t3.micro"

  tags = {
    Name = each.key
  }
}

output "web_ips" {
  value = { for k, v in aws_instance.web : k => v.private_ip }
}

Với count thông thường, việc xóa "web-b" sẽ dịch chuyển mọi index phía trên nó — Terraform coi "web-c" là đã thay đổi và lên kế hoạch destroy/recreate. Với for_each, mỗi instance có một khóa chuỗi ổn định, nên việc xóa "web-b" chỉ ảnh hưởng đến "web-b".

Trường hợp đặc biệt: count = 1 vẫn cần index

Điều này thường khiến mọi người bất ngờ. Dù chỉ là count = 1, resource vẫn bị chuyển thành một danh sách:

resource "aws_instance" "bastion" {
  count         = 1
  ami           = "ami-0c55b159cbfafe1f0"
  instance_type = "t3.micro"
}

# Vẫn báo lỗi:
resource "aws_eip" "bastion" {
  instance = aws_instance.bastion.id   # LỖI
}

# Đúng:
resource "aws_eip" "bastion" {
  instance = aws_instance.bastion[0].id
}

Những nơi thường gặp lỗi này

• Outputs — tham chiếu trực tiếp resource.name.attribute thay vì dùng index
• Tham số của resource phụ thuộc — truyền một ID hoặc ARN vào resource phụ thuộc vào một counted resource
• Locals — tính một giá trị dẫn xuất từ attribute của counted resource
• Module inputs — truyền một biến single-value mà tham số yêu cầu string, không phải list

Xác nhận kết quả sửa

Hai lệnh để xác nhận mọi thứ đã được kết nối đúng. Đầu tiên, kiểm tra cú pháp:

terraform validate

Success! The configuration is valid.

Sau đó chạy plan. Output block hoặc resource phụ thuộc sẽ hiển thị giá trị thực — một địa chỉ IP, một ID, một ARN — mà không có lỗi:

terraform plan

Nếu có gì đó bất ngờ bị đánh dấu để thay thế, hãy kiểm tra lại index bạn đã tham chiếu.

Bảng tham chiếu nhanh

• resource.name[0] — instance đầu tiên
• resource.name[count.index] — index hiện tại, bên trong một counted resource khác
• resource.name[*].attr — tất cả instance, trả về một list
• resource.name[length(resource.name) - 1] — instance cuối cùng
• { for k, v in resource.name : k => v.attr } — duyệt qua một for_each resource