快捷導(dǎo)航

Kubernetes從私有鏡像倉庫拉取容器鏡像時(shí)的身份驗(yàn)證方式

更新時(shí)間：2026年01月26日 15:43:30 作者：ICT董老師

Kubernetes從私有鏡像倉庫拉取容器鏡像時(shí),需要使用私有倉庫的憑證進(jìn)行身份驗(yàn)證,這些憑證可以存儲在`private-registry-auth`這個(gè)Secret中,然后在Pod或ServiceAccount中指定使用該Secret,這樣可以確保Pod在拉取鏡像時(shí)能夠正確進(jìn)行身份驗(yàn)證

Kubernetes從私有鏡像倉庫拉取容器鏡像時(shí)的身份驗(yàn)證

1.訪問私有鏡像倉庫

當(dāng)你的Docker鏡像存儲在私有鏡像倉庫（如私有Docker Hub、Harbor、ACR、ECR等）時(shí)，需要憑據(jù)才能拉取鏡像。

當(dāng)Pod被調(diào)度到某個(gè)節(jié)點(diǎn)上時(shí)，kubelet會嘗試?yán)od中指定的鏡像。如果鏡像位于私有倉庫，kubelet就會使用private-registry-auth這個(gè)Secret中的憑證去拉取。

注意：如果Pod中指定了多個(gè)鏡像，且來自不同的私有倉庫，那么可能需要多個(gè)imagePullSecret，每個(gè)對應(yīng)一個(gè)倉庫?；蛘撸部梢詣?chuàng)建一個(gè)包含多個(gè)倉庫憑證的Secret（但一個(gè)Secret通常只對應(yīng)一個(gè)倉庫）。

另外，除了在Pod級別指定imagePullSecrets，還可以在ServiceAccount級別指定，這樣所有使用該ServiceAccount的Pod都會自動(dòng)使用這些imagePullSecrets，避免了在每個(gè)Pod中重復(fù)配置。

2.提供認(rèn)證憑據(jù)

private-registry-auth 是一個(gè)提前創(chuàng)建的Secret對象，包含：

用戶名和密碼
或Docker配置JSON文件
或訪問令牌

創(chuàng)建對應(yīng)的Secret

需要提前創(chuàng)建這個(gè)Secret：

# 方法1：使用用戶名密碼創(chuàng)建
kubectl create secret docker-registry private-registry-auth \
  --docker-server=<registry-url> \
  --docker-username=<username> \
  --docker-password=<password> \
  --docker-email=<email>

# 方法2：使用已有的docker config文件
kubectl create secret generic private-registry-auth \
  --from-file=.dockerconfigjson=/path/to/.docker/config.json \
  --type=kubernetes.io/dockerconfigjson

使用場景示例

yaml

apiVersion: apps/v1
kind: Deployment
metadata:
  name: myapp
spec:
  replicas: 3
  template:
    spec:
      imagePullSecrets:
      - name: private-registry-auth  # 引用之前創(chuàng)建的Secret
      containers:
      - name: app
        image: private-registry.example.com/mycompany/app:v1.0  # 私有鏡像

工作原理

Pod創(chuàng)建時(shí)：kubelet從私有倉庫拉取鏡像
身份驗(yàn)證：使用imagePullSecrets中的憑據(jù)進(jìn)行認(rèn)證
鏡像拉取：認(rèn)證成功后拉取鏡像到節(jié)點(diǎn)

最佳實(shí)踐

yaml

# 可以將imagePullSecrets綁定到ServiceAccount
apiVersion: v1
kind: ServiceAccount
metadata:
  name: default
imagePullSecrets:
- name: private-registry-auth  # 所有使用這個(gè)SA的Pod都會自動(dòng)繼承

# 然后在Pod中引用這個(gè)ServiceAccount
apiVersion: v1
kind: Pod
metadata:
  name: mypod
spec:
  serviceAccountName: default  # 自動(dòng)獲得imagePullSecrets
  containers:
  - name: app
    image: private.registry/app:v1

替代方案比較

方式	優(yōu)點(diǎn)	缺點(diǎn)
Pod級imagePullSecrets	靈活，不同Pod可用不同憑據(jù)	每個(gè)Pod都要配置
ServiceAccount級	統(tǒng)一管理，減少重復(fù)配置	所有使用該SA的Pod共享憑據(jù)
節(jié)點(diǎn)級配置	在節(jié)點(diǎn)docker daemon配置	不推薦，安全性差

這個(gè)配置是現(xiàn)代Kubernetes安全實(shí)踐中保護(hù)私有鏡像訪問的重要部分。