13.4. QuayEcosystem 업그레이드


제한된 구성 집합에 QuayEcosystem API를 사용하는 이전 버전의 Operator에서 업그레이드가 지원됩니다. 마이그레이션이 예기치 않게 발생하지 않도록 하려면 이를 마이그레이션하려면 QuayEcosystem 에 특수 레이블을 적용해야 합니다. Operator가 관리할 수 있도록 새 QuayRegistry 가 생성되지만, 문제가 발생하는 경우에도 QuayEcosystem 을 롤백하고 Quay에 계속 액세스할 수 있도록 이전 QuayEcosystem이 수동으로 삭제될 때까지 유지됩니다. 기존 QuayEcosystem 을 새 QuayRegistry 로 마이그레이션하려면 다음 단계를 따르십시오.

  1. QuayEcosystemmetadata.labels"quay-operator/migrate": "true" 를 추가합니다.

    $ oc edit quayecosystem <quayecosystemname>
    metadata:
      labels:
        quay-operator/migrate: "true"
  2. QuayEcosystem 과 동일한 metadata.name 을 사용하여 QuayRegistry 가 생성될 때까지 기다립니다. QuayEcosystem"quay-operator/migration-complete": "true" 라벨이 표시됩니다.
  3. QuayRegistrystatus.registryEndpoint 가 설정되면 Quay에 액세스하여 모든 데이터 및 설정이 성공적으로 마이그레이션되었는지 확인합니다.
  4. 모든 항목이 올바르게 작동했다고 확신하면 QuayEcosystem 을 삭제할 수 있으며 Kubernetes 가비지 컬렉션은 이전 리소스를 모두 정리합니다.

13.4.1. QuayEcosystem 업그레이드 되돌리기

QuayEcosystem 에서 QuayRegistry 로 자동 업그레이드하는 동안 문제가 발생하면 다음 단계에 따라 QuayEcosystem 을 사용하여 되돌아갑니다.

  1. UI 또는 kubectl 을 사용하여 QuayRegistry 를 삭제합니다.

    $ kubectl delete -n <namespace> quayregistry <quayecosystem-name>
  2. 경로 를 사용하여 외부 액세스가 제공된 경우 UI 또는 kubectl 을 사용하여 원래 서비스를 가리키도록 경로 를 변경합니다.
참고

QuayEcosystem 에서 Postgres 데이터베이스를 관리하는 경우 업그레이드 프로세스에서 업그레이드된 Operator가 관리하는 새 Postgres 데이터베이스로 데이터를 마이그레이션합니다. 이전 데이터베이스는 변경 또는 제거되지 않지만 마이그레이션이 완료되면 더 이상 Quay를 사용하지 않습니다. 데이터 마이그레이션 중에 문제가 발생하면 업그레이드 프로세스가 종료되고 관리되지 않는 구성 요소로 데이터베이스를 계속 사용하는 것이 좋습니다.

13.4.2. 업그레이드를 위해 지원되는 QuayEcosystem 구성

Quay Operator는 QuayEcosystem 구성 요소를 마이그레이션하는 데 실패하거나 지원되지 않는 경우 로그 및 status.conditions 에서 오류를 보고합니다. Kubernetes 리소스를 채택할 필요가 없으며 필요한 모든 값은 Quay의 config.yaml 에서 이미 제공되므로 관리되지 않는 모든 구성 요소를 성공적으로 마이그레이션해야 합니다.

데이터베이스

임시 데이터베이스가 지원되지 않습니다(volumeSize 필드를 설정해야 함).

Redis

특별한 필요 없습니다.

외부 액세스

자동 마이그레이션에는 패스스루 경로 액세스만 지원됩니다. 다른 방법에 필요한 수동 마이그레이션

  • 사용자 지정 호스트 이름이 없는 LoadBalancer: QuayEcosystem"quay-operator/migration-complete": "true" 레이블로 표시된 후 QuayEcosystem 에서 metadata.ownerReferences 필드를 기존 서비스에서 삭제 하여 Kubernetes가 서비스를 가비지 수집하지 못하도록 하고 로드 밸런서를 제거합니다. metadata.name 형식 < QuayEcosystem-name>-quay-app 으로 새 서비스가 생성됩니다. 기존 서비스의 spec.selector 를 새 서비스의 spec.selector 와 일치하도록 편집하여 이전 로드 밸런서 끝점에 대한 트래픽이 이제 새 Pod로 이동합니다. 이제 이전 서비스를 담당합니다. Quay Operator는 이를 관리하지 않습니다.
  • 사용자 지정 호스트 이름이 있는 LoadBalancer/NodePort/Ingress: LoadBalancer 유형의 새로운 서비스는 metadata.name 형식 < QuayEcosystem-name>-quay-app 으로 생성됩니다. 새 서비스에서 제공하는 status.loadBalancer 엔드포인트를 가리키도록 DNS 설정을 변경합니다.

Clair

특별한 필요 없습니다.

오브젝트 스토리지

QuayEcosystem 에는 관리형 개체 스토리지 구성 요소가 없으므로 오브젝트 스토리지는 항상 관리되지 않는 것으로 표시됩니다. 로컬 스토리지는 지원되지 않습니다.

저장소 미러링

특별한 필요 없습니다.

추가 리소스

  • Red Hat Quay Operator에 대한 자세한 내용은 업스트림 quay-operator 프로젝트를 참조하십시오.
Red Hat logoGithubredditYoutubeTwitter

자세한 정보

평가판, 구매 및 판매

커뮤니티

Red Hat 소개

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

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

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

Red Hat 문서 정보

Legal Notice

Theme

© 2026 Red Hat
맨 위로 이동