EC2LaunchV2无法获取主IPv4地址导致主机名设置失败

你遇到的问题是EC2LaunchV2执行postReady-setHostName任务时无法识别实例私有IP，但系统本身能通过ipconfig查到IP，可从以下几个方向排查解决：

1. 任务执行时机过早 #

EC2LaunchV2的主机名设置任务可能在实例网络栈完全初始化前就触发了——虽然后续ipconfig能查到IP，但任务执行时网卡还未完成DHCP绑定或IP注册。

• 调整任务执行延迟：编辑C:\ProgramData\Amazon\EC2Launch\config\agent_config.yml，找到postReady-setHostName任务配置，添加延迟参数，确保网络就绪后再执行：

  tasks:
    - name: postReady-setHostName-0
      type: setHostName
      execWait: 15s # 可根据实例启动速度调整时长
      ... # 保留原有其他配置
  

2. 主网卡识别逻辑异常 #

如果实例有多网卡，或者主网卡的DHCP状态存在异常，EC2LaunchV2可能无法正确定位到承载私有IP的主网卡。

• 指定主网卡MAC地址：编辑C:\ProgramData\Amazon\EC2Launch\config\hostname_config.yml，通过MAC地址明确指定主网卡，避免自动识别出错：

  hostname:
    type: ip
    ip:
      filter:
        mac_address: "你的主网卡MAC地址" # 可通过ipconfig获取
  

• 检查网卡DHCP状态：确保主网卡的DHCP已启用，且能正常获取IP地址（可在打包AMI前确认配置）。

3. Packer打包时未重置EC2LaunchV2状态 #

用Packer制作AMI时，如果没有清除原实例的EC2LaunchV2缓存，新实例启动会继承旧的网络配置信息，干扰IP检测。

• 打包前重置EC2LaunchV2：在Packer的Windows provisioner中添加PowerShell命令，清理原有配置：

  & "C:\Program Files\Amazon\EC2Launch\EC2Launch.exe" reset
  

  这条命令要在AMI创建前执行，确保新实例启动时EC2LaunchV2处于初始状态。

4. EC2LaunchV2版本存在bug #

旧版本的EC2LaunchV2可能存在网络检测逻辑缺陷，导致无法正确获取私有IP。

• 升级到最新版本：在Packer的provisioner中添加升级步骤，确保AMI中包含最新版EC2LaunchV2：

  Invoke-WebRequest -Uri "https://s3.amazonaws.com/ec2-downloads-windows/EC2Launch/latest/EC2LaunchInstaller.exe" -OutFile "EC2LaunchInstaller.exe"
  .\EC2LaunchInstaller.exe /install /quiet
  

日志验证 #

你提供的日志明确指向IP获取失败：

2023-09-14 21:32:00 Info: Stage: postReadyUserData completed.
2023-09-14 21:32:00 Info: Run StartSsm task.
2023-09-14 21:32:00 Info: AmazonSSMAgent service already running.
2023-09-14 21:32:00 Info: AmazonSSMAgent is running now.
2023-09-14 21:32:00 Error: Error running task: failed to run task 'postReady-setHostName-0': Primary IP address not found.
2023-09-14 21:32:00 Info: Stage: postReady completed.

按照上述步骤调整后，可重启实例查看C:\ProgramData\Amazon\EC2Launch\log\agent.log，确认任务是否正常执行。

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