OS X运行Jenkins执行kubectl时提示aws可执行文件未找到如何解决

问题原因 #

macOS上Jenkins默认以独立服务用户身份运行，不会加载你当前登录用户的shell环境变量配置，因此即使本地用户可以正常执行aws命令，Jenkins构建环境的PATH中没有包含aws-cli的安装路径，就会触发找不到可执行文件的报错。

解决方法 #

方法1：流水线内临时配置PATH（无需全局修改） #

首先在本地终端执行which aws获取aws-cli的绝对路径，通常默认安装路径为/usr/local/bin/aws，对应目录为/usr/local/bin。
在执行kubectl的流水线步骤前，将对应目录加入当前构建的PATH变量即可：

stage('部署蓝容器') {
  steps {
    sh '''
      export PATH=$PATH:/usr/local/bin
      echo 'Deploy blue container...'
      /usr/local/bin/kubectl apply -f ./blue/blue.yaml
    '''
  }
}

方法2：Jenkins全局配置PATH（一次配置永久生效） #

如果不想每次写流水线都加PATH配置，可以直接在Jenkins全局设置中添加：

• 打开Jenkins控制台 → 管理Jenkins → 系统配置
• 找到全局属性板块，勾选环境变量
• 新增环境变量：
  • 变量名：PATH+EXTRA
  • 变量值：/usr/local/bin（替换为你本地which aws返回的目录路径）
• 保存配置后重启Jenkins服务生效

方法3：修改kubeconfig指定aws绝对路径 #

如果不需要修改Jenkins配置，也可以直接调整Kubernetes认证配置，显式指定aws的执行路径：
打开kubeconfig文件（需注意是Jenkins运行用户读取的kubeconfig，不是你本地登录用户的配置），找到认证插件段落，修改command字段为绝对路径：

users:
- name: 你的EKS集群用户名
  user:
    exec:
      apiVersion: client.authentication.k8s.io/v1beta1
      # 把原来的command: aws替换为绝对路径
      command: /usr/local/bin/aws
      args:
      - eks
      - get-token
      - --region
      - us-east-1
      - --cluster-name
      - 你的集群名称

修改后保存即可直接生效。

排查小技巧 #

如果配置完成后仍报错，可以在流水线中添加临时步骤排查环境配置：

sh 'echo $PATH && which aws'

该步骤会输出当前构建环境的PATH变量和aws可执行文件的识别路径，方便定位配置问题。

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