이 콘텐츠는 선택한 언어로 제공되지 않습니다.

Chapter 4. Deploying Red Hat Quay


After you have configured your Red Hat Quay deployment, you can deploy it using the following procedures.

Prerequisites

  • The Red Hat Quay database is running.
  • The Redis server is running.

4.1. Creating the YAML configuration file

Use the following procedure to deploy Red Hat Quay locally.

Procedure

  1. Enter the following command to create a minimal config.yaml file that is used to deploy the Red Hat Quay container:

    $ touch config.yaml
    Copy to Clipboard Toggle word wrap
  2. Copy and paste the following YAML configuration into the config.yaml file:

    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. Create a directory to copy the Red Hat Quay configuration bundle to:

    $ mkdir $QUAY/config
    Copy to Clipboard Toggle word wrap
  4. Copy the Red Hat Quay configuration file to the directory:

    $ cp -v config.yaml $QUAY/config
    Copy to Clipboard Toggle word wrap

4.1.1. Configuring a Red Hat Quay superuser

You can optionally add a superuser by editing the config.yaml file to add the necessary configuration fields. The list of superuser accounts is stored as an array in the field SUPER_USERS. Superusers have the following capabilities:

  • User management
  • Organization management
  • Service key management
  • Change log transparency
  • Usage log management
  • Globally-visible user message creation

Procedure

  1. Add the SUPER_USERS array to the config.yaml file:

    SERVER_HOSTNAME: quay-server.example.com
    SETUP_COMPLETE: true
    SUPER_USERS:
      - quayadmin 
    1
    
    ...
    Copy to Clipboard Toggle word wrap
    1
    If following this guide, use quayadmin.

4.2. Prepare local storage for image data

Use the following procedure to set your local file system to store registry images.

Procedure

  1. Create a local directory that will store registry images by entering the following command:

    $ mkdir $QUAY/storage
    Copy to Clipboard Toggle word wrap
  2. Set the directory to store registry images:

    $ setfacl -m u:1001:-wx $QUAY/storage
    Copy to Clipboard Toggle word wrap

4.3. Deploy the Red Hat Quay registry

Use the following procedure to deploy the Quay registry container.

Procedure

  • Enter the following command to start the Quay registry container, specifying the appropriate volumes for configuration data and local storage for image data:

    $ 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.13.8
    Copy to Clipboard Toggle word wrap
맨 위로 이동
Red Hat logoGithubredditYoutubeTwitter

자세한 정보

평가판, 구매 및 판매

커뮤니티

Red Hat 문서 정보

Red Hat을 사용하는 고객은 신뢰할 수 있는 콘텐츠가 포함된 제품과 서비스를 통해 혁신하고 목표를 달성할 수 있습니다. 최신 업데이트를 확인하세요.

보다 포괄적 수용을 위한 오픈 소스 용어 교체

Red Hat은 코드, 문서, 웹 속성에서 문제가 있는 언어를 교체하기 위해 최선을 다하고 있습니다. 자세한 내용은 다음을 참조하세요.Red Hat 블로그.

Red Hat 소개

Red Hat은 기업이 핵심 데이터 센터에서 네트워크 에지에 이르기까지 플랫폼과 환경 전반에서 더 쉽게 작업할 수 있도록 강화된 솔루션을 제공합니다.

Theme

© 2025 Red Hat