用于 DGX 用户指南的 NGC 容器注册表

面向使用 NVIDIA NGC 容器注册表的 NVIDIA DGX 客户的文档,其中介绍了如何管理和使用该注册表。

1. NGC 容器注册表企业概述

本用户指南的内容已移至 http://docs.nvda.net.cn/ngc/ngc-private-registry-user-guide/index.html

如果您正在使用位于 https://compute.nvidia.com 的 DGX 注册表,请务必获取一个 NGC 帐户,并根据下一节中的说明迁移您的容器镜像。

2. 从 DGX 注册表迁移到 NGC

位于 https://compute.nvidia.com 的旧版 DGX 容器注册表将很快关闭且不再可用。所有容器镜像都将被删除。届时,如果您尝试访问 DGX 容器注册表服务,您将被重定向到位于 https://ngc.nvidia.com 的 NGC 网站。

以下是将您的容器镜像从 DGX 注册表迁移到 NGC 注册表的过程摘要。

  1. 获取 NGC 私有注册表帐户。

  2. 获取 NGC 帐户的 API 密钥。

  3. 使用您的 DGX 注册表 API 密钥登录 nvcr.io。

  4. 从注册表中拉取您的容器。

  5. 注销 DGX 注册表,然后登录 nvcr.io 上的 NGC 注册表。

  6. 将您的容器镜像推送到 NGC 注册表。

获取 NGC 私有注册表帐户

有关如何获取 NGC 私有注册表帐户的说明,请参阅 http://docs.nvda.net.cn/ngc/ngc-private-registry-user-guide/index.html 上的信息。

获取 NGC 注册表的新 API 密钥

  1. 登录 https://ngc.nvidia.com

  2. 在右上角,单击您的用户帐户图标并选择Setup

  3. 单击Get API key以打开“设置”>“API 密钥”页面。

    API 密钥是用于验证您访问 NGC 容器注册表的机制。

  4. 单击Generate API Key以生成您的 API 密钥。将出现警告消息,告知您如果创建新密钥,旧的 API 密钥将失效。

  5. 单击Confirm以生成密钥。

    您的 API 密钥将出现。

    您只需生成一次 API 密钥。NGC 不会保存您的密钥,因此请将其存储在安全的地方。(您可以通过单击 API 密钥右侧的复制图标将您的 API 密钥复制到剪贴板。)

    如果您丢失了 API 密钥,您可以从 NGC 网站生成一个新的。当您生成新的 API 密钥时,旧的密钥将失效。

将容器镜像迁移到 NGC 注册表

  1. 使用来自 compute.nvidia.com 的旧 API 密钥登录

    $ docker login nvcr.io

    Username ($oauthtoken)

    Password: <enter-old-compute-API-key>

    Login Succeeded

  2. 从 nvcr.io 拉取镜像

    $ docker pull nvcr.io/ <path-to-repository>/<image>:<tag>

    对您需要传输的每个容器镜像执行此步骤。

  3. 注销注册表。

    $ docker logout nvcr.io

  4. 使用来自 ngc.nvidia.com 的新 API 密钥登录

    $ docker login nvcr.io

    Username ($oauthtoken)

    Password: <enter-new-NGC-API-key>

    Login Succeeded

  5. 将镜像推送到 nvcr.io

    $ docker push nvcr.io/ <org-name>/<image>:<tag>

    或者,如果要推送到团队

    $ docker push nvcr.io/ <org-name>/<team>/<image>:<tag>

    如果您要推送到团队,请确保首先在 ngc.nvidia.com 中创建团队并将用户添加到团队。要查找您的组织名称,请在登录后查看屏幕的右上角。

    对您需要传输的所有容器镜像重复此步骤。

Notices

Notice

本文档仅供参考,不应被视为对产品特定功能、状况或质量的保证。NVIDIA Corporation(“NVIDIA”)对本文档中包含信息的准确性或完整性不作任何明示或暗示的陈述或保证,并且对本文档中包含的任何错误不承担任何责任。NVIDIA 对因使用此类信息而造成的后果或使用,或因其使用可能导致的侵犯专利或第三方其他权利的行为,不承担任何责任。本文档不承诺开发、发布或交付任何材料(如下定义)、代码或功能。

NVIDIA 保留随时对此文档进行更正、修改、增强、改进和任何其他更改的权利,恕不另行通知。

客户应在下订单前获取最新的相关信息,并应验证此类信息是否为最新且完整。

NVIDIA 产品根据订单确认时提供的 NVIDIA 标准销售条款和条件进行销售,除非 NVIDIA 和客户的授权代表签署的个别销售协议(“销售条款”)另有约定。NVIDIA 在此明确反对将任何客户通用条款和条件应用于购买本文档中引用的 NVIDIA 产品。本文档不直接或间接地形成任何合同义务。

NVIDIA 产品并非设计、授权或保证适用于医疗、军事、航空、航天或生命维持设备,也不适用于 NVIDIA 产品发生故障或失灵可能合理预期会导致人身伤害、死亡或财产或环境损害的应用。NVIDIA 对在上述设备或应用中包含和/或使用 NVIDIA 产品不承担任何责任,因此,包含和/或使用此类产品由客户自行承担风险。

NVIDIA 不保证或声明基于本文档的产品将适用于任何特定用途。NVIDIA 不一定会对每种产品的所有参数进行测试。客户有责任评估和确定本文档中包含的任何信息的适用性,确保产品适合客户计划的应用,并为应用执行必要的测试,以避免应用或产品出现缺陷。客户产品设计中的缺陷可能会影响 NVIDIA 产品的质量和可靠性,并可能导致超出本文档中包含的附加或不同的条件和/或要求。NVIDIA 对可能基于或归因于以下原因的任何缺陷、损坏、成本或问题不承担任何责任:(i)以任何与本文档相悖的方式使用 NVIDIA 产品;或(ii)客户产品设计。

本文档未授予 NVIDIA 专利权、版权或 NVIDIA 其他知识产权下的任何明示或暗示的许可。NVIDIA 发布的有关第三方产品或服务的信息不构成 NVIDIA 授予的使用此类产品或服务的许可,也不构成对其的保证或认可。使用此类信息可能需要获得第三方专利或第三方其他知识产权下的许可,或获得 NVIDIA 专利或 NVIDIA 其他知识产权下的许可。

仅当事先获得 NVIDIA 书面批准,且在未进行修改且完全遵守所有适用的出口法律法规,并附带所有相关的条件、限制和通知的情况下,才允许复制本文档中的信息。

本文档以及所有 NVIDIA 设计规范、参考板、文件、图纸、诊断程序、列表和其他文档(统称和单独称为“材料”)均按“原样”提供。NVIDIA 对这些材料不作任何明示、暗示、法定或其他方面的保证,并且明确声明不承担所有关于非侵权性、适销性和特定用途适用性的暗示保证。在法律未禁止的范围内,在任何情况下,NVIDIA 均不对因使用本文档而引起的任何损害(包括但不限于任何直接、间接、特殊、偶然、惩罚性或后果性损害,无论因何种原因造成,也无论责任理论如何)承担责任,即使 NVIDIA 已被告知可能发生此类损害。尽管客户可能因任何原因遭受任何损害,但 NVIDIA 对本文所述产品的客户承担的总体和累积责任应根据产品的销售条款进行限制。

Trademarks

NVIDIA、NVIDIA 徽标、DGX、DGX-1、DGX-2 和 DGX Station 是 NVIDIA Corporation 在美国和其他国家/地区的商标和/或注册商标。其他公司和产品名称可能是与其相关的各自公司的商标。