20.2. セキュリティーグループの設定

手順

1. 現在の config.yml をエクスポートします。

   $ oc get secret registry-config \
       -o jsonpath='{.data.config\.yml}' -n default | base64 -d \
     >> config.yml.old

2. 古い config.yml から新規の設定ファイルを作成します。

   $ cp config.yml.old config.yml

3. ファイルを編集して S3 パラメーターを追加します。レジストリーの設定ファイルの storage セクションにアカウント名、アカウントキー、コンテナー、およびレルムを指定します。

   storage:
     delete:
       enabled: true
     cache:
       blobdescriptor: inmemory
     s3:
       accesskey: AKIAJ6VLREDHATSPBUA 1
       secretkey: g/8PmTYDQVGssFWWFvfawHpDbZyGkjGNZhbWQpjH 2
       region: us-east-1 3
       bucket: openshift-registry-storage 4
       encrypt: False
       secure: true
       v4auth: true
       rootdirectory: /registry 5
       chunksize: "26214400"

   1

   S3 バケットにアクセスすることが承認されている AWS アクセスキーに置き換えます。

   2

   定義済みの AWS アクセスキーに対応するシークレットキー。

   3

   レジストリーとして使用される S3 バケットの名前。

   4

   レジストリーがイメージおよびメタデータを保管できる場所。(デフォルトは /registry です)

4. registry-config シークレットを削除します。

   $ oc delete secret registry-config -n default

5. シークレットを再作成して、更新された設定ファイルを参照します。

   $ oc create secret generic registry-config \
       --from-file=config.yml -n default

6. 更新された設定を読み取るためにレジストリーを再デプロイします。

   $ oc rollout latest docker-registry -n default

手順

1. レジストリーの正常なデプロイ後に、レジストリー deploymentconfig は registry-storage を AWS S3 ではなく emptydir として記述しますが、AWS S3 バケットの設定はシークレット docker-config に置かれます。docker-config シークレットは REGISTRY_CONFIGURATION_PATH にマウントされ、これにより、レジストリーオブジェクトストレージに AWS S3 を使用する場合にすべてのパラメーターが指定されます。

   $ oc describe dc docker-registry -n default
   ...
       Environment:
         REGISTRY_HTTP_ADDR:					:5000
         REGISTRY_HTTP_NET:					tcp
         REGISTRY_HTTP_SECRET:					SPLR83SDsPaGbGuwSMDfnDwrDRvGf6YXl4h9JQrToQU=
         REGISTRY_MIDDLEWARE_REPOSITORY_OPENSHIFT_ENFORCEQUOTA:	false
         REGISTRY_HTTP_TLS_KEY:					/etc/secrets/registry.key
         OPENSHIFT_DEFAULT_REGISTRY:				docker-registry.default.svc:5000
         REGISTRY_CONFIGURATION_PATH:				/etc/registry/config.yml
         REGISTRY_OPENSHIFT_SERVER_ADDR:				docker-registry.default.svc:5000
         REGISTRY_HTTP_TLS_CERTIFICATE:				/etc/secrets/registry.crt
       Mounts:
         /etc/registry from docker-config (rw)
         /etc/secrets from registry-certificates (rw)
         /registry from registry-storage (rw)
     Volumes:
      registry-storage:
       Type:	EmptyDir (a temporary directory that shares a pod's lifetime) 1
       Medium:
      registry-certificates:
       Type:	Secret (a volume populated by a Secret)
       SecretName:	registry-certificates
       Optional:	false
      docker-config:
       Type:	Secret (a volume populated by a Secret)
       SecretName:	registry-config
       Optional:	false
   ....

   1

   Pod の寿命を共有する一時ディレクトリー

2. /registry マウントポイントが空であることを確認します。

   $ oc exec \
       $(oc get pod -l deploymentconfig=docker-registry \
       -o=jsonpath='{.items[0].metadata.name}')  -i -t -- ls -l /registry
   total 0

   空になるのは、S3 設定が registry-config シークレットに定義されているためです。

   $ oc describe secret registry-config
   Name:         registry-config
   Namespace:    default
   Labels:       <none>
   Annotations:  <none>
   
   Type:  Opaque
   
   Data
   ====
   config.yml:  398 bytes

3. インストーラーは、インストールドキュメントのストレージセクション で記載されているように、拡張されたレジストリー機能を使用して、希望の設定で config.yml ファイルを作成します。以下のコマンドで、ストレージバケット設定が保存されている storage セクションを含めて設定ファイルを表示します。

   $ oc exec \
       $(oc get pod -l deploymentconfig=docker-registry \
         -o=jsonpath='{.items[0].metadata.name}') \
     cat /etc/registry/config.yml
   
     version: 0.1
     log:
       level: debug
     http:
       addr: :5000
     storage:
       delete:
         enabled: true
       cache:
         blobdescriptor: inmemory
       s3:
         accesskey: AKIAJ6VLREDHATSPBUA
         secretkey: g/8PmTYDQVGssFWWFvfawHpDbZyGkjGNZhbWQpjH
         region: us-east-1
         bucket: openshift-registry-storage
         encrypt: False
         secure: true
         v4auth: true
         rootdirectory: /registry
         chunksize: "26214400"
     auth:
       openshift:
         realm: openshift
     middleware:
       registry:
       - name: openshift
       repository:
       - name: openshift
         options:
           pullthrough: true
           acceptschema2: true
           enforcequota: true
       storage:
       - name: openshift

   または、シークレットを表示することができます。

   $ oc get secret registry-config -o jsonpath='{.data.config\.yml}' | base64 -d
   version: 0.1
   log:
     level: debug
   http:
     addr: :5000
     storage:
       delete:
         enabled: true
       cache:
         blobdescriptor: inmemory
       s3:
         accesskey: AKIAJ6VLREDHATSPBUA
         secretkey: g/8PmTYDQVGssFWWFvfawHpDbZyGkjGNZhbWQpjH
         region: us-east-1
         bucket: openshift-registry-storage
         encrypt: False
         secure: true
         v4auth: true
         rootdirectory: /registry
         chunksize: "26214400"
   auth:
     openshift:
       realm: openshift
   middleware:
     registry:
     - name: openshift
     repository:
     - name: openshift
     options:
       pullthrough: true
       acceptschema2: true
       enforcequota: true
     storage:
     - name: openshift