Red Hat Quay のデプロイ - 高可用性

手順

1. 最初の 2 つのシステム q01 と q02 に、HAProxy ロードバランサーと PostgreSQL データベースをインストールします。これにより、他のシステムで実行されている次のサービスのアクセスポイントおよびロードバランサーとして HAProxy が設定されます。

   • Red Hat Quay (B システムではポート 80 および 443)
   • Redis (B システムではポート 6379)
   • RADOS (C システムではポート 7480)

1. SELinux ですべての HAProxy ポートを開き、ファイアウォールで選択した HAProxy ポートを開きます。

   # setsebool -P haproxy_connect_any=on
   # firewall-cmd --permanent --zone=public --add-port=6379/tcp --add-port=7480/tcp
   success
   # firewall-cmd --reload
   success

   Copy to clipboard

1. /etc/haproxy/haproxy.cfg を設定して、Red Hat Quay、Redis、および Ceph RADOS サービスを提供するシステムとポートを指すようにします。以下は、デフォルトと追加されたフロントエンドおよびバックエンド設定の例です。

   #---------------------------------------------------------------------
   # common defaults that all the 'listen' and 'backend' sections will
   # use if not designated in their block
   #---------------------------------------------------------------------
   defaults
       mode                    tcp
       log                     global
       option                  httplog
       option                  dontlognull
       option http-server-close
       option forwardfor       except 127.0.0.0/8
       option                  redispatch
       retries                 3
       timeout http-request    10s
       timeout queue           1m
       timeout connect         10s
       timeout client          1m
       timeout server          1m
       timeout http-keep-alive 10s
       timeout check           10s
       maxconn                 3000
   
   #---------------------------------------------------------------------
   # main frontend which proxys to the backends
   #---------------------------------------------------------------------
   
   frontend  fe_http *:80
       default_backend             be_http
   frontend  fe_https *:443
       default_backend             be_https
   frontend fe_redis *:6379
      default_backend              be_redis
   frontend  fe_rdgw *:7480
       default_backend             be_rdgw
   backend be_http
       balance     roundrobin
       server quay01 quay01:80 check
       server quay02 quay02:80 check
       server quay03 quay03:80 check
   backend be_https
       balance     roundrobin
       server quay01 quay01:443 check
       server quay02 quay02:443 check
       server quay03 quay03:443 check
   backend be_rdgw
       balance     roundrobin
       server ceph01 ceph01:7480 check
       server ceph02 ceph02:7480 check
       server ceph03 ceph03:7480 check
   backend be_redis
   server quay01 quay01:6379 check inter 1s
   server quay02 quay02:6379 check inter 1s
   server quay03 quay03:6379 check inter 1s

   新しい haproxy.cfg ファイルが配置されたら、次のコマンドを入力して HAProxy サービスを再起動します。

   # systemctl restart haproxy

   Copy to clipboard

2. 次のコマンドを入力して、PostgreSQL データベースのフォルダーを作成します。

   $ mkdir -p /var/lib/pgsql/data

   Copy to clipboard

3. /var/lib/pgsql/data フォルダーに次の権限を設定します。

   $ chmod 777 /var/lib/pgsql/data

   Copy to clipboard

4. 次のコマンドを入力して、PostgreSQL データベースを起動します。

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

   Copy to clipboard
   注記

   コンテナーのデータは、ホストシステムの /var/lib/pgsql/data ディレクトリーに保存されます。

5. 次のコマンドを入力して、使用可能な拡張機能をリスト表示します。

   $ sudo podman exec -it postgresql_database /bin/bash -c 'echo "SELECT * FROM pg_available_extensions" | /opt/rh/rh-postgresql96/root/usr/bin/psql'

   Copy to clipboard

   出力例

      name    | default_version | installed_version |           comment
   -----------+-----------------+-------------------+----------------------------------------
    adminpack | 1.0             |                   | administrative functions for PostgreSQL
   ...

   Copy to clipboard

6. 次のコマンドを入力して、pg_trgm 拡張機能を作成します。

   $ sudo podman exec -it postgresql_database /bin/bash -c 'echo "CREATE EXTENSION IF NOT EXISTS pg_trgm;" | /opt/rh/rh-postgresql96/root/usr/bin/psql -d quaydb'

   Copy to clipboard

7. 次のコマンドを入力して、pg_trgm が作成されたことを確認します。

   $ sudo podman exec -it postgresql_database /bin/bash -c 'echo "SELECT * FROM pg_extension" | /opt/rh/rh-postgresql96/root/usr/bin/psql'

   Copy to clipboard

   出力例

    extname | extowner | extnamespace | extrelocatable | extversion | extconfig | extcondition
   ---------+----------+--------------+----------------+------------+-----------+--------------
    plpgsql |       10 |           11 | f              | 1.0        |           |
    pg_trgm |       10 |         2200 | t              | 1.3        |           |
   (2 rows)

   Copy to clipboard

8. Postgres ユーザー quayuser の権限を変更し、superuser ロールを付与して、ユーザーにデータベースへの無制限のアクセスを許可します。

   $ sudo podman exec -it postgresql_database /bin/bash -c 'echo "ALTER USER quayuser WITH SUPERUSER;" | /opt/rh/rh-postgresql96/root/usr/bin/psql'

   Copy to clipboard

   出力例

   ALTER ROLE

   Copy to clipboard

9. システムで firewalld サービスがアクティブになっている場合は、次のコマンドを実行して、ファイアウォール経由で PostgreSQL ポートを使用できるようにします。

   # firewall-cmd --permanent --zone=trusted --add-port=5432/tcp

   Copy to clipboard

   # firewall-cmd --reload

   Copy to clipboard

10. オプション: postgres CLI パッケージがインストールされていない場合は、次のコマンドを入力してインストールします。

    # yum install postgresql -y

    Copy to clipboard

11. psql コマンドを使用して、PostgreSQL データベースへの接続をテストします。

    注記

    サービスにリモートでアクセスできることを確認するには、リモートシステムで次のコマンドを実行します。

    # psql -h localhost quaydb quayuser

    出力例

    Password for user test:
    psql (9.2.23, server 9.6.5)
    WARNING: psql version 9.2, server version 9.6.
             Some psql features might not work.
    Type "help" for help.
    
    test=> \q

    Copy to clipboard

1. Redis をインストール/デプロイ: 3 台あるそれぞれの quay0* システムで、Redis をコンテナーとして実行します。

   # mkdir -p /var/lib/redis
   # chmod 777 /var/lib/redis
   # sudo podman run -d -p 6379:6379 \
       -v /var/lib/redis:/var/lib/redis/data:Z \
       registry.redhat.io/rhel8/redis-5

2. redis の接続性を確認: telnet コマンドを使用して、redis サービスへの接続性をテストできます。MONITOR と入力して (サービスの監視を開始し)、QUIT で終了します。

   # yum install telnet -y
   # telnet 192.168.122.99 6379
   Trying 192.168.122.99...
   Connected to 192.168.122.99.
   Escape character is '^]'.
   MONITOR
   +OK
   +1525703165.754099 [0 172.17.0.1:43848] "PING"
   QUIT
   +OK
   Connection closed by foreign host.

1. リポジトリーミラーリングワーカーを起動: repomirror モードで Quay コンテナーを起動します。この例では、現在 /root/ca.crt に保存されている証明書を使用して TLS 通信を設定していることを前提としています。そうでない場合は、コンテナーに /root/ca.crt を追加する行を削除します。

   $ sudo podman run -d --name mirroring-worker \
     -v /mnt/quay/config:/conf/stack:Z \
     -v /root/ca.crt:/etc/pki/ca-trust/source/anchors/ca.crt \
     registry.redhat.io/quay/quay-rhel8:v3.14.0 repomirror

2. 設定ツールにログイン: Red Hat Quay Setup Web UI (設定ツール) にログインします。
3. リポジトリーのミラーリングを有効化: リポジトリーミラーリングセクションまでスクロールダウンし、Enable Repository Mirroring チェックボックスを選択します (下図参照)。
4. HTTPS および証明書の検証を選択: ミラーリング時に HTTPS 通信を要求し、証明書を検証する場合は、このチェックボックスを選択します。
5. 設定を保存: Save Configuration Changes ボタンを選択します。これで Red Hat Quay クラスターのリポジトリーミラーリングが有効になります。独自のミラーリングされたコンテナーイメージリポジトリーを設定する方法の詳細は、Red Hat Quay のリポジトリーミラーリング を参照してください。

手順

1. Web ブラウザーで、https://{quay-ip-endpoint}/health/instance に移動します。

2. ヘルスインスタンスページが表示され、以下のような情報が返されます。

   {"data":{"services":{"auth":true,"database":true,"disk_space":true,"registry_gunicorn":true,"service_key":true,"web_gunicorn":true}},"status_code":200}

   Copy to clipboard

   Red Hat Quay の場合、"status_code": 200 はインスタンスが正常であることを意味します。逆に、"status_code": 503 を受け取った場合は、デプロイメントに問題があります。