如何在EC2实例上获取AWS CloudFormation堆栈名称以用于cfn-init命令

方法1：模板注入堆栈名称（最直接可靠） #

在CloudFormation模板中，直接将堆栈名称通过用户数据或实例标签注入到EC2实例中，后续直接读取即可：

• 用户数据方式（Windows PowerShell）：
  在EC2资源的UserData中添加配置，将堆栈名称写入系统环境变量或本地文件：

  <powershell>
  # 将堆栈名称写入系统环境变量（永久生效）
  [Environment]::SetEnvironmentVariable("CFN_STACK_NAME", "${AWS::StackName}", "Machine")
  # 或者写入本地文件
  "${AWS::StackName}" | Out-File -Path "C:\cfn_stack_name.txt" -Encoding ASCII
  </powershell>
  

  后续运行cfn-init时直接调用：

  $stackName = [Environment]::GetEnvironmentVariable("CFN_STACK_NAME", "Machine")
  cfn-init --stack $stackName --resource YourEC2ResourceName --configsets YourConfigSet --region ${AWS::Region}
  

• 实例标签方式：
  在EC2资源的Tags中添加标签：

  Tags:
    - Key: CFN_StackName
      Value: !Sub "${AWS::StackName}"
  

  通过AWS CLI读取标签：

  # 从元数据获取当前实例ID
  $instanceId = Invoke-RestMethod -Uri http://169.254.169.254/latest/meta-data/instance-id
  # 查询标签获取堆栈名称
  $stackName = (aws ec2 describe-tags --filters "Name=resource-id,Values=$instanceId" "Name=key,Values=CFN_StackName" --query "Tags[0].Value" --output text)
  

方法2：通过AWS CLI反向查询关联堆栈（无需模板修改） #

如果无法修改现有模板，可利用EC2实例ID反向查询所属的CloudFormation堆栈：

1. 从元数据获取当前实例ID：

   $instanceId = Invoke-RestMethod -Uri http://169.254.169.254/latest/meta-data/instance-id
   

2. 调用CloudFormation CLI查询堆栈名称：

   $stackName = (aws cloudformation describe-stack-resources --physical-resource-id $instanceId --query "StackResources[0].StackName" --output text)
   

   注意：此方法需要EC2实例的IAM角色拥有cloudformation:DescribeStackResources权限。

方法3：读取cfn-init状态文件（备选方案） #

cfn-init运行后会在实例上生成日志文件，可从中提取已使用过的堆栈名称：

$stackName = (Select-String -Path "C:\cfn\cfn-init.log" -Pattern "--stack (\S+)" | Select-Object -First 1 | ForEach-Object { $_.Matches.Groups[1].Value })

此方法仅适用于已运行过cfn-init的实例，可靠性不如前两种，仅作为应急备选。

内容的提问来源于stack exchange，提问作者Martin Hollingsworth