ホーム
製品
Red Hat Quay
3
Red Hat Quay の設定
第4章オンプレミスの Red Hat Quay 設定の概要

第4章オンプレミスの Red Hat Quay 設定の概要

Red Hat Quay のオンプレミスデプロイメントの場合、管理者によって管理される config.yaml ファイルは起動時にコンテナーにマウントされ、初期化中に Red Hat Quay によって読み取られます。config.yaml ファイルは動的に再ロードされないため、ファイルに加えた変更を有効にするにはレジストリーコンテナーを再起動する必要があります。

この章では、次の概念の概要を説明します。

最低限必要な設定フィールド。
デプロイメント後に設定を編集および管理する方法。

このセクションは、オンプレミスの Red Hat Quay デプロイメントタイプに特に適用されます。Red Hat Quay on OpenShift Container Platform の設定については、「Red Hat Quay on OpenShift Container Platform 設定の概要」を参照してください。

4.1. 必須の設定フィールド
リンクのコピー

Red Hat Quay のオンプレミスデプロイメントには、次の設定フィールドが必要です。

Expand

フィールド	タイプ	説明
AUTHENTICATION_TYPE (必須)	文字列	認証情報の認証に使用する認証エンジン｡値: `Database`、`LDAP`、`JWT`、`Keystone`、`OIDC` のいずれか。デフォルト: `Database`
BUILDLOGS_REDIS (必須)	Object	ビルドログキャッシュ用の Redis 接続の詳細。
.host (必須)	文字列	Redis にアクセスできるホスト名。
.password	文字列	Redis インスタンスに接続するためのパスワード。
DATABASE_SECRET_KEY (必須)	文字列	データベース内で機密フィールドを暗号化するのに使用されるキー。この値は、一度設定したら変更しないでください。変更すると、リポジトリーのミラーユーザー名やパスワード設定など、すべての信頼できるフィールドが無効になります。この値は、Operator ベースのデプロイメントの場合、Red Hat Quay Operator によって自動的に設定されます。スタンドアロンデプロイメントの場合、管理者は Open SSL または同様のツールを使用して独自のキーを提供できます。キーの長さが 63 文字を超えないようにしてください。
DB_URI (必須)	文字列	認証情報を含む、データベースにアクセスするための URI。
DISTRIBUTED_STORAGE_CONFIG (必須)	Object	Red Hat Quay で使用するストレージエンジンの設定。各キーは、ストレージエンジンの一意の ID を表します。この値は、ストレージエンジンパラメーターを記述するオブジェクトのタプル (キー、値) で構成されます。デフォルト: `[]`
SECRET_KEY (必須)	文字列	ユーザーセッションを正しく解釈するために必要なセッション Cookie と CSRF トークンを暗号化するために使用されるキー。設定時に値を変更しないでください。すべての Red Hat Quay インスタンスで永続的である必要があります。すべてのインスタンスで永続的でない場合、ログインの失敗やセッションの永続性に関連するその他のエラーが発生する可能性があります。
SERVER_HOSTNAME (必須)	文字列	スキームなしで Red Hat Quay にアクセスできる URL。
SETUP_COMPLETE (必須)	Boolean	これはソフトウェアの以前のバージョンから残されたアーティファクトであり、現在は `True` の値で指定する必要があります。
USER_EVENTS_REDIS (必須)	Object	ユーザーイベント処理の Redis 接続の詳細。
.host (必須)	文字列	Redis にアクセスできるホスト名。
.port (必須)	数値	Redis にアクセスできるポート。
.password	文字列	Redis インスタンスに接続するためのパスワード。

4.1.1. 最小限の設定ファイルの例
リンクのコピー

このセクションでは、最小限の設定ファイルの例を 2 つ示します。1 つはローカルストレージを使用する例、もう 1 つは Google Cloud Platform によるクラウドベースのストレージを使用する例です。

4.1.1.1. ローカルストレージを使用した最小限の設定
リンクのコピー

次の例は、イメージにローカルストレージを使用する最小限の設定ファイルの例を示しています。

重要

概念実証の目的でレジストリーをデプロイする場合は、ローカルストレージのみを使用してください。これは実稼働環境での使用を目的としていません。ローカルストレージを使用する場合は、レジストリーを起動するときに、レジストリーをコンテナー内の datastorage パスのローカルディレクトリーにマッピングする必要があります。詳細は、概念実証 - Red Hat Quay のデプロイを参照してください。

ローカルストレージの最小設定

AUTHENTICATION_TYPE: Database
BUILDLOGS_REDIS:
    host: <quay-server.example.com>
    password: <password>
    port: <port>
DATABASE_SECRET_KEY: <example_database_secret_key>
DB_URI: postgresql://<username>:<password>@<registry_url>.com:<port>/quay
DISTRIBUTED_STORAGE_CONFIG:
  default:
    - LocalStorage
    - storage_path: /datastorage/registry
SECRET_KEY: <example_secret_key>
SERVER_HOSTNAME: <server_host_name>
SETUP_COMPLETE: true
USER_EVENTS_REDIS:
  host: <redis_events_url>
  password: <password>
  port: <port>

AUTHENTICATION_TYPE: Database
BUILDLOGS_REDIS:
    host: <quay-server.example.com>
    password: <password>
    port: <port>
DATABASE_SECRET_KEY: <example_database_secret_key>
DB_URI: postgresql://<username>:<password>@<registry_url>.com:<port>/quay
DISTRIBUTED_STORAGE_CONFIG:
  default:
    - LocalStorage
    - storage_path: /datastorage/registry
SECRET_KEY: <example_secret_key>
SERVER_HOSTNAME: <server_host_name>
SETUP_COMPLETE: true
USER_EVENTS_REDIS:
  host: <redis_events_url>
  password: <password>
  port: <port>

Copy to Clipboard

Toggle word wrap

4.1.1.2. クラウドベースのストレージを使用した最小限の設定
リンクのコピー

ほとんどの実稼働環境では、Red Hat Quay 管理者は、サポートされているベンダーが提供するクラウドまたはエンタープライズグレードのストレージバックエンドを使用します。次の例は、イメージの保存に Google Cloud Platform を使用するように Red Hat Quay を設定する方法を示しています。サポートされているストレージプロバイダーの完全なリストについては、イメージストレージを参照してください。

注記

クラウドまたはエンタープライズグレードのストレージバックエンドを使用する場合、レジストリーをローカルディレクトリーにマッピングするなどの追加設定は必要ありません。

クラウドストレージの最小設定

AUTHENTICATION_TYPE: Database
BUILDLOGS_REDIS:
    host: <quay-server.example.com>
    password: <password>
    port: <port>
DATABASE_SECRET_KEY: <example_database_secret_key>
DB_URI: postgresql://<username>:<password>@<registry_url>.com:<port>/quay
DISTRIBUTED_STORAGE_CONFIG:
    default:
        - GoogleCloudStorage
        - access_key: <access_key>
          bucket_name: <bucket_name>
          secret_key: <secret_key>
          storage_path: /datastorage/registry
DISTRIBUTED_STORAGE_DEFAULT_LOCATIONS: []
DISTRIBUTED_STORAGE_PREFERENCE:
    - default
SECRET_KEY: <example_secret_key>
SERVER_HOSTNAME: <server_host_name>
SETUP_COMPLETE: true
USER_EVENTS_REDIS:
  host: <redis_events_url>
  password: <password>
  port: <port>

AUTHENTICATION_TYPE: Database
BUILDLOGS_REDIS:
    host: <quay-server.example.com>
    password: <password>
    port: <port>
DATABASE_SECRET_KEY: <example_database_secret_key>
DB_URI: postgresql://<username>:<password>@<registry_url>.com:<port>/quay
DISTRIBUTED_STORAGE_CONFIG:
    default:
        - GoogleCloudStorage
        - access_key: <access_key>
          bucket_name: <bucket_name>
          secret_key: <secret_key>
          storage_path: /datastorage/registry
DISTRIBUTED_STORAGE_DEFAULT_LOCATIONS: []
DISTRIBUTED_STORAGE_PREFERENCE:
    - default
SECRET_KEY: <example_secret_key>
SERVER_HOSTNAME: <server_host_name>
SETUP_COMPLETE: true
USER_EVENTS_REDIS:
  host: <redis_events_url>
  password: <password>
  port: <port>

Copy to Clipboard

Toggle word wrap

トップに戻る

第4章オンプレミスの Red Hat Quay 設定の概要

4.1. 必須の設定フィールド
リンクのコピー

4.1.1. 最小限の設定ファイルの例
リンクのコピー

4.1.1.1. ローカルストレージを使用した最小限の設定
リンクのコピー

4.1.1.2. クラウドベースのストレージを使用した最小限の設定
リンクのコピー

詳細情報

試用、購入および販売

コミュニティー

Red Hat ドキュメントについて

多様性を受け入れるオープンソースの強化

会社概要

Theme

Red Hat legal and privacy links

Red Hat legal and privacy links

第4章 オンプレミスの Red Hat Quay 設定の概要

4.1. 必須の設定フィールドリンクのコピーリンクがクリップボードにコピーされました!

4.1.1. 最小限の設定ファイルの例リンクのコピーリンクがクリップボードにコピーされました!

4.1.1.1. ローカルストレージを使用した最小限の設定リンクのコピーリンクがクリップボードにコピーされました!

4.1.1.2. クラウドベースのストレージを使用した最小限の設定リンクのコピーリンクがクリップボードにコピーされました!

詳細情報

試用、購入および販売

コミュニティー

Red Hat ドキュメントについて

多様性を受け入れるオープンソースの強化

会社概要

Theme

Red Hat legal and privacy links

Red Hat legal and privacy links

第4章オンプレミスの Red Hat Quay 設定の概要

4.1. 必須の設定フィールド
リンクのコピー

4.1.1. 最小限の設定ファイルの例
リンクのコピー

4.1.1.1. ローカルストレージを使用した最小限の設定
リンクのコピー

4.1.1.2. クラウドベースのストレージを使用した最小限の設定
リンクのコピー