6.4. 非接続環境で IBM Z に Hosted Control Plane をデプロイする

手順

1. 次のコマンドを実行して、ミラーレジストリーの証明書を含む ConfigMap を作成します。

   Copy to Clipboard Toggle word wrap

   $ oc apply -f registry-config.yaml

   registry-config.yaml ファイルの例

   Copy to Clipboard Toggle word wrap

   apiVersion: v1
   kind: ConfigMap
   metadata:
     name: registry-config
     namespace: openshift-config
   data:
     <mirror_registry>: |
       -----BEGIN CERTIFICATE-----
       -----END CERTIFICATE-----

2. image.config.openshift.io クラスター全体のオブジェクトにパッチを適用して、次のエントリーを追加します。

   Copy to Clipboard Toggle word wrap

   spec:
     additionalTrustedCA:
       - name: registry-config

3. 管理クラスターのプルシークレットを更新して、ミラーレジストリーの認証情報を追加します。

   1. 次のコマンドを実行して、クラスターからプルシークレットを JSON 形式で取得します。

      Copy to Clipboard Toggle word wrap

      $ oc get secret/pull-secret -n openshift-config -o json \
        | jq -r '.data.".dockerconfigjson"' \
        | base64 -d > authfile

   2. 取得したシークレットの JSON ファイルを編集して、認証局の認証情報を含むセクションを追加します。

      Copy to Clipboard Toggle word wrap

        "auths": {
          "<mirror_registry>": { 

      1

      
            "auth": "<credentials>", 

      2

      
            "email": "you@example.com"
          }
        },

      1

      ミラーレジストリーの名前を指定します。

      2

      ミラーレジストリーの認証情報を指定して、イメージを取得できるようにします。

   3. 次のコマンドを実行して、クラスター上のプルシークレットを更新します。

      Copy to Clipboard Toggle word wrap

      $ oc set data secret/pull-secret -n openshift-config \
        --from-file=.dockerconfigjson=authfile

手順

1. multicluster engine Operator をインストールしたのと同じ namespace で、ミラーレジストリーの詳細を含む ConfigMap リソースを作成します。この ConfigMap リソースにより、ホステッドクラスターのワーカーに、ミラーレジストリーからイメージを取得する権限が付与されます。

   ConfigMap ファイルの例

   Copy to Clipboard Toggle word wrap

   apiVersion: v1
   kind: ConfigMap
   metadata:
     name: mirror-config
     namespace: multicluster-engine
     labels:
       app: assisted-service
   data:
     ca-bundle.crt: |
       -----BEGIN CERTIFICATE-----
       -----END CERTIFICATE-----
     registries.conf: |
   
       [[registry]]
         location = "registry.stage.redhat.io"
         insecure = false
         blocked = false
         mirror-by-digest-only = true
         prefix = ""
   
         [[registry.mirror]]
           location = "<mirror_registry>"
           insecure = false
   
       [[registry]]
         location = "registry.redhat.io/multicluster-engine"
         insecure = false
         blocked = false
         mirror-by-digest-only = true
         prefix = ""
   
         [[registry.mirror]]
           location = "<mirror_registry>/multicluster-engine" 

   1

   
           insecure = false

   1

   <mirror_registry> はミラーレジストリーの名前です。

2. AgentServiceConfig リソースにパッチを適用して、作成した ConfigMap リソースを含めます。AgentServiceConfig リソースが存在しない場合は、次の内容を埋め込んだ AgentServiceConfig リソースを作成します。

   Copy to Clipboard Toggle word wrap

   spec:
     mirrorRegistryRef:
       name: mirror-config

1. image-content-sources の情報を含む icsp.yaml ファイルを作成します。

   image-content-sources の情報は、oc-mirror を使用してイメージをミラーリングした後に生成される ImageContentSourcePolicy の YAML ファイルで入手できます。

   ImageContentSourcePolicy ファイルの例

   Copy to Clipboard Toggle word wrap

   # cat icsp.yaml
   - mirrors:
     - <mirror_registry>/openshift/release
     source: quay.io/openshift-release-dev/ocp-v4.0-art-dev
   - mirrors:
     - <mirror_registry>/openshift/release-images
     source: quay.io/openshift-release-dev/ocp-release

2. ホステッドクラスターを作成し、additional-trust-bundle 証明書を指定して、コンピュートノードを証明書で更新します。次に例を示します。

   Copy to Clipboard Toggle word wrap

   $ hcp create cluster agent \
       --name=<hosted_cluster_name> \ 

   1

   
       --pull-secret=<path_to_pull_secret> \ 

   2

   
       --agent-namespace=<hosted_control_plane_namespace> \ 

   3

   
       --base-domain=<basedomain> \ 

   4

   
       --api-server-address=api.<hosted_cluster_name>.<basedomain> \
       --etcd-storage-class=<etcd_storage_class> \ 

   5

   
       --ssh-key  <path_to_ssh_public_key> \ 

   6

   
       --namespace <hosted_cluster_namespace> \ 

   7

   
       --control-plane-availability-policy SingleReplica \
       --release-image=quay.io/openshift-release-dev/ocp-release:<ocp_release_image> \ 

   8

   
       --additional-trust-bundle <path for cert> \ 

   9

   
       --image-content-sources icsp.yaml

   1

   <hosted_cluster_name> は、ホステッドクラスターの名前に置き換えます。

   2

   プルシークレットへのパスを置き換えます (例: /user/name/pullsecret)。

   3

   <hosted_control_plane_namespace> は、Hosted Control Plane の namespace の名前 (例: clusters-hosted) に置き換えます。

   4

   名前をベースドメインに置き換えます (例: example.com)。

   5

   etcd ストレージクラス名を置き換えます (例: lvm-storageclass)。

   6

   SSH 公開鍵へのパスを置き換えます。デフォルトのファイルパスは ~/.ssh/id_rsa.pub です。

   7 8

   使用するサポート対象の OpenShift Container Platform バージョン (例: 4.18.0-multi) に置き換えます。

   9

   ミラーレジストリーの認証局へのパスを置き換えます。