当前位置：首页 > article >正文

Helm Chart 中配置多个 Docker Registry 地址以实现备用访问

article 2025/9/13 10:02:09

在 Helm Chart 中配置多个 Docker Registry 地址以实现备用访问，可以通过以下几种方式实现：

1. 在 values.yaml 中定义多个 Registry

在 values.yaml 中定义主 Registry 和备用 Registry，以便在部署时灵活切换：

# values.yaml
image:primaryRegistry: "primary-registry.example.com"  # 主 RegistrysecondaryRegistry: "secondary-registry.example.com"  # 备用 Registryname: "my-image"tag: "v1.0.0"pullPolicy: IfNotPresent

2. 在 Deployment 中通过环境变量选择 Registry

在 templates/deployment.yaml 中根据条件选择使用主 Registry 或备用 Registry：

# templates/deployment.yaml
apiVersion: apps/v1
kind: Deployment
spec:template:spec:containers:- name: {{ .Chart.Name }}image: {{ if .Values.useSecondaryRegistry }}{{ .Values.image.secondaryRegistry }}{{ else }}{{ .Values.image.primaryRegistry }}{{ end }}/{{ .Values.image.name }}:{{ .Values.image.tag }}imagePullPolicy: {{ .Values.image.pullPolicy }}

部署时通过 --set 参数指定使用备用 Registry：

helm install my-release . --set useSecondaryRegistry=true

3. 使用 Init Container 动态选择 Registry

通过 Init Container 检查主 Registry 可用性，不可用时切换到备用 Registry：

# templates/deployment.yaml
apiVersion: apps/v1
kind: Deployment
spec:template:spec:initContainers:- name: check-registryimage: alpine:3.14command: ["/bin/sh", "-c"]args:- |# 检查主 Registry 是否可访问if wget -q --spider ${image.primaryRegistry}/${image.name}:${image.tag}; thenecho ${image.primaryRegistry}/${image.name}:${image.tag} > /tmp/imageelseecho ${image.secondaryRegistry}/${image.name}:${image.tag} > /tmp/imagefienv:- name: imagevalue: {{ .Values.image.primaryRegistry }}- name: namevalue: {{ .Values.image.name }}- name: tagvalue: {{ .Values.image.tag }}volumeMounts:- name: image-configmountPath: /tmpcontainers:- name: {{ .Chart.Name }}image: $(cat /tmp/image)  # 使用 Init Container 确定的镜像地址volumeMounts:- name: image-configmountPath: /tmpvolumes:- name: image-configemptyDir: {}

4. 使用 Helm 模板函数实现条件选择

在 _helpers.tpl 中定义辅助函数，根据 Registry 可用性返回正确的地址：

# templates/_helpers.tpl
{{/* 获取可用的镜像地址 */}}
{{- define "mychart.image" -}}
{{- if .Values.useSecondaryRegistry -}}
{{ .Values.image.secondaryRegistry }}/{{ .Values.image.name }}:{{ .Values.image.tag }}
{{- else -}}
{{ .Values.image.primaryRegistry }}/{{ .Values.image.name }}:{{ .Values.image.tag }}
{{- end -}}
{{- end -}}

在 Deployment 中引用该函数：

# templates/deployment.yaml
containers:- name: {{ .Chart.Name }}image: {{ include "mychart.image" . }}

5. 通过 Helm Hooks 实现故障转移

使用 Pre-Upgrade/Pre-Rollback Hooks 在部署前检查 Registry 可用性：

# templates/hooks/check-registry.yaml
apiVersion: batch/v1
kind: Job
metadata:name: {{ .Release.Name }}-check-registryannotations:"helm.sh/hook": pre-upgrade,pre-install"helm.sh/hook-delete-policy": hook-succeeded
spec:template:spec:containers:- name: checkimage: alpine:3.14command: ["/bin/sh", "-c"]args:- |if ! wget -q --spider {{ .Values.image.primaryRegistry }}/{{ .Values.image.name }}:{{ .Values.image.tag }}; thenecho "主 Registry 不可用，将使用备用 Registry"helm upgrade {{ .Release.Name }} . --set useSecondaryRegistry=truefirestartPolicy: Never

6. 在 CI/CD 流程中动态选择

在 CI/CD 脚本中根据 Registry 状态决定使用哪个 Registry：

# .gitlab-ci.yml 示例
deploy:script:- if wget -q --spider ${PRIMARY_REGISTRY}/${IMAGE_NAME}:${IMAGE_TAG}; thenhelm install my-release . --set image.registry=${PRIMARY_REGISTRY};elsehelm install my-release . --set image.registry=${SECONDARY_REGISTRY};fi