Jenkins任务启停AWS EC2实例遇ProfileNotFound错误的解决咨询

这个错误我之前在配置Jenkins启停EC2实例任务时也碰到过，核心原因就是AWS CLI在Jenkins的运行环境里找不到你指定的xxxx配置文件。给你几个排查和解决的方向：

1. 检查Jenkins运行用户的AWS配置文件 #

Jenkins通常是以jenkins系统用户运行的，它的家目录和你本地用户的家目录不是同一个。你需要确认这个用户的.aws目录下的配置文件里存在xxxx这个profile：

• 在Jenkins任务里添加一个前置Shell步骤，执行以下命令查看当前可用的profile：

  aws configure list-profiles
  cat ~/.aws/config
  cat ~/.aws/credentials
  

• 如果找不到xxxx，你可以通过以下命令在Jenkins运行环境中配置这个profile：

  aws configure --profile xxxx
  

  （注意要在Jenkins的执行环境中运行，比如通过Jenkins的"Execute shell"步骤，或者直接登录到Jenkins服务器切换到jenkins用户执行）

2. 验证环境变量是否正确传递 #

有时候问题出在环境变量的拼写或传递上：

• 在执行EC2启停命令前，先添加echo命令确认变量值：

  echo "当前使用的AWS_PROFILE: $AWS_PROFILE"
  echo "当前使用的AWS_DEFAULT_REGION: $AWS_DEFAULT_REGION"
  

  确认输出的$AWS_PROFILE和你配置文件里的profile名称完全一致（注意大小写敏感）。
• 如果Jenkins任务是通过参数化构建传递的AWS_PROFILE，要检查参数的默认值或输入值是否正确。

3. 改用环境变量传递AWS凭证（更适合CI/CD场景） #

在Jenkins这类CI/CD环境中，直接用环境变量传递AWS凭证比依赖本地配置文件更可靠，也避免了profile找不到的问题：

• 在Jenkins的任务配置中，添加两个环境变量：AWS_ACCESS_KEY_ID和AWS_SECRET_ACCESS_KEY（建议用Jenkins的凭证管理存储，选择"Secret text"类型，然后通过"Inject environment variables"插件注入，避免明文暴露）。
• 修改你的启停命令，去掉--profile $AWS_PROFILE参数：

  aws ec2 stop-instances --region $AWS_DEFAULT_REGION --instance-ids $INSTANCE
  

  AWS CLI会自动优先使用这两个环境变量中的凭证，不需要依赖profile配置。

4. 指定自定义的AWS配置文件路径 #

如果你的AWS配置文件不在默认的~/.aws目录下，可以通过环境变量指定路径：

• 在Jenkins任务的Shell步骤开头添加：

  export AWS_CONFIG_FILE=/path/to/your/aws/config
  export AWS_SHARED_CREDENTIALS_FILE=/path/to/your/aws/credentials
  

  确保这两个路径指向包含xxxxprofile的配置文件，然后再执行启停命令。

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