Jenkins Pipeline执行kubectl命令提示not found问题求助

问题根源 #

Jenkins通过sshagent发起的SSH连接属于非交互式非登录shell，不会自动加载目标服务器用户的~/.bashrc、~/.profile等配置文件，导致microk8s的kubectl路径未加入环境变量，或microk8s的别名未生效——这就是手动执行正常但Jenkins执行报错的核心原因。

具体修复方案 #

1. 使用kubectl的绝对路径执行 #

先在目标服务器上手动执行以下命令获取microk8s.kubectl的绝对路径：

which microk8s.kubectl

通常结果为/snap/bin/microk8s.kubectl，然后在Jenkinsfile中直接替换为该绝对路径：

sshagent(['k8s_key']) {
    sh 'scp deployment-remes-be.yaml user@your-server:/tmp/'
    sh 'ssh user@your-server "/snap/bin/microk8s.kubectl apply -f /tmp/deployment-remes-be.yaml"'
}

2. 显式加载环境配置文件 #

如果不想用绝对路径，可在SSH命令中手动加载用户的bash配置文件，强制导入环境变量：

sshagent(['k8s_key']) {
    sh 'scp deployment-remes-be.yaml user@your-server:/tmp/'
    sh 'ssh user@your-server "source ~/.bashrc && kubectl apply -f /tmp/deployment-remes-be.yaml"'
}

若需要指定kubeconfig，可结合绝对路径一起使用：

sh 'ssh user@your-server "/snap/bin/microk8s.kubectl apply -f /tmp/deployment-remes-be.yaml --kubeconfig ~/.kube/config"'

3. 验证Jenkins SSH登录的用户上下文 #

确认Jenkins使用SSH登录的用户与你手动执行命令的用户一致，避免因用户不同导致环境变量、kubeconfig权限差异。可先在Jenkinsfile中添加验证命令：

sh 'ssh user@your-server "whoami && echo $PATH && ls -la ~/.kube/"'

如果用户不一致，可：

• 修改Jenkins SSH配置，切换到正确的用户
• 给当前Jenkins登录用户添加microk8s权限：

  sudo usermod -aG microk8s jenkins-user
  sudo chown -R jenkins-user ~jenkins-user/.kube
  

4. 跳过SSH，直接在Jenkins中配置K8s访问（可选优化） #

若Jenkins节点本身可访问目标K8s集群，可直接使用Jenkins的Kubernetes插件，无需通过SSH中转：

1. 在Jenkins中配置kubeconfig凭证（将目标服务器的.kube/config内容作为凭证存储）
2. 在Jenkinsfile中使用withKubeConfig步骤执行命令：

   withKubeConfig(credentialsId: 'your-kubeconfig-cred-id') {
       sh 'kubectl apply -f deployment-remes-be.yaml'
   }
   

内容的提问来源于stack exchange，提问作者cs.kali