Kubernetes Kustomize无法从远程Git仓库下载资源问题求解决方案

正确配置步骤 #

1. 规范远程地址写法 #

Kustomize 远程资源地址有固定格式，你之前尝试的git::、ssh::前缀是Terraform的地址规则，Kustomize 不识别，会被判定为本地路径。
正确的SSH协议私有仓库地址格式为：

resources:
  - ssh://git@<仓库域名>:<SSH端口>/<仓库所属组织/用户名>/<仓库名>.git//<仓库内Kustomize配置所在的相对路径>?ref=<分支名/标签名/CommitID>

注意：地址中的//是分隔符，用来指定仓库内的子路径，即使配置在仓库根目录，也需要保留//，后面跟空路径即可
示例：要拉取git@git.example.com:2222/dev/k8s-base.git仓库main分支下/base/prod目录的Kustomize配置，写法为：

resources:
  - ssh://git@git.example.com:2222/dev/k8s-base.git//base/prod?ref=main

2. 配置SSH访问权限 #

Kustomize 拉取远程仓库时会调用执行命令用户的本地SSH配置，需要提前配置好仓库的访问权限：

• 本地开发环境：确保~/.ssh目录下存放了对应Git仓库的可读写私钥，文件权限设置为600
• 流水线/容器环境：提前将私钥挂载到执行用户的~/.ssh目录，或者将私钥加入ssh-agent
• 可在~/.ssh/config中添加仓库专属配置，避免端口识别异常：

Host git.example.com
  Port 2222
  User git
  IdentityFile ~/.ssh/your_private_key
  StrictHostKeyChecking no

3. 版本兼容校验 #

如果使用kubectl apply -k调用内置Kustomize，需要确保kubectl版本 >= 1.21，低版本内置的Kustomize存在远程拉取相关缺陷。建议单独安装最新版Kustomize二进制，先执行kustomize build .验证可以正常渲染配置，再执行部署操作。

4. 常见避坑点 #

• 不要额外添加git::、ssh::等自定义前缀
• 地址末尾不要留多余空格、换行符
• ref参数必须跟在路径之后，使用?连接，不指定ref会默认拉取默认分支的最新提交

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