第10章 コンポーネントと機能の設定フィールド
コンポーネントと機能の設定セクションでは、さまざまなサブシステムにわたって Red Hat Quay を微調整するために使用できる設定可能なフィールドについて説明します。これらのフィールドにより、管理者はレジストリーの動作をカスタマイズしたり、特定の機能を有効または無効にしたり、外部のサービスやインフラストラクチャーと統合したりできます。これらのオプションは、基本的なデプロイメントには必要ありませんが、セキュリティー、自動化、スケーラビリティー、コンプライアンス、パフォーマンスに関連する高度なユースケースをサポートします。
10.1. コア設定の概要 リンクのコピーリンクがクリップボードにコピーされました!
これらのコアフィールドを使用して、ホスト名、プロトコル、認証設定など、レジストリーの基本的な動作を設定します。
10.1.1. レジストリーのブランディングとアイデンティティーフィールド リンクのコピーリンクがクリップボードにコピーされました!
次の設定フィールドを使用すると、Red Hat Quay デプロイメントに表示されるブランディング、アイデンティティー、および連絡先情報を変更できます。これらのフィールドにより、UI 全体に表示されるタイトル、ヘッダー、フッター、組織の連絡先リンクを指定して、レジストリーがユーザーにどのように表示されるかをカスタマイズできます。
次のフィールドの一部は、Red Hat Quay v2 UI では使用できません。
フィールド | 型 | 説明 |
---|---|---|
REGISTRY_TITLE | 文字列 |
指定されている場合、レジストリーの長いタイトル。Red Hat Quay デプロイメントのフロントエンド (組織のサインインページなど) に表示されます。35 文字を超えないようにしてください。 |
REGISTRY_TITLE_SHORT | 文字列 |
指定されている場合は、省略形式のレジストリーのタイトル。タイトルは、組織のさまざまなページに表示されます。たとえば、組織の Tutorial ページのチュートリアルのタイトルとして表示されます。 |
CONTACT_INFO | 文字列の配列 | 指定されている場合は、連絡先ページに表示される連絡先情報。連絡先が 1 つしか指定されていない場合は、連絡先のフッターが直接リンクされます。 |
[0] | 文字列 |
電子メールを送信するためのリンクを追加します。 |
[1] | 文字列 |
IRC チャットルームにアクセスするためのリンクを追加します。 |
[2] | 文字列 |
電話番号を呼び出すリンクを追加します。 |
[3] | 文字列 |
定義された URL へのリンクを追加します。 |
フィールド | 型 | 説明 |
---|---|---|
BRANDING | Object | Red Hat Quay UI のロゴおよび URL のカスタムブランディング |
.logo | 文字列 |
メインのロゴイメージ URL。
ヘッダーロゴのデフォルトは 205x30 PX です。Web UI の Red Hat Quay サインイン画面のフォームロゴは、デフォルトで 356.5x39.7 PX です。 |
.footer_img | 文字列 |
UI フッターのロゴ。デフォルトは 144x34 ピクセルです。 |
.footer_url | 文字列 |
フッターイメージへのリンク。 |
フィールド | 型 | 説明 |
---|---|---|
FOOTER_LINKS | Object | オンプレミスインストールの Red Hat Quay の UI でフッターリンクのカスタマイズを有効にします。 |
.TERMS_OF_SERVICE_URL | 文字列 |
オンプレミスインストール用のカスタム利用規約。 |
.PRIVACY_POLICY_URL | 文字列 |
オンプレミスインストール用のカスタムプライバシーポリシー。 |
.SECURITY_URL | 文字列 |
オンプレミスインストール用のカスタムセキュリティーページ。 |
.ABOUT_URL | 文字列 |
オンプレミスインストール用のカスタムの概要ページ。 |
レジストリーのブランディングとアイデンティティーの YAML サンプル
10.1.2. SSL/TLS 設定フィールド リンクのコピーリンクがクリップボードにコピーされました!
このセクションでは、Red Hat Quay デプロイメントで SSL/TLS 暗号化を有効にして管理するために使用できる設定フィールドについて説明します。
フィールド | 型 | 説明 |
---|---|---|
PREFERRED_URL_SCHEME | String |
|
SERVER_HOSTNAME | String |
スキームなしで Red Hat Quay にアクセスできる URL。 |
SSL_CIPHERS | 文字列の配列 |
指定した場合、nginx で定義された SSL 暗号のリストが有効または無効になります。 |
SSL_PROTOCOLS | 文字列の配列 |
指定されている場合、nginx は、リストで定義される SSL プロトコルのリストを有効にするように設定されます。リストから SSL プロトコルを削除すると、Red Hat Quay の起動時にそのプロトコルが無効になります。 |
SESSION_COOKIE_SECURE | Boolean |
セッションクッキーに |
EXTERNAL_TLS_TERMINATION | Boolean |
TLS がサポートされているが、Quay の前のレイヤーで終了する場合は |
SSL 設定 YAML サンプル
10.1.3. IPv6 設定フィールド リンクのコピーリンクがクリップボードにコピーされました!
FEATURE_LISTEN_IP_VERSION
設定フィールドを使用して、Red Hat Quay がリッスンする IP プロトコルファミリー (IPv4、IPv6、またはその両方 (デュアルスタック)) を指定できます。このフィールドは、レジストリーが IPv6 のみまたはデュアルスタックネットワークで動作する必要がある環境で重要です。
フィールド | 型 | 説明 |
---|---|---|
FEATURE_LISTEN_IP_VERSION | String |
IPv4、IPv6、またはデュアルスタックプロトコルファミリーを有効にします。この設定フィールドは正しく設定する必要があります。そうしないと、Red Hat Quay は起動に失敗します。デフォルト: |
IPv6 の YAML サンプル
# ... FEATURE_LISTEN_IP_VERSION: dual-stack # ...
# ...
FEATURE_LISTEN_IP_VERSION: dual-stack
# ...
10.1.4. ロギングとデバッグ変数 リンクのコピーリンクがクリップボードにコピーされました!
以下の変数は、Red Hat Quay がイベントをログに記録し、デバッグ情報を公開して、システムヘルスチェックと対話する方法を制御します。これらの設定は、レジストリーのトラブルシューティングと監視に役立ちます。
変数 | 型 | 説明 |
---|---|---|
DEBUGLOG | Boolean | デバッグログを有効または無効にするかどうか。 |
USERS_DEBUG |
整数。 |
パスワードを含むクリアテキストで LDAP 操作をデバッグするために使用されます。 重要
|
ALLOW_PULLS_WITHOUT_STRICT_LOGGING | Boolean |
true に指定すると、プルの監査ログのエントリーに書き込みできない場合でも、プルは成功します。これは、データベースが読み取り専用の状態にフォールバックし、その間プルを続行する必要がある場合に便利です。 |
ENABLE_HEALTH_DEBUG_SECRET | String | 指定していると、スーパーユーザーとして認証されていない場合に詳細なデバッグ情報を表示するために正常性エンドポイントに指定できるシークレット。 |
HEALTH_CHECKER | String |
設定済みのヘルスチェック。 |
FEATURE_AGGREGATED_LOG_COUNT_RETRIEVAL | Boolean |
集計されたログ数の取得を許可するかどうか。 |
ロギングとデバッグの YAML サンプル
10.1.5. レジストリー状態とシステム動作の設定フィールド リンクのコピーリンクがクリップボードにコピーされました!
次の設定フィールドは、Red Hat Quay レジストリーの動作状態と、外部システムとの対話方法を制御します。これらの設定により、管理者はメンテナンスの目的でレジストリーを制限された読み取り専用モードに設定し、特定のホスト名が Webhook の対象になるのをブロックすることで、追加のセキュリティーを強制できます。
フィールド | 型 | 説明 |
---|---|---|
REGISTRY_STATE | String |
レジストリーの状態 |
WEBHOOK_HOSTNAME_BLACKLIST | 文字列の配列 | 検証時に、ローカルホスト以外に Webhook から禁止するホスト名のセット。 |
レジストリー状態とシステム動作の YAML サンプル