主机已登录Azure ACR,挂载docker socket的容器能否复用授权拉取镜像?
当前部署场景为:将原有Jenkins服务迁移至Azure节点,节点侧已执行az login -i、az acr login -n myregistry完成认证,主机本身可正常拉取myregistry私有镜像。
业务容器(即Jenkins容器)已映射主机Docker Socket至容器内部,本应可直接调用主机Docker引擎执行镜像拉取操作,但容器内执行docker pull时返回未授权报错:
docker:守护进程返回错误:请求
https://myregistry.azurecr.io/v2/myimage/manifests/mytag时:未授权,需要身份验证。
执行docker run --help可查看帮助信息。
需求约束:不修改原有容器镜像,复用主机已完成的ACR授权能力,验证是否可通过挂载主机登录凭证目录实现目标。
Docker的认证逻辑为客户端侧校验:docker login的凭证默认存储在客户端的~/.docker/config.json中,CLI执行pull/push操作时,会先从该配置中匹配对应Registry的认证信息,随请求一并发送给Docker Daemon。
当前容器内的Docker CLI没有对应ACR的认证配置,发送拉取请求时未携带有效凭证,因此被Registry拦截返回未授权错误。
方案1:挂载主机Docker认证配置(优先推荐)
该方案完全匹配「挂载主机登录凭证目录」的思路,可行性已验证,操作步骤如下:
- 确认主机侧ACR凭证存储路径:
- 若使用root用户执行
az acr login,凭证文件路径为/root/.docker/config.json - 若使用普通用户执行
az acr login,凭证文件路径为/home/[用户名]/.docker/config.json
- 若使用root用户执行
- 部署业务容器时,额外增加挂载参数:
将主机上的.docker目录挂载到容器内对应路径(容器内Docker CLI默认读取/root/.docker/config.json,若容器内运行用户为非root,需挂载到对应用户家目录的.docker路径),示例参数:-v /root/.docker:/root/.docker:ro
(:ro表示只读挂载,避免容器内修改主机凭证文件,提升安全性) - 特殊场景补充处理:
若主机侧config.json中配置了credsStore(凭证存储助手)字段(使用Azure ACR专用凭证助手时会自动生成该配置),仅挂载config.json无法正常解析凭证,还需将主机上对应的凭证助手二进制文件挂载到容器的可执行路径:- 先在主机上执行
which docker-credential-acr查询凭证助手路径,通常输出路径为/usr/bin/docker-credential-acr - 部署容器时额外增加挂载:
-v /usr/bin/docker-credential-acr:/usr/bin/docker-credential-acr:ro
保证容器内可正常调用该工具解析认证token即可。
- 先在主机上执行
方案2:最小权限挂载(避免泄露其他Registry凭证)
若主机的config.json中存储了其他私有Registry的敏感凭证,不想全部暴露给业务容器,可采用该方案:
- 在主机上创建专用凭证目录,比如
/opt/acr-credential/.docker/ - 从主机原有的
config.json中单独提取myregistry.azurecr.io对应的认证字段,写入该目录下的config.json,仅保留ACR相关的认证信息,删除其他无关配置 - 部署业务容器时挂载该专用目录到容器的
/root/.docker路径即可,不会泄露其他Registry的凭证信息。
方案3:凭证自动刷新配置
az acr login默认生成的ACR凭证有效期为1小时,为避免凭证过期导致容器内拉取失败,可在主机上配置定时任务,每分钟校验凭证有效性,过期自动刷新:
# 示例定时任务,执行az acr login刷新凭证,静默执行避免报错 */1 * * * * root az acr login -n myregistry > /dev/null 2>&1
由于挂载的是主机实时文件,主机侧刷新凭证后,容器无需重启即可自动读取最新凭证,无感知完成认证。
以上方案均无需修改原有容器镜像,仅需调整容器部署的挂载参数即可,完全符合需求约束。其中方案1为最低成本实现方式,方案2为安全最优实现方式,可根据自身业务需求选择。
内容的提问来源于stack exchange,提问作者MaratC

