3scale 마이그레이션
3scale API Management 및 해당 구성 요소를 마이그레이션 또는 업그레이드
초록
머리말
이 가이드에서는 Red Hat 3scale API Management를 템플릿에서 Operator 기반 설치로 마이그레이션하는 방법, 3scale 설치를 2.13에서 2.14로 업그레이드하는 데 필요한 세부 정보, 운영자 기반 배포에서 APIcast를 업그레이드하는 단계를 설명합니다.
3scale 온-프레미스 배포를 2.13에서 2.14로 업그레이드하려면 다음 가이드를 참조하십시오.
Operator 기반 배포의 APIcast를 업그레이드하려면 APIcast 업그레이드 가이드에 나열된 절차를 참조하십시오.
보다 포괄적 수용을 위한 오픈 소스 용어 교체
Red Hat은 코드, 문서, 웹 속성에서 문제가 있는 용어를 교체하기 위해 최선을 다하고 있습니다. 먼저 마스터(master), 슬레이브(slave), 블랙리스트(blacklist), 화이트리스트(whitelist) 등 네 가지 용어를 교체하고 있습니다. 이러한 변경 작업은 작업 범위가 크므로 향후 여러 릴리스에 걸쳐 점차 구현할 예정입니다. 자세한 내용은 CTO Chris Wright의 메시지에서 참조하십시오.
1장. 3scale Operator 기반 업그레이드 가이드: 2.12에서 2.13으로
Operator 기반 설치에서 Red Hat 3scale API Management를 버전 2.13에서 2.14로 업그레이드하여 OpenShift 4.x에서 3scale을 관리합니다.
3scale의 마이크로 출시를 자동으로 얻으려면 자동 업데이트가 있는지 확인하십시오. 이를 확인하려면 마이크로 릴리스의 자동화된 애플리케이션 구성을 참조하십시오.
필요한 조건 및 절차를 이해하려면 나열된 단계를 적용하기 전에 전체 업그레이드 가이드를 읽으십시오. 업그레이드 프로세스에서 절차가 완료될 때까지 서비스 프로비저닝을 중단합니다. 이러한 중단으로 인해 유지 관리 기간이 있는지 확인하십시오.
1.1. 업그레이드를 수행하기 위한 사전 요구 사항
이 섹션에서는 Operator 기반 설치에서 3scale을 2.13에서 2.14로 업그레이드하는 데 필요한 구성에 대해 설명합니다.
- 관리자 액세스 권한이 있는 OpenShift Container Platform 4.6, 4.7, 4.8, 4.9, 4.10, 또는 4.11 클러스터.
- 3scale 2.13은 이전에 3scale Operator를 통해 배포되었습니다.
threescale-2.13
채널의 최신 CSV가 사용 중인지 확인합니다. 이를 확인하려면 다음을 수행하십시오.- 서브스크립션 승인 설정이 자동 이면 이미 채널의 최신 CSV 버전에 있어야 합니다.
- 서브스크립션에 대한 승인 설정이 수동 이면 보류 중인 모든 InstallPlan 을 승인하고 최신 CSV 버전이 있는지 확인하십시오.
- 보류 중인 설치 계획이 있는 경우 기존 보류 중인 계획이 설치된 후에만 표시되는 보류 중인 설치 계획이 더 표시될 수 있습니다.
1.2. Operator 기반 설치에서 2.12에서 2.13으로 업그레이드
Operator 기반 배포에서 버전 2.13에서 2.14로 3scale을 업그레이드하려면 다음을 수행합니다.
- 관리자 권한이 있는 계정을 사용하여 OCP 콘솔에 로그인합니다.
- 3scale-operator 가 배포된 프로젝트를 선택합니다.
- Operators > 설치된 Operators를 클릭합니다.
- Red Hat Integration - 3scale > Subscription > Channel 을 선택합니다.
3scale-2.14 를 선택하여 서브스크립션 채널을 편집하고 변경 사항을 저장합니다.
그러면 업그레이드 프로세스가 시작됩니다.
새 버전이 모두 실행되고 오류 없이 준비가 될 때까지 프로젝트에서 Pod의 상태를 쿼리합니다.
oc get pods -n <3scale_namespace>
$ oc get pods -n <3scale_namespace>
Copy to Clipboard Copied! 참고- Pod에 업그레이드 프로세스 중에 일시적인 오류가 있을 수 있습니다.
- Pod 업그레이드에 필요한 시간은 5-10분에 따라 다를 수 있습니다.
- 새 포드 버전이 실행된 후 3scale 관리 포털에 로그인하고 예상대로 작동하는지 확인하여 업그레이드를 성공적으로 확인합니다.
다음 명령을 실행하여 APIManager 오브젝트의 상태를 확인하고 YAML 콘텐츠를 가져옵니다. <myapimanager>는 APIManager 의 이름을 나타냅니다.
oc get apimanager <myapimanager> -n <3scale_namespace> -o yaml
$ oc get apimanager <myapimanager> -n <3scale_namespace> -o yaml
Copy to Clipboard Copied! 값이 포함된 새 주석은 다음과 같아야 합니다.
apps.3scale.net/apimanager-threescale-version: "2.14" apps.3scale.net/threescale-operator-version: "0.10.0"
apps.3scale.net/apimanager-threescale-version: "2.14" apps.3scale.net/threescale-operator-version: "0.10.0"
Copy to Clipboard Copied!
모든 단계를 수행한 후 Operator 기반 배포에서 2.13에서 2.14로 3scale 업그레이드가 완료됩니다.
2장. APIcast Operator 기반 업그레이드 가이드: 2.12에서 2.13으로
Operator 기반 설치의 APIcast를 2.13에서 2.14로 업그레이드하면 APIcast API 게이트웨이를 사용하여 내부 및 외부 API(애플리케이션 프로그래밍 인터페이스) 서비스를 3scale과 통합할 수 있습니다.
필요한 조건 및 절차를 이해하려면 나열된 단계를 적용하기 전에 전체 업그레이드 가이드를 읽으십시오. 업그레이드 프로세스에서 절차가 완료될 때까지 서비스 프로비저닝을 중단합니다. 이러한 중단으로 인해 유지 관리 기간이 있는지 확인하십시오.
2.1. 업그레이드를 수행하기 위한 사전 요구 사항
Operator 기반 설치에서 2.13에서 2.14로 APIcast 업그레이드를 수행하려면 다음 필수 전제 조건이 이미 있어야 합니다.
- 관리자 액세스 권한이 있는 OpenShift Container Platform(OCP) 4.8, 4.9, 4.10 또는 4.11 클러스터입니다.
- APIcast 2.13은 이전에 APIcast Operator를 통해 배포되었습니다.
threescale-2.13
채널의 최신 CSV가 사용 중인지 확인합니다. 이를 확인하려면 다음을 수행하십시오.- 서브스크립션 승인 설정이 자동 이면 이미 채널의 최신 CSV 버전에 있어야 합니다.
- 서브스크립션에 대한 승인 설정이 수동 이면 보류 중인 모든 InstallPlan 을 승인하고 최신 CSV 버전이 있는지 확인하십시오.
- 보류 중인 설치 계획이 있는 경우 기존 보류 중인 계획이 설치된 후에만 표시되는 보류 중인 설치 계획이 더 표시될 수 있습니다.
2.2. Operator 기반 설치에서 2.12에서 2.13으로 APIcast 업그레이드
Operator 기반 설치에서 APIcast가 3scale 설치에서 API 게이트웨이로 작동할 수 있도록 Operator 기반 설치에서 APIcast를 2.13에서 2.14로 업그레이드합니다.
절차
- 관리자 권한이 있는 계정을 사용하여 OCP 콘솔에 로그인합니다.
- APIcast Operator 가 배포된 프로젝트를 선택합니다.
- Operators > 설치된 Operators를 클릭합니다.
- 서브스크립션 > 채널에서 Red Hat Integration - 3scale APIcast 게이트웨이를 선택합니다.
3scale-2.14 채널을 선택하여 서브스크립션 채널을 편집하고 변경 사항을 저장합니다.
그러면 업그레이드 프로세스가 시작됩니다.
새 버전이 모두 실행되고 오류 없이 준비 상태가 표시될 때까지 프로젝트에서 Pod 상태를 쿼리합니다.
oc get pods -n <apicast_namespace>
$ oc get pods -n <apicast_namespace>
Copy to Clipboard Copied! 참고- Pod에 업그레이드 프로세스 중에 일시적인 오류가 있을 수 있습니다.
- Pod 업그레이드에 필요한 시간은 5-10분에 따라 다를 수 있습니다.
다음 명령을 실행하여 APIcast 오브젝트의 상태를 확인하고 YAML 콘텐츠를 가져옵니다.
oc get apicast <myapicast> -n <apicast_namespace> -o yaml
$ oc get apicast <myapicast> -n <apicast_namespace> -o yaml
Copy to Clipboard Copied!
나열된 모든 단계를 수행한 후 Operator 기반 배포에서 2.13에서 2.14로 APIcast 업그레이드가 완료됩니다.