第1章 Red Hat Quayの高度な設定
初期導入後のRed Hat Quayは、いくつかの異なるインターフェースを使って設定することができます。
-
Red Hat Quay Config Tool:
quay
コンテナをconfig
モードで実行すると、Red Hat Quay クラスタを構成するための Web ベースのインターフェースが表示されます。この方法は、Red Hat Quayサービス自体のほとんどの構成に推奨される方法です。 -
config.yaml
の編集:config.yaml
ファイルには、Red Hat Quayクラスタの構成情報のほとんどが格納されています。このファイルを直接編集することは可能ですが、Config Toolでは利用できない高度なチューニングやパフォーマンス機能を利用する場合にのみお勧めします。 - Red Hat QuayのAPI: 一部のRed Hat Quayの設定はAPIを通じて行うことができます。
特定の機能のための設定は別のセクションで説明しますが、このセクションでは、それぞれのインターフェイスを使用して、より高度な設定を行う方法を説明します。
1.1. Red Hat Quay Config Tool を使用した Red Hat Quay の変更 リンクのコピーリンクがクリップボードにコピーされました!
Red Hat Quay Config Tool は、通常の Red Hat Quay サービスと並行してquay
コンテナをconfig
モードで実行することで利用可能になります。Config Toolの実行は、OpenShift上で動作するRed Hat Quayクラスターの場合は、ホストシステム上で直接動作する場合とは異なります。
1.1.1. Red Hat Quay OperatorからのConfig Toolの実行 リンクのコピーリンクがクリップボードにコピーされました!
OpenShiftからRed Hat Quay Operatorを実行している場合は、おそらくConfig Toolがすでに利用可能になっていると思います。コンフィグツールにアクセスするには、次のようにします。
- OpenShift コンソールから、Red Hat Quay が実行されているプロジェクトを選択します。(例えば、quay-enterprise)
左の列からネットワーク→ルートを選択します。次の画像に示すように、Red Hat Quay アプリケーションと Config Tool の両方へのルートが表示されます。
- Config Toolへのルート(例: example-quayecosystem-quay-config)を選択し、選択します。ブラウザにConfig tool Web UIが表示されます。
Modify configuration for this cluster
を選択します。次の画像に示すように、Config Tool が表示され、Red Hat Quay クラスタの機能を変更する準備ができています。-
必要な変更を行った後、
Save Configuration Changes
を選択します。コンフィグツールが変更内容を検証します。 -
必要に応じて、
Continue Editing
を選択して修正するか、Next
を選択して次に進みます。 -
プロンプトが表示されたら、
Download Configuration
を選択することをお勧めします。これにより、新しいconfig.yaml
と、Red Hat Quayのセットアップで使用された証明書や鍵を含むtarボールがダウンロードされます。 -
Go to deployment rollout
を選択し、Populate the configuration to deployments
を選択します。Red Hat Quay のポッドが再起動され、変更が有効になります。
保存されたconfig.yaml
ファイルは、設定の高度な変更を行うために使用することも、今後の参考のために保存しておくこともできます。
1.1.2. コマンドラインからのコンフィグツールの実行 リンクのコピーリンクがクリップボードにコピーされました!
podman
コマンドやdocker
コマンドなどのツールを使用してホストシステムから直接 Red Hat Quay を実行している場合は、最初の Red Hat Quay の展開後に Config Tool を再起動して Red Hat Quay クラスターを変更することができます。以下に、実行する方法を説明します。
quayをコンフィグモードで起動します。最初の
quay
ノードで以下を実行し、my-secret-password
をあなたのパスワードに置き換えます。既存のコンフィグバンドルを変更したい場合は、レジストリモードと同じように、コンフィグディレクトリをQuayコンテナにマウントするだけです。podman run --rm -it --name quay_config -p 8080:8080 \ -v path/to/config-bundle:/conf/stack \ registry.redhat.io/quay/quay-rhel8:v3.4.6 config my-secret-password
# podman run --rm -it --name quay_config -p 8080:8080 \ -v path/to/config-bundle:/conf/stack \ registry.redhat.io/quay/quay-rhel8:v3.4.6 config my-secret-password
Copy to Clipboard Copied! Toggle word wrap Toggle overflow - ブラウザを開く: quayのコンフィグレーションツールが起動したら、コンフィグレーションツールを実行しているシステムのURLとポート8080に向けてブラウザを開きます(例: https://myquay.example.com:8080)。ユーザー名とパスワードの入力を求められます。
この時点で、前述のようにRed Hat Quayクラスターの変更を開始することができます。