概念実証 - Red Hat Quay のデプロイ

手順

1. 最新の RHEL 9 サーバーをインストールします。最小インストール (シェルアクセスのみ) を実行するか、Server plus GUI (デスクトップが必要な場合) を実行できます。
2. Red Hat Subscription-Manager を使用して RHEL システムを Red Hat Customer Portal に登録およびサブスクライブする方法 の説明に従って、RHEL サーバーシステムを登録およびサブスクライブします。

3. 以下のコマンドを入力して、システムを登録し、利用可能なサブスクリプションを一覧表示します。利用可能な RHEL サーバーのサブスクリプションを選択し、プール ID に割り当て、最新のソフトウェアにアップグレードします。

   # subscription-manager register --username=<user_name> --password=<password>
   # subscription-manager refresh
   # subscription-manager list --available
   # subscription-manager attach --pool=<pool_id>
   # yum update -y

   Copy to Clipboard Toggle word wrap

手順

1. Red Hat Container Registry の認証 手順に従って、registry.redhat.io への認証を設定します。認証を設定すると、Quay コンテナーをプルできます。

   注記

   これは、イメージが Quay.io でホストされていた以前のバージョンの Red Hat Quay とは異なります。

2. 次のコマンドを入力して、レジストリーにログインします。

   $ sudo podman login registry.redhat.io

   Copy to Clipboard Toggle word wrap

   ユーザー名 の パスワード の入力を求められます。

手順

1. 次のコマンドを入力して、ホストシステムの静的 IP アドレスを取得します。

   $ ip a

   Copy to Clipboard Toggle word wrap

   出力例

   ---
       link/ether 6c:6a:77:eb:09:f1 brd ff:ff:ff:ff:ff:ff
       inet 192.168.1.132/24 brd 192.168.1.255 scope global dynamic noprefixroute wlp82s0
   ---

   Copy to Clipboard Toggle word wrap

2. Red Hat Quay のエンドポイントに到達するために使用する IP アドレスとローカルホスト名 (例: quay-server.example.com) を /etc/hosts ファイルに追加します。次のコマンドを入力すると、IP アドレスとホスト名が /etc/hosts ファイルに追加されたことを確認できます。

   $ cat /etc/hosts

   Copy to Clipboard Toggle word wrap

   出力例

   192.168.1.132 quay-server.example.com

   Copy to Clipboard Toggle word wrap

手順

1. ここでは $QUAY 変数で示されているインストールフォルダーに、次のコマンドを入力して、データベースデータ用のディレクトリーを作成します。

   $ mkdir -p $QUAY/postgres-quay

   Copy to Clipboard Toggle word wrap

2. 次のコマンドを入力して、適切な権限を設定します。

   $ setfacl -m u:26:-wx $QUAY/postgres-quay

   Copy to Clipboard Toggle word wrap

3. データベースデータのボリューム定義を使用して、ユーザー名、パスワード、およびデータベース名とポートを指定して、Postgres コンテナーを起動します。

   $ sudo podman run -d --rm --name postgresql-quay \
     -e POSTGRESQL_USER=quayuser \
     -e POSTGRESQL_PASSWORD=quaypass \
     -e POSTGRESQL_DATABASE=quay \
     -e POSTGRESQL_ADMIN_PASSWORD=adminpass \
     -p 5432:5432 \
     -v $QUAY/postgres-quay:/var/lib/pgsql/data:Z \
     registry.redhat.io/rhel8/postgresql-13:1-109

   Copy to Clipboard Toggle word wrap

4. 次のコマンドを実行して、Postgres pg_trgm モジュールがインストールされていることを確認します。

   $ sudo podman exec -it postgresql-quay /bin/bash -c 'echo "CREATE EXTENSION IF NOT EXISTS pg_trgm" | psql -d quay -U postgres'

   Copy to Clipboard Toggle word wrap
   注記

   Quay コンテナーには pg_trgm モジュールが必要です。

手順

1. 次のコマンドを入力して、Red Hat Quay コンテナーのデプロイに使用される最小限の config.yaml ファイルを作成します。

   $ touch config.yaml

   Copy to Clipboard Toggle word wrap

2. 以下の YAML 設定をコピーし、config.yaml ファイルに貼り付けます。

   BUILDLOGS_REDIS:
       host: quay-server.example.com
       password: strongpassword
       port: 6379
   CREATE_NAMESPACE_ON_PUSH: true
   DATABASE_SECRET_KEY: a8c2744b-7004-4af2-bcee-e417e7bdd235
   DB_URI: postgresql://quayuser:quaypass@quay-server.example.com:5432/quay
   DISTRIBUTED_STORAGE_CONFIG:
       default:
           - LocalStorage
           - storage_path: /datastorage/registry
   DISTRIBUTED_STORAGE_DEFAULT_LOCATIONS: []
   DISTRIBUTED_STORAGE_PREFERENCE:
       - default
   FEATURE_MAILING: false
   SECRET_KEY: e9bd34f4-900c-436a-979e-7530e5d74ac8
   SERVER_HOSTNAME: quay-server.example.com
   SETUP_COMPLETE: true
   USER_EVENTS_REDIS:
       host: quay-server.example.com
       password: strongpassword
       port: 6379

   Copy to Clipboard Toggle word wrap

3. Red Hat Quay 設定バンドルをコピーするディレクトリーを作成します。

   $ mkdir $QUAY/config

   Copy to Clipboard Toggle word wrap

4. Red Hat Quay 設定ファイルをディレクトリーにコピーします。

   $ cp -v config.yaml $QUAY/config

   Copy to Clipboard Toggle word wrap

手順

1. 次のコマンドを入力して、レジストリーイメージを保存するローカルディレクトリーを作成します。

   $ mkdir $QUAY/storage

   Copy to Clipboard Toggle word wrap

2. レジストリーイメージを保存するディレクトリーを設定します。

   $ setfacl -m u:1001:-wx $QUAY/storage

   Copy to Clipboard Toggle word wrap

手順

1. 次のコマンドを入力して、設定データ用の適切なボリュームとイメージデータ用のローカルストレージを指定して、Quay レジストリーコンテナーを起動します。

   $ sudo podman run -d --rm -p 80:8080 -p 443:8443  \
      --name=quay \
      -v $QUAY/config:/conf/stack:Z \
      -v $QUAY/storage:/datastorage:Z \
      registry.redhat.io/quay/quay-rhel8:v3.12.12

   Copy to Clipboard Toggle word wrap

手順

1. Red Hat Quay レジストリーからイメージのプッシュおよびプルをテストするには、まず外部レジストリーからサンプルイメージをプルします。

   $ sudo podman pull busybox

   Copy to Clipboard Toggle word wrap

   出力例

   Trying to pull docker.io/library/busybox...
   Getting image source signatures
   Copying blob 4c892f00285e done
   Copying config 22667f5368 done
   Writing manifest to image destination
   Storing signatures
   22667f53682a2920948d19c7133ab1c9c3f745805c14125859d20cede07f11f9

   Copy to Clipboard Toggle word wrap

2. 次のコマンドを入力して、イメージのローカルコピーを表示します。

   $ sudo podman images

   Copy to Clipboard Toggle word wrap

   出力例

   REPOSITORY                          TAG      IMAGE ID       CREATED         SIZE
   docker.io/library/busybox           latest   22667f53682a   14 hours ago    1.45 MB

   Copy to Clipboard Toggle word wrap

3. 次のコマンドを入力してこのイメージにタグを付けます。これにより、イメージをレジストリーにプッシュする準備が整います。

   $ sudo podman tag docker.io/library/busybox quay-server.example.com/quayadmin/busybox:test

   Copy to Clipboard Toggle word wrap

4. イメージをレジストリーにプッシュします。この手順の後に、ブラウザーを使用して、リポジトリーでタグ付けされたイメージを確認できます。

   $ sudo podman push --tls-verify=false quay-server.example.com/quayadmin/busybox:test

   Copy to Clipboard Toggle word wrap

   出力例

   Getting image source signatures
   Copying blob 6b245f040973 done
   Copying config 22667f5368 done
   Writing manifest to image destination
   Storing signatures

   Copy to Clipboard Toggle word wrap

5. コマンドラインからイメージへのアクセスをテストするには、まずイメージのローカルコピーを削除します。

   $ sudo podman rmi quay-server.example.com/quayadmin/busybox:test

   Copy to Clipboard Toggle word wrap

   出力例

   Untagged: quay-server.example.com/quayadmin/busybox:test

   Copy to Clipboard Toggle word wrap

6. 今度は Red Hat Quay レジストリーからイメージを再度プルします。

   $ sudo podman pull --tls-verify=false quay-server.example.com/quayadmin/busybox:test

   Copy to Clipboard Toggle word wrap

   出力例

   Trying to pull quay-server.example.com/quayadmin/busybox:test...
   Getting image source signatures
   Copying blob 6ef22a7134ba [--------------------------------------] 0.0b / 0.0b
   Copying config 22667f5368 done
   Writing manifest to image destination
   Storing signatures
   22667f53682a2920948d19c7133ab1c9c3f745805c14125859d20cede07f11f9

   Copy to Clipboard Toggle word wrap

手順

1. Red Hat Quay UI の Superuser Admin Panel にアクセスするには、UI のナビゲーションペインで現在のユーザーの名前またはアバターをクリックします。次に、Superuser Admin Panel をクリックします。

   

   このページでは、ユーザー、組織、サービスキーの管理、ログの変更、使用状況ログの表示、組織のグローバルメッセージの作成を行うことができます。

手順

1. ルート CA ファイルを /etc/containers/certs.d/ または /etc/docker/certs.d/ のいずれかにコピーします。サーバーのホスト名によって決定される正確なパスを使用し、ファイルに ca.crt という名前を付けます。

   $ sudo cp rootCA.pem /etc/containers/certs.d/quay-server.example.com/ca.crt

   Copy to Clipboard Toggle word wrap

2. Red Hat Quay レジストリーにログインするときに --tls-verify=false オプションを使用する必要がなくなったことを確認します。

   $ sudo podman login quay-server.example.com

   Copy to Clipboard Toggle word wrap

   出力例

   Login Succeeded!

   Copy to Clipboard Toggle word wrap

手順

1. 次のコマンドを入力して、rootCA.pem ファイルをシステム全体の統合トラストストアにコピーします。

   $ sudo cp rootCA.pem /etc/pki/ca-trust/source/anchors/

   Copy to Clipboard Toggle word wrap

2. 次のコマンドを入力して、システム全体のトラストストア設定を更新します。

   $ sudo update-ca-trust extract

   Copy to Clipboard Toggle word wrap

3. オプション: trust list コマンドを使用して、Quay サーバーが設定されていることを確認できます。

   $ trust list | grep quay
       label: quay-server.example.com

   Copy to Clipboard Toggle word wrap

   https://quay-server.example.com でレジストリーを参照すると、接続が安全であることを示すロックアイコンが表示されます。

   

4. rootCA.pem ファイルをシステム全体の信頼から削除するには、ファイルを削除して設定を更新します。

   $ sudo rm /etc/pki/ca-trust/source/anchors/rootCA.pem

   Copy to Clipboard Toggle word wrap

   $ sudo update-ca-trust extract

   Copy to Clipboard Toggle word wrap

   $ trust list | grep quay

   Copy to Clipboard Toggle word wrap