搜索

4.3. 下载和更新 pull secret

download PDF

4.3.1. 从 OpenShift Cluster Manager 下载 pull secret

镜像 pull secret 为集群提供身份验证,以访问为 OpenShift 组件提供容器镜像的服务和 registry。每个单个用户都生成了一个 pull secret。

在安装 OpenShift Container Platform 集群时使用 pull secret。OpenShift Cluster Manager 还用来在传输集群所有权时标识特定的红帽用户。要将集群转让给另一个所有者,您需要下载集群所有权的用户的 pull secret。

先决条件

  • 一个 Red Hat 登录

流程

  1. 以您要下载 pull secret 的红帽用户身份登录 OpenShift Cluster Manager

    重要

    每个 pull secret 都对特定用户是唯一的。如果要下载 pull secret 以将集群转让到另一个所有者,则必须以集群所有权的用户身份登录到 OpenShift Cluster Manager,并获取该用户的 pull secret。

  2. 进入 OpenShift Cluster Manager 下载 ,并在 Tokens 类别中找到您的 pull secret。

    • Copy 将 pull secret 复制到剪贴板。
    • Download 下载您的 pull secret。
重要

不要共享您的 pull secret。pull secret 应被视为密码。

现在,您可以使用此 pull secret 创建 OpenShift Container Platform 集群或传输集群所有权。

其他资源

4.3.2. 更新全局 pull secret

镜像 pull secret 为集群提供身份验证,以访问为 OpenShift 组件提供容器镜像的服务和 registry。每个单个用户都生成了一个 pull secret。

在安装 OpenShift Container Platform 集群和传输集群所有权时,会使用 pull secret。

要将连接的集群传送到新所有者,您必须在 OpenShift Cluster Manager 中启动集群转让后,将集群中的 pull secret 更新至新所有者的 pull secret。必须在启动转让过程的五天内更新 pull secret,或者需要从 OpenShift Cluster Manager 再次启动该进程。请参阅 第 4.4 节 “传输集群所有权”

重要

在使用比 4.7.4 之前的 OpenShift Container Platform 版本的集群中,集群资源必须调整为新的 pull secret。这可临时限制集群的可用性。这是因为更新 pull secret 会导致 Machine Config Operator 排空节点、应用更改和取消协调节点。

这不会影响使用 OpenShift Container Platform 版本 4.7.4 及更新的版本,其中 pull secret 更改不会造成节点排空或重启。

先决条件

  • OpenShift Container Platform 集群
  • 在 OpenShift Cluster Manager 中的集群上带有 Cluster Owner 或 Organization Administrator 权限的 Red Hat 登录
  • 要上传的新或修改的 pull secret 文件。您可以从 Tokens 区域 下载 您的 pull secret。
  • 您可以使用具有 cluster-admin 角色的用户访问集群。如需有关集群角色的更多信息,请参阅 OpenShift Container Platform 文档中的 身份验证和授权 部分。
  • 如果要将集群传送到新所有者,您必须在 OpenShift Cluster Manager 中启动转让,然后才能 更改全局 pull secret 才能接收 Telemetry 指标来监控集群。

流程

  • 使用您从 OpenShift Cluster Manager 下载的 pull secret 运行以下命令,以更改集群的 pull secret:

    # oc set data secret/pull-secret -n openshift-config --from-file=.dockerconfigjson=pull-secret.txt

    如果还没有创建 secret,请运行以下命令来创建 secret:

    # oc create secret generic pull-secret -n openshift-config --type=kubernetes.io/dockerconfigjson --from-file=.dockerconfigjson=/path/to/downloaded/pull-secret

这将开始对集群中的所有节点的更新,可能需要一些时间,具体取决于集群的大小。

验证步骤

进入 OpenShift Cluster Manager 下载,并在 Tokens 类别中找到您的 pull secret 以验证更改:

  • Copy 将 pull secret 复制到剪贴板。
  • Download 下载您的 pull secret。

其他资源

4.3.3. 创建新的 pull secret

在某些情况下,您可以创建新的 pull secret。例如,如果您的当前 pull secret 无法正常工作,或者出于安全原因需要新的 pull secret。

要创建新的 pull secret,请按照 KCS 文章 如何请求 pull-secret 轮转

注意

使用此方法需要使用 ocm CLI 工具。如需有关 ocm CLI 工具的更多信息,请参阅使用 ocm-cli 在 OpenShift Cluster Manager 中管理集群

Red Hat logoGithubRedditYoutubeTwitter

学习

尝试、购买和销售

社区

关于红帽文档

通过我们的产品和服务,以及可以信赖的内容,帮助红帽用户创新并实现他们的目标。

让开源更具包容性

红帽致力于替换我们的代码、文档和 Web 属性中存在问题的语言。欲了解更多详情,请参阅红帽博客.

關於紅帽

我们提供强化的解决方案,使企业能够更轻松地跨平台和环境(从核心数据中心到网络边缘)工作。

© 2024 Red Hat, Inc.