使用GitRepo Volume的Pod挂载失败求助（K8s实战示例问题）

问题根源 #

从Pod事件日志里可以明确两个核心问题：

1. MountVolume.SetUp failed for volume "html" : failed to exec 'git clone -- git@github.com:xxxxx/kubia-website-example.git .': : executable file not found in $PATH
   • 调度Pod的节点（这里是minikube）未安装git客户端，kubelet无法执行git clone命令
2. 挂载超时是git命令执行失败引发的连锁结果

解决方案 #

方案1：给节点安装git客户端（临时测试用） #

直接登录minikube节点安装git：

# 进入minikube节点
minikube ssh
# 根据节点系统选择安装命令
# Debian/Ubuntu系
sudo apt update && sudo apt install -y git
# CentOS/RHEL系
sudo yum install -y git

安装完成后删除现有Pod，让Deployment重新创建：

kubectl delete pod gitrepo-vol-deploy-b59f686cf-hzlts -n book

方案2：解决私有仓库的SSH权限问题 #

如果你的GitHub仓库是私有的，即使节点有git，还需配置SSH密钥：

1. 在minikube节点生成密钥对：

   minikube ssh
   ssh-keygen -t ed25519 -C "your_email@example.com"  # 一路回车，不要设置密码
   cat ~/.ssh/id_ed25519.pub
   

2. 复制公钥，添加到GitHub账户的「Settings > SSH and GPG keys」中
3. 将GitHub添加到节点的可信主机列表：

   ssh-keyscan github.com >> ~/.ssh/known_hosts
   

方案3：改用HTTPS地址（避免SSH配置） #

把Deployment中的仓库地址替换为HTTPS格式，使用GitHub个人访问令牌（PAT）认证：

apiVersion: apps/v1
kind: Deployment
metadata: 
  name: gitrepo-vol-deploy
  namespace: book 
spec:
  replicas: 1
  selector:
    matchLabels:
      app: git-repo-as-vol-1
      type: volumes
  template:
    metadata:
      labels: 
        app: git-repo-as-vol-1
        type: volumes
    spec: 
      containers:
      - image: nginx
        name: web-server
        volumeMounts:
        - name: html
          mountPath: /usr/share/nginx/html
          readOnly: true
        ports:
        - containerPort: 80
          protocol: TCP
      volumes:
      - name: html
        gitRepo:
          repository: https://<你的PAT令牌>@github.com/xxxxxx/kubia-website-example.git
          revision: master
          directory: .

注意：替换<你的PAT令牌>为自己的GitHub令牌，令牌需拥有repo权限。

方案4：用InitContainer替代废弃的GitRepo Volume（推荐） #

GitRepo Volume在Kubernetes 1.14+已被废弃，官方推荐用InitContainer拉取代码并挂载到EmptyDir：

apiVersion: apps/v1
kind: Deployment
metadata: 
  name: gitrepo-vol-deploy
  namespace: book 
spec:
  replicas: 1
  selector:
    matchLabels:
      app: git-repo-as-vol-1
      type: volumes
  template:
    metadata:
      labels: 
        app: git-repo-as-vol-1
        type: volumes
    spec: 
      initContainers:
      - name: git-clone
        image: alpine/git  # 自带git的轻量镜像
        command:
        - git
        - clone
        - --depth=1  # 浅克隆，提升拉取速度
        - -b
        - master
        - git@github.com:xxxxxx/kubia-website-example.git
        - /html
        volumeMounts:
        - name: html
          mountPath: /html
        # 私有仓库需挂载SSH密钥，取消下方注释并配置Secret
        # volumeMounts:
        # - name: ssh-key
        #   mountPath: /root/.ssh
      containers:
      - image: nginx
        name: web-server
        volumeMounts:
        - name: html
          mountPath: /usr/share/nginx/html
          readOnly: true
        ports:
        - containerPort: 80
          protocol: TCP
      volumes:
      - name: html
        emptyDir: {}
      # 私有仓库需添加密钥Secret，取消下方注释并创建对应Secret
      # - name: ssh-key
      #   secret:
      #     secretName: github-ssh-key
      #     items:
      #     - key: id_ed25519
      #       path: id_ed25519
      #     - key: known_hosts
      #       path: known_hosts

说明：该方案无需节点安装git，所有操作在容器内完成，更符合Kubernetes容器化理念。

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