使用 Docker 拉取映像

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

准备工作

如需使用 Docker 拉取映像，您必须为环境配置必要的资源和权限，包括包含要拉取的容器映像的现有 Harbor 项目。如需了解详情，请参阅创建 Harbor 项目。

所需 IAM 角色

如需从 Harbor 注册表实例中拉取映像，请与您的 IAM 项目管理员联系，请求获取 Harbor 实例 Viewer (harbor-instance-viewer) 角色，以便在项目命名空间中获取、列出和监视 Harbor 实例。此角色包含查看现有 Harbor 实例详细信息所需的权限，以便您检索拉取映像所需的注册表网址。

所需的 Harbor RBAC 角色

与 GDC IAM 角色不同，拉取映像需要 Harbor 内部基于角色的访问控制 (RBAC) 系统中的特定权限。向管理员请求必要的权限。仅请求特定任务所需的角色，以强制执行最小权限访问。

拉取映像

请按照以下步骤在 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 注册表实例。

后续步骤

通过拉取映像确认连接后，您可以使用制品在环境中启动应用：