开始使用 Artifact Registry

Important

此功能在 Beta 版中。 要使用它,工作区管理员必须在预览页面开启Databricks工件注册表。 请参阅 Manage Azure Databricks 预览版。 Databricks将在Artifact Registry正式上线时公布其定价。

使用 Artifact Registry 通过 Docker 推送容器镜像,并在 Unity Catalog 中对其进行管理。

本页展示了如何配置认证、授权访问、推送图片以及发现图片。 有关概念和限制,请参见 工件注册表。 如果命令或操作失败,请参见 故障排查工件注册表。

Requirements

在开始之前,您需要具备以下条件:

  • 支持工件注册表的区域工作区。 请参阅限制。

  • Databricks CLI(命令行界面)版本 1.18.0 或更高安装在本地机器上。

  • Docker CLI安装在你的本地机器上。

  • 一个现有的 Unity 目录和模式,可以从工作区访问。

  • 执行此操作所需的 Unity Catalog 权限。

设置 Docker 身份验证

Databricks CLI 包含一个实验性命令,可以配置 Docker 以请求工作区注册表的凭证。 Docker 凭据帮助程序需要由 databricks auth login 创建的工作区 OAuth 配置文件。 它不支持使用个人访问令牌、OAuth 机器对机器(M2M)凭证或仅账户认证的配置文件。

  1. 创建或刷新目标工作区的配置文件:

    databricks auth login --profile <profile>
    
  2. 为工作区注册表配置 Docker 认证:

    databricks auth docker configure --profile <profile>
    

    省略 --profile <profile> 以使用默认的 Databricks CLI 配置文件。

    Databricks CLI 推断注册表区域并打印工作区注册表主机名。 在您推送镜像时使用此主机名。

授予权限

工件注册处不创建目录或模式。 两者都必须已经存在于 Unity 目录中,并且能从工作区访问。

Artifact Registry 利用 Unity 目录权限来控制图像访问。 下表显示了每个操作的最低权限授予。 更广泛的管理权限也可以授权部分操作。

Operation 最小权限授权
推送新构件 USE CATALOG、 USE SCHEMA和 CREATE VOLUME
推送新版本或移动标签 USE CATALOG、 USE SCHEMA和 WRITE VOLUME
发现文物与版本 USE CATALOG、 USE SCHEMA和 READ METADATA
在支持的工作负载中使用镜像 USE CATALOG、 USE SCHEMA和 READ VOLUME

对于专门用于工件注册表的模式,管理员可以在模式层面授予权限。 模式层级权限适用于模式中所有匹配对象,包括后来创建的对象。 对于不应能够修改彼此制品的发布者,应使用不同的架构模式。 只授予每位主要负责人其运营所需的权限。 在运行以下语句之前,替换示例值并删除不必要的权限语句:

GRANT USE CATALOG ON CATALOG <catalog> TO `<principal>`;
GRANT USE SCHEMA ON SCHEMA <catalog>.<schema> TO `<principal>`;
GRANT CREATE VOLUME ON SCHEMA <catalog>.<schema> TO `<principal>`;
GRANT WRITE VOLUME ON SCHEMA <catalog>.<schema> TO `<principal>`;
GRANT READ METADATA ON SCHEMA <catalog>.<schema> TO `<principal>`;
GRANT READ VOLUME ON SCHEMA <catalog>.<schema> TO `<principal>`;

有关 WRITE VOLUME、READ METADATA、READ VOLUME 和 CREATE VOLUME 的详细信息,请参见 Unity Catalog 权限参考。 关于其他授予方法,请参见 “展示、授予和撤销权限”。

推送镜像

使用工作区注册表主机名和镜像的 catalog.schema.artifact:tag 名称。

获取注册表主机名

使用由 databricks auth docker configure 输出的注册表主机名。 若要稍后查找某个配置概要的主机名,并检查是否已为其配置 Docker 凭据帮助程序,请运行:

databricks auth docker host --profile <profile>

如果你需要手动构建主机名,可以使用数字工作区 ID 和工作区区域。 要查找工作区 ID,请参见工作区实例名称、URL 和 ID。

要找到工作区区域,请在顶部导航栏打开 工作区切换器 。 该区域显示在工作区名称下方。 还可以在“工作区”下的帐户控制台中找到它。

使用以下主机名:

<workspace-id>.container.<region>.databricks.azure.cn

工件名称要求

Important

工件名称必须是采用 <catalog>.<schema>.<artifact> 格式的完全限定的 Unity Catalog 名称。 请勿在名称中使用斜杠。 参见 Unity 目录对象层级结构。

该 <artifact> 段落最多可包含255个字符。 请仅使用小写字母、数字、划线和连字符。 它必须以字母或数字开头和结尾。 连续的下划线不要超过两个,且不要将下划线放在连字符旁边。

标记并推送图片

警告

请勿在图片中包含凭据或其他敏感数据。 按下去之前先检查一下图片。 工件版本是不可变的,不支持删除请求。 如果你推送敏感数据,请立即轮换或撤销,并请求管理员限制适用于受影响工件的任何 READ VOLUME 资助。 停止使用受影响的摘要以及所有解析到该摘要的标签,然后参阅请求帮助时需要提供的信息。

  1. 为本地镜像添加 Artifact Registry 标签:

    docker tag <local-image>:<local-tag> \
      <registry-hostname>/<catalog>.<schema>.<artifact>:<tag>
    
  2. 推送镜像:

    docker push <registry-hostname>/<catalog>.<schema>.<artifact>:<tag>
    

发现镜像和版本

使用软件工件 API 在目录和模式中列出工件,然后列出工件的版本。

Note

无法提供专门用于列出和管理工件注册表镜像的 Databricks CLI 命令。 使用 databricks api 来调用软件工件API。

以下示例使用了你为 Docker 身份验证配置的配置文件。 如果是默认的Databricks CLI配置文件,就省略 --profile <profile> 。

文物列表

要列出工件,请执行以下命令:

databricks api get --profile <profile> \
  "/api/2.1/unity-catalog/software-artifacts?parent=schemas/<catalog>.<schema>"

回复中会包括文物名称和所有者。 如果响应包含 next_page_token,则在查询参数中传递其值page_token以获取下一页,例如。 &page_token=<next_page_token>

列出版本

要列出工件的版本,请执行以下命令:

databricks api get --profile <profile> \
  "/api/2.1/unity-catalog/software-artifacts/<catalog>.<schema>.<artifact>/versions"

该响应包含每个版本的镜像摘要、标签和 image_acceleration_details.status。 关于响应限制,请参见 限制。

检查图像加速状态

从构件版本响应中读取 image_acceleration_details.status:

Status Meaning
SUCCESS 图像加速成功完成。
UNSPECIFIED 目前尚未记录到成功的图像加速结果。 此状态并不代表失败。

在受支持的 Azure Databricks 工作负载中使用映像

推送镜像到Artifact Registry后,创建支持的Azure Databricks工作负载时引用它。

其他资源