Jenkins部署Laravel至AWS EKS时Kubectl认证失败求助

API 探路者

2026-6-28

解决方案

1. 检查Jenkins `K8S`凭证配置

确认K8S凭证是有效且完整的kubeconfig文件，包含EKS集群的正确API地址、CA证书，以及具备Namespace创建权限的用户凭证。
若使用IAM角色访问EKS，kubeconfig的用户段需配置exec命令调用aws eks get-token（静态token易过期，不推荐）。

2. 改用AWS CLI生成临时kubeconfig

如果Jenkins节点已配置有权访问EKS的IAM凭证（角色/AK/SK），可直接在流水线中生成有效kubeconfig，替代withKubeConfig：

stage('K8S Deploy') {
    steps {
        script {
            sh 'pwd'
            sh 'ls'
            sh 'kubectl version'
            // 替换为你的EKS集群名称
            sh """aws eks update-kubeconfig --region ${AWS_DEFAULT_REGION} --name your-eks-cluster-name"""
            sh '''
                cd deployment
                cat namespace.yml
                kubectl apply -f namespace.yml
            '''
        }
    }
}

确保Jenkins节点的IAM权限包含eks:DescribeCluster、eks:GetToken，以及Kubernetes中创建Namespace的权限。

3. 临时关闭kubectl验证（仅用于排查）

若仅验证环节报错，可添加参数跳过验证完成部署：

sh '''
    cd deployment
    cat namespace.yml
    kubectl apply -f namespace.yml --validate=false
'''

此为临时方案，不建议长期使用。

4. 验证AWS凭证有效性

在流水线中添加步骤，确认Jenkins节点能正常访问EKS集群：

stage('Verify AWS Access') {
    steps {
        // 替换为你的EKS集群名称
        sh """aws eks describe-cluster --region ${AWS_DEFAULT_REGION} --name your-eks-cluster-name"""
    }
}