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

Chapter 12. Upgrade to Quay 2.0.0


All Quay instances being upgraded from versions < 2.0.0 must upgrade to Quay 2.0.0 first before continuing to upgrade. This upgrade has an extra step, documented here.

We highly recommend performing this upgrade during a scheduled maintenance window, as it will require taking the existing cluster down temporarily.

12.1. Download Quay License

To begin, download your Quay License from your Tectonic Account. Please download or copy this license in Raw Format as a file named license:

12.2. Shutdown all Quay instances

Shutdown all running instances of Quay, across all clusters.

12.3. Run a single instance of Quay 2

Run a single instance of Quay 2.0.0 by replacing quay.io/coreos/registry:{currentVersion} with quay.io/coreos/quay:v2.0.0 in your run command, startup script, config or systemd unit.

12.3.1. Add your license to the Quay

Quay setup as a container or under Kubernetes

  • Visit the management panel: Log in as superuser to begin the upgrade process

Sign in to a super user account from the Red Hat Quay login screen. For example, if the host were reg.example.com, you would go to http://reg.example.com/superuser to view the management panel:

  • Click the configuration tab
  • In the section entitled License, paste in the contents of the license downloaded above
  • Click Save Configuration Changes
  • Restart the container (you will be prompted)

12.3.2. Add license via the filesystem

Ensure the Red Hat Quay instance has been shutdown and add the raw format license in license file to the directory mapped to conf/stack, next to the existing config.yaml.

Example:

The conf/stack directory is mapped to quay2/config in docker run command used to bring up Quay:

docker run --restart=always -p 443:443 -p 80:80 --privileged=true -v /quay2/config:/conf/stack -v /quay2/storage:/datastorage -d quay.io/coreos/quay:v2.0.0
Copy to Clipboard Toggle word wrap

The license file resides in the quay2/config directory:

$ ls quay2/config/
config.yaml  license

$ cat quay2/license
eyJhbGciOiJSUzI1NiJ9.eyJzY2hlbWFWZXJzaW9uIjoidjIiLCJ2ZXJzaW9uIjoiMSIsImNyZWF0aW9uRGF0ZSI6IjIwMTYtMTAtMjZUMTc6MjM6MjJaIiwiZXhwaXJ
[...]
Copy to Clipboard Toggle word wrap

12.4. Update cluster

Update all remaining Quay instances to refer to the new image (quay.io/coreos/quay:v2.0.0).

12.5. Verify cluster

Verify that your cluster and its license are valid by performing a push or pull. If you receive an HTTP 402, please make sure your license is properly installed and valid by checking in the management panel (see above for instructions).

If you encounter unusual problems, please contact support.

맨 위로 이동
Red Hat logoGithubredditYoutubeTwitter

자세한 정보

평가판, 구매 및 판매

커뮤니티

Red Hat 문서 정보

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

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

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

Red Hat 소개

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

Theme

© 2025 Red Hat