使用 Docker 拉取映像

在 Docker 客户端中从 Harbor 项目拉取映像，以将指定的容器映像从 Harbor 注册表下载到本地机器。这样一来，您就可以在本地运行容器化应用，或者将其用作构建其他映像的基础映像。

准备工作

如需使用 Docker 拉取映像，您必须能够访问以下内容：

• 必要的身份和访问权限角色。请让您的组织 IAM 管理员向您授予 Harbor Instance Viewer (harbor-instance-viewer) 角色。
• 在 Harbor 的基于角色的访问控制中具有 Limited Guest 角色的账号。如需了解详情，请参阅为 API 和 Harbor 实例配置访问权限。
• 现有的 Harbor 项目。如需了解详情，请参阅创建 Harbor 项目。
• 现有 Harbor 项目中的现有容器映像。

拉取映像

如需在 Docker 客户端中从 Harbor 项目拉取映像，请按以下步骤操作：

1. 确保您已通过 Harbor 实例的身份验证。

2. 从 Harbor 项目中拉取映像：

   docker pull INSTANCE_URL/HARBOR_PROJECT_NAME/IMAGE:TAG
   

   或

   docker pull INSTANCE_URL/HARBOR_PROJECT_NAME/IMAGE@IMAGE_DIGEST
   

替换以下值：

• INSTANCE_URL：Harbor 实例的网址。例如，harbor-1.org-1.zone1.google.gdc.test. 您可以使用 GDC 控制台或 gdcloud CLI 获取 Harbor 实例的网址。
• HARBOR_PROJECT_NAME：Harbor 项目的名称。例如 my-project。
• IMAGE：映像的名称。例如 nginx。
• TAG：要拉取的映像版本的标记。例如 staging。
• IMAGE_DIGEST：映像内容的 sha256 哈希值。映像的每个版本都有一个唯一的映像摘要。在 Harbor 实例界面中，点击特定映像可查看其摘要。如需了解详情，请参阅查看 Harbor 注册表实例。