4.4. プルシークレットのダウンロードおよび更新


4.4.1. OpenShift Cluster Manager からのプルシークレットのダウンロード

イメージプルシークレットは、OpenShift コンポーネントのコンテナーイメージを提供するサービスおよびレジストリーにアクセスするための認証を提供します。各ユーザーには単一のプルシークレットが生成されます。この同じプルシークレットは、OpenShift Container Platform または OpenShift Dedicated クラスターのインストール時に使用されます。

前提条件

  • OpenShift Container Platform または OpenShift Dedicated クラスター
  • 組織管理者またはクラスター所有者の権限:

    • 組織管理者 は、お客様の Red Hat アカウントへのアクセスが許可されます。
    • クラスター所有者の権限はクラスター内で付与されます。

手順

  1. クラスターの所有者権限を持つユーザーとしてクラスターにログインします。
  2. https://cloud.redhat.com/openshift/install/pull-secret からプルシークレットをダウンロードします。
重要

プルシークレットは共有しないでください。プルシークレットはパスワードのように扱う必要があります。

4.4.2. API を使用したプルシークレットのダウンロード

OpenShift Cluster Manager API トークンを使用して OpenShift Cluster Manager アカウントに対して認証を行い、OpenShift Container Platform のインストールに必要なプルシークレットのダウンロードを自動化することができます。

これは、OpenShift Container Platform クラスターのインストールを自動化するのに役立ちます。ただし、Red Hat は、OpenShift イメージレジストリーが変更された場合にクラスターのインストール時に毎回プルシークレットをダウンロードすることを推奨します。

注記

前提条件

  • OpenShift Container Platform クラスター
  • クラスターへのクラスターの所有者権限を持つユーザー
  • ocm-cli コマンドラインツールがインストールされている。ご使用の環境での手順については、https://github.com/openshift-online/ocm-cli を参照してください。
  • OpenShift Cluster Manager のオフラインアクセストークンが https://cloud.redhat.com/openshift/token にあること。

手順

  1. ocm-cli ツールを使用するには、https://cloud.redhat.com/openshift/token にある OpenShift Cluster Manager のオフラインアクセストークンを使用して OpenShift Cluster Manager にログインします。

    $ ocm login --token=eyJ...
    Copy to Clipboard Toggle word wrap

    これは、提供された OpenShift Cluster Manager トークン (ベアラートークンとしても知られる) を使用して OpenID アクセスを要求し、トークンを sso.redhat.com に更新します。今後の使用のために、トークンはホームディレクトリーの .ocm.json ファイルに保存されます。

    注記

    詳細およびオプションについては、ocm login --help を実行します。

  2. OCM (ベアラー) トークンをエクスポートします。

    $ export BEARER=$(curl \
    --silent \
    --data-urlencode "grant_type=refresh_token" \
    --data-urlencode "client_id=cloud-services" \
    --data-urlencode "refresh_token=${OFFLINE_ACCESS_TOKEN}" \
    https://sso.redhat.com/auth/realms/redhat-external/protocol/openid-connect/token | \
    jq -r .access_token)
    Copy to Clipboard Toggle word wrap
  3. 以下の詳細を指定して、ocm post コマンドを実行します。

    $ echo '{}' | ocm post /api/accounts_mgmt/v1/access_token --header --header "Content-Type:application/json" --header "Authorization: Bearer $BEARER" | jq
    
    {
      "auths": {
        "cloud.openshift.com": {
          "auth": "<snip>",
          "email": "<user's email>"
        },
        "quay.io": {
          "auth": "<snip>",
          "email": "<user's email>"
        },
        "registry.connect.redhat.com": {
          "auth": "<snip>",
          "email": "<user's email>"
        },
        "registry.redhat.io": {
          "auth": "<snip>",
          "email": "<user's email>"
        }
      }
    }
    Copy to Clipboard Toggle word wrap

これで、トークンはホームディレクトリーの .ocm.json ファイルに保存されます。

4.4.3. グローバルのプルシークレットの更新

クラスターのグローバルプルシークレットを更新できます。

警告

クラスターリソースは新規のプルシークレットに合わせて調整する必要がありますが、これにより、クラスターのユーザビリティーが一時的に制限される可能性があります。

グローバルプルシークレットを更新すると、Machine Config Operator はノードをドレイン (解放) し、その変更を適用し、ノードの遮断を解除します。

注記

OpenShift Container Platform 4.7 の時点で、グローバルプルシークレットへの変更によって再起動がトリガーされなくなりました。

前提条件

  • OpenShift Container Platform クラスター
  • アップロードする新規または変更されたプルシークレットファイル (OpenShift Cluster Manager の https://cloud.redhat.com/openshift/install/pull-secret からプルシークレットをダウンロードできます)。
  • クラスターの所有者権限を持つユーザーとしてクラスターにアクセスします。

手順

  1. クラスターの所有者権限を持つユーザーとしてクラスターにログインします。
  2. https://cloud.redhat.com/openshift/install/pull-secret からプルシークレットをダウンロードします。

    重要

    プルシークレットは共有しないでください。プルシークレットはパスワードのように扱う必要があります。

  3. 以下のコマンドを入力して、ダウンロードしたプルシークレットでクラスターのグローバルプルシークレットを更新します。

    oc set data secret/pull-secret -n openshift-config --from-file=.dockerconfigjson=pull-secret.txt
    1
    Copy to Clipboard Toggle word wrap
    1
    新規プルシークレットファイルへのパスを指定します。

これにより、クラスターのすべてのノードへの更新が始まります。これには、クラスターのサイズに応じて多少時間がかかる場合があります。この間に、ノードがドレイン (解放) され、Pod は残りのノードで再スケジュールされます。

トップに戻る
Red Hat logoGithubredditYoutubeTwitter

詳細情報

試用、購入および販売

コミュニティー

Red Hat ドキュメントについて

Red Hat をお使いのお客様が、信頼できるコンテンツが含まれている製品やサービスを活用することで、イノベーションを行い、目標を達成できるようにします。 最新の更新を見る.

多様性を受け入れるオープンソースの強化

Red Hat では、コード、ドキュメント、Web プロパティーにおける配慮に欠ける用語の置き換えに取り組んでいます。このような変更は、段階的に実施される予定です。詳細情報: Red Hat ブログ.

会社概要

Red Hat は、企業がコアとなるデータセンターからネットワークエッジに至るまで、各種プラットフォームや環境全体で作業を簡素化できるように、強化されたソリューションを提供しています。

Theme

© 2025 Red Hat