如何修改Airbyte集群中归一化流程使用的Docker镜像？

1. 通过Helm Chart Values配置全局替换 #

Airbyte的Helm Chart提供了归一化服务的镜像配置项，直接修改values.yaml即可覆盖默认镜像：

• 在你的自定义values.yaml中添加或更新以下配置块：

normalization:
  image:
    repository: 你的私有仓库域名/normalization
    tag: 0.4.3  # 需与你同步到私有仓库的镜像版本保持一致
    pullPolicy: IfNotPresent
    # 如果私有仓库需要认证，添加镜像拉取密钥
    imagePullSecrets:
      - name: 你的私有仓库密钥名称

• 执行Helm升级命令应用配置：

helm upgrade airbyte airbyte/airbyte -f 你的values.yaml -n 你的airbyte命名空间

2. 更新已创建连接的归一化镜像配置 #

对于已经创建好的连接，需要手动修改连接的归一化设置：

• 登录Airbyte UI，打开目标连接的配置页面
• 找到Normalization模块，展开后选择「Custom Docker Image」选项
• 填入私有仓库的完整镜像地址（例如your-registry/normalization:0.4.3）
• 保存连接配置，后续同步时将使用新的镜像

3. 设置全局默认归一化镜像（针对新连接） #

如果希望所有新创建的连接默认使用私有镜像，可在Airbyte工作区配置中修改全局默认值：

• 进入Airbyte UI的「Settings」→「Workspace」页面
• 找到「Normalization Default Image」配置项
• 替换为你的私有仓库镜像地址，保存设置后，新创建的连接会自动使用该镜像

注意事项 #

• 确保私有仓库中的归一化镜像与官方airbyte/normalization:0.4.3的内容完全一致，避免版本不兼容导致的同步失败
• 确认Kubernetes集群节点有权限访问私有仓库，必要时为Airbyte服务账户配置镜像拉取权限

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