Important
此功能在 Beta 版中。 要使用它,工作区管理员必须在预览页面开启Databricks工件注册表。 请参阅 Manage Azure Databricks 预览版。 Databricks将在Artifact Registry正式上线时公布其定价。
使用此页面解决文物注册表的常见问题。 关于完整的设置和镜像推送工作流程,请参见 “开始使用工件注册表”。
测试版访问问题
文物注册库未启用
请让工作区管理员在工作区预览页面启用Databricks工件注册表。 如果预览不可用,请验证工作区位于支持 Artifact Registry 的区域。 请参阅限制。
预览状态暂时不可用
重试操作。 如果错误依旧,请收集错误详情,并在请求帮助时请求ID(如有)。
Docker 认证问题
Docker 认证命令不可用
安装或更新Databricks的CLI(命令行界面)至 需求中支持的最低版本,然后再次运行 databricks auth docker configure 。
Docker 无法获取注册表凭据
创建或刷新工作区 OAuth 配置文件,配置 Docker 用于工作区注册表,并重试 Docker 操作。 运行以下命令:
databricks auth login --profile <profile>
databricks auth docker configure --profile <profile>
确认 <profile> 指向目标工作区。 如果使用默认配置文件,请从 Docker 身份验证命令中省略 --profile <profile>。
Docker 凭证助手不支持使用个人访问令牌、OAuth 机器到机器(M2M)凭证或仅使用账户进行身份验证的配置。 完整的认证步骤请参见 设置 Docker 认证。
长时间运行的推送操作会返回授权错误
Docker 凭证助手提供一个短期有效的工作区 OAuth 访问令牌。 如果长时间运行的推送返回授权错误,请重试 docker push,以便凭证帮助程序请求新的令牌。 关于证书的终身期限,请参见 “限制”。
注册表主机名不匹配
运行 databricks auth docker host --profile <profile> 以检查所选配置文件的注册表主机名和 Docker 凭证助手状态。 确认配置文件指向预期的工作区。 在重新尝试推送之前,先用正确的 注册表主机名 重新标记镜像。
图片推送问题
推送返回权限错误
验证主体是否具备推送操作所需的权限。 参见 授予权限。
图片名称被拒绝
使用 <registry-hostname>/<catalog>.<schema>.<artifact>:<tag> 格式。 关于工件段的需求,请参见 工件名称要求。
目录或模式不存在
Artifact Registry不创建目录或模式。 目标目录和模式必须已经存在于 Unity 目录中,并且可以从工作区访问。 创建缺失的对象,或者使用现有的目录和模式,然后在重试推送前验证所需的权限。
图像发现问题
该图像或版本未出现
确认 Docker 推送已成功完成,并且你当前列出的目录、架构和工件名称与你推送时使用的一致。 使用软件工件API而非注册表端点来列出工件和版本。 参见查看映像和版本。
注册表操作不受支持
注册表端点不支持此操作。 使用软件工件API来发现图片和版本。 关于限制,请参见 限制。
图像加速问题
图像加速依然存在 UNSPECIFIED
UNSPECIFIED 无法识别故障。 有关图像加速的适用条件(包括图像大小限制),请参见限制。 符合条件的图像越大,转换所需时间越长。 稍后再查看状态。 如果符合条件的映像在经过数小时后仍未到达 SUCCESS,请联系 Databricks 支持团队。 有关状态定义,请参见 “检查图像加速状态”。
寻求帮助
在请求帮助时,请填写以下信息:
云端、区域、工作区 URL 和 Databricks CLI 版本。
失败的命令及其完整的错误信息。
注册表主机名和
catalog.schema.artifact:tag名称。图片摘要、API 请求 ID 和操作时间戳(如有)。
请仅通过私人支持渠道分享这些信息。 请勿在公共论坛中发布工作区 URL、注册表主机名、制品名称或完整的错误信息。
在分享错误信息、命令输出和其他诊断信息之前,先删除其中的令牌、密码和注册表凭据。