7.2. イメージ設定内容の設定

1. 追加の CA を設定するには、以下を実行します。

   $ oc create configmap registry-config --from-file=<external_registry_address>=ca.crt -n openshift-config
   $ oc edit image.config.openshift.io cluster
   spec:
     additionalTrustedCA:
       name: registry-config

手順

1. image.config.openshift.io/cluster カスタムリソースを編集します。

   $ oc edit image.config.openshift.io/cluster

   以下は、image.config.openshift.io/cluster リソースの例になります。

   apiVersion: config.openshift.io/v1
   kind: Image
   metadata:
     annotations:
       release.openshift.io/create-only: "true"
     creationTimestamp: "2019-05-17T13:44:26Z"
     generation: 1
     name: cluster
     resourceVersion: "8302"
     selfLink: /apis/config.openshift.io/v1/images/cluster
     uid: e34555da-78a9-11e9-b92b-06d6c7da38dc
   spec:
     allowedRegistriesForImport:
       - domainName: quay.io
         insecure: false
     additionalTrustedCA:
       name: myconfigmap
     registrySources:
       insecureRegistries:1
       - insecure.com
       blockedRegistries:2
       - untrusted.com
       allowedRegistries:
       - quay.io 3
   status:
     internalRegistryHostname: image-registry.openshift-image-registry.svc:5000

   1

   非セキュアなレジストリーを指定します。

   2

   イメージのプルおよびプッシュアクションについてブラックリストに指定する必要のあるレジストリーを指定します。他のすべてのレジストリーは許可されます。blockedRegistries または allowedRegistries のいずれかを設定できますが、両方を設定することはできません。

   3

   イメージのプルおよびプッシュアクションについて許可する必要のあるレジストリーを指定します。他のすべてのレジストリーは拒否されます。blockedRegistries または allowedRegistries のいずれかを設定できますが、両方を設定することはできません。

   Machine Config Operator (MCO) は、レジストリーへの変更について image.config.openshift.io/cluster を監視し、変更を検出するとノードを再起動します。レジストリーへの変更は、各ノードの /host/etc/containers/registries.conf ファイルに表示されます。

   cat /host/etc/containers/registries.conf
   [registries]
     [registries.search]
       registries = ["registry.access.redhat.com", "docker.io"]
     [registries.insecure]
       registries = ["insecure.com"]
     [registries.block]
       registries = ["untrusted.com"]

手順

1. ミラーリングされたリポジトリーを設定します。これを実行するには、以下のいずれかを行います。

   • 「Repository Mirroring in Red Hat Quay」で説明されているように、Red Hat Quay でミラーリングされたリポジトリーを設定します。Red Hat Quay を使用すると、あるリポジトリーから別のリポジトリーにイメージをコピーでき、これらのリポジトリーを一定期間繰り返し自動的に同期することもできます。

   • skopeo などのツールを使用して、ソースディレクトリーからミラーリングされたリポジトリーにイメージを手動でコピーします。

     たとえば、Red Hat Enterprise Linux (RHEL 7 または RHEL 8) システムに skopeo RPM パッケージをインストールした後、以下の例に示すように skopeo コマンドを使用します。

     $ skopeo copy \
        docker://registry.access.redhat.com/ubi8/ubi-minimal@sha256:5cfbaf45ca96806917830c183e9f37df2e913b187adb32e89fd83fa455ebaa6 \
        docker://example.io/ubi8/ubi-minimal

     この例では、example.io いう名前のコンテナーイメージレジストリーと example という名前のイメージリポジトリーがあり、そこに registry.access.redhat.com から ubi8/ubi-minimal イメージをコピーします。レジストリーを作成した後、OpenShift Container Platform クラスターを設定して、ソースリポジトリーで作成される要求をミラーリングされたリポジトリーにリダイレクトできます。

2. OpenShift Container Platform クラスターにログインします。

3. ImageContentSourcePolicy ファイル (例: registryrepomirror.yaml) を作成し、ソースとミラーを固有のレジストリー、およびリポジトリーのペアとイメージのものに置き換えます。

   apiVersion: operator.openshift.io/v1alpha1
   kind: ImageContentSourcePolicy
   metadata:
     name: ubi8repo
   spec:
     repositoryDigestMirrors:
     - mirrors:
       - example.io/example/ubi-minimal1
       source: registry.access.redhat.com/ubi8/ubi-minimal2
     - mirrors:
       - example.com/example/ubi-minimal
       source: registry.access.redhat.com/ubi8/ubi-minimal

   1

   イメージレジストリーおよびリポジトリーの名前を示します。

   2

   ミラーリングされているコンテンツが含まれるレジストリーおよびリポジトリーを示します。

4. 新しい ImageContentSourcePolicy を作成します。

   $ oc create -f registryrepomirror.yaml

   ImageContentSourcePolicy が作成されると、新しい設定が各ノードにデプロイされ、ソースリポジトリーへの要求のためにミラーリングされたリポジトリーの使用をすぐに開始します。

5. ミラーリングされた設定が機能することを確認するには、ノードのいずれかに移動します。以下は例になります。

   1. ノードの一覧を表示します。

      $ oc get node

      出力例

      NAME                           STATUS                     ROLES    AGE  VERSION
      ip-10-0-137-44.ec2.internal    Ready                      worker   7m   v1.16.2
      ip-10-0-138-148.ec2.internal   Ready                      master   11m  v1.16.2
      ip-10-0-139-122.ec2.internal   Ready                      master   11m  v1.16.2
      ip-10-0-147-35.ec2.internal    Ready,SchedulingDisabled   worker   7m   v1.16.2
      ip-10-0-153-12.ec2.internal    Ready                      worker   7m   v1.16.2
      ip-10-0-154-10.ec2.internal    Ready                      master   11m  v1.16.2

      変更が適用されているため、各ワーカーノードのスケジューリングが無効にされていることを確認できます。

   2. デバッグプロセスを開始します。

      $ oc debug node/ip-10-0-147-35.ec2.internal

      出力例

      Starting pod/ip-10-0-147-35ec2internal-debug ...
      To use host binaries, run `chroot /host`

   3. ノードのファイルにアクセスします。

      sh-4.2# chroot /host

   4. /etc/containers/registries.conf ファイルをチェックして、変更が行われたことを確認します。

      unqualified-search-registries = ["registry.access.redhat.com", "docker.io"]
      [[registry]]
        location = "registry.access.redhat.com/ubi8/"
        insecure = false
        blocked = false
        mirror-by-digest-only = true
        prefix = ""
      
        [[registry.mirror]]
          location = "example.io/example/ubi8-minimal"
          insecure = false
      
        [[registry.mirror]]
          location = "example.com/example/ubi8-minimal"
          insecure = false

   5. ソースからノードにイメージダイジェストをプルし、ミラーによって実際に解決されているかどうかを確認します。ImageContentSourcePolicy はイメージダイジェストのみをサポートし、イメージタグはサポートしません。

      sh-4.2# podman pull --log-level=debug registry.access.redhat.com/ubi8/ubi-minimal@sha256:5cfbaf45ca96806917830c183e9f37df2e913b187adb32e89fd83fa455ebaa6