2.2. OpenShift에 3scale Operator 설치
3scale은 OCP(OpenShift Container Platform)의 마지막 두 가지 일반 가용성(GA) 릴리스를 지원합니다. 자세한 내용은 Red Hat 3scale API Management Supported Configurations 페이지를 참조하십시오.
이 문서에서는 다음을 수행하는 방법을 보여줍니다.
- 새 프로젝트를 생성합니다.
- Red Hat 3scale API Management 인스턴스를 배포합니다.
- OLM(Operator Lifecycle Manager)을 통해 3scale Operator를 설치합니다.
- Operator가 배포되면 사용자 정의 리소스를 배포합니다.
사전 요구 사항
관리자 권한이 있는 계정을 사용하여 지원되는 OpenShift Container Platform 4 클러스터에 액세스할 수 있습니다.
- 지원되는 구성에 대한 자세한 내용은 Red Hat 3scale API Management Supported Configurations 페이지를 참조하십시오.
새로 생성된 별도의 빈 프로젝트에 3scale Operator 및 CRD(사용자 정의 리소스 정의)를 배포합니다. 인프라가 포함된 기존 프로젝트에 배포하는 경우 기존 요소를 변경하거나 삭제할 수 있습니다.
OpenShift에 3scale Operator를 설치하려면 다음 섹션에 설명된 단계를 수행합니다.
2.2.1. 새 OpenShift 프로젝트 생성
다음 절차에서는 3scale-project
라는 새 OpenShift 프로젝트를 생성하는 방법을 설명합니다. 이 프로젝트 이름을 자신의 이름으로 바꿉니다.
절차
새 OpenShift 프로젝트를 생성하려면 다음을 수행합니다.
영숫자 및 대시를 사용하여 유효한 이름을 지정합니다. 예를 들어 아래 명령을 실행하여
3scale-project
를 생성합니다.$ oc new-project 3scale-project
이렇게 하면 Operator, APIManager CR(사용자 정의 리소스) 및 Capabilities 사용자 정의 리소스가 설치된 새 OpenShift 프로젝트 가 생성됩니다. Operator는 해당 프로젝트의 OLM을 통해 사용자 정의 리소스를 관리합니다.
2.2.2. OLM을 사용하여 3scale Operator 설치 및 구성
OLM(Operator Lifecycle Manager)을 사용하여 OCP 콘솔의 OperatorHub를 통해 OCP(OpenShift Container Platform) 4.8(또는 위의) 클러스터에 3scale Operator를 설치합니다. 다음 설치 모드를 사용하여 3scale Operator를 설치할 수 있습니다.
- 클러스터 전체에서 클러스터의 모든 네임스페이스에서 Operator를 사용할 수 있습니다.
- 클러스터의 특정 네임스페이스
제한된 네트워크 또는 연결이 끊긴 클러스터에서 OpenShift Container Platform을 사용하는 경우 Operator Lifecycle Manager에서 더 이상 OperatorHub를 사용할 수 없습니다. 제한된 네트워크에서 Operator Lifecycle Manager를 사용하여 이름이 지정된 가이드의 OLM을 설정하고 사용하는 방법에 대한 지침을 따릅니다.
사전 요구 사항
- 새 OpenShift 프로젝트 생성에 정의된 프로젝트에 3scale Operator를 설치하고 배포해야 합니다.
절차
OpenShift Container Platform 콘솔에서 관리자 권한이 있는 계정을 사용하여 로그인합니다.
참고메뉴 구조는 사용 중인 OpenShift 버전에 따라 다릅니다.
- Operators > OperatorHub를 클릭합니다.
- 키워드로 필터링 상자에 3scale operator 를 입력하여 Red Hat Integration - 3scale 을 찾습니다.
- Red Hat Integration - 3scale 을 클릭합니다. Operator에 대한 정보가 표시됩니다.
- Operator에 대한 정보를 읽고 설치를 클릭합니다. Operator 설치 페이지가 열립니다.
- Operator 설치 페이지의 채널 업데이트 섹션에서 업데이트할 채널을 선택합니다.
설치 모드 섹션에서 Operator를 설치할 위치를 선택합니다.
- 클러스터의 모든 네임스페이스(기본값) - 클러스터의 모든 네임스페이스에서 Operator를 사용할 수 있습니다.
- 클러스터의 특정 네임스페이스 - Operator는 선택한 클러스터의 특정 단일 네임 스페이스에서만 사용할 수 있습니다.
- 설치를 클릭합니다.
- 설치가 완료되면 Operator를 사용할 준비가 되었음을 나타내는 확인 메시지가 표시됩니다.
3scale Operator CSV(ClusterServiceVersion)가 올바르게 설치되었는지 확인합니다. 또한 Operator 설치에 성공했다고 보고하는지 확인합니다.
- Operators > 설치된 Operators를 클릭합니다.
- Red Hat Integration - 3scale Operator를 클릭합니다.
- Details 탭에서 Conditions 섹션까지 아래로 스크롤합니다. 여기서 Succeeded 조건은 Reason 열에 있는 InstallSucceeded 로 표시되어야 합니다.
표시된 절차 외에도 제한된 네트워크에서 OCP를 사용하는 동안 3scale 개발자 포털에서 사용하려는 허용된 도메인 목록을 생성합니다. 다음 예제를 고려하십시오.
- 개발자 포털에 추가할 모든 링크입니다.
- SSO는 GitHub와 같은 타사 SSO 공급자를 통해 통합됩니다.
- 빌링.
- 외부 URL을 트리거하는 Webhook입니다.
2.2.2.1. 연결이 끊긴 환경의 제한 사항
다음 목록에는 3scale 2.13에 대한 연결이 끊긴 환경의 현재 제한 사항이 요약되어 있습니다.
- 개발자 포털에 대한 GitHub 로그인은 사용할 수 없습니다.
- 지원 링크가 작동하지 않습니다.
- 외부 설명서에 대한 링크가 작동하지 않습니다.
- 개발자 포털의 OAS(OpenAPI Specification)의 유효성 검증기가 작동하지 않고 외부 서비스에 대한 링크에 영향을 미칩니다.
ActiveDocs 의 제품 개요 페이지에서 OAS에 대한 링크가 작동하지 않습니다.
- 또한 새 ActiveDocs 사양을 생성할 때 Skip swagger 검증 옵션을 확인해야 합니다.
추가 리소스
- 문제 해결에 대한 자세한 내용은 OpenShift Container Platform 설명서를 참조하십시오.
- 조정된 네트워크에서 OLM을 사용하는 방법에 대한 자세한 내용은 제한된 네트워크에서 Operator Lifecycle Manager 사용을 참조하십시오.
- 제한된 네트워크에서 설치를 준비하는 방법에 대한 자세한 내용은 연결이 끊긴 설치의 이미지 미러링을 참조하십시오.
- 지원되는 구성에 대한 자세한 내용은 Red Hat 3scale API Management Supported Configurations 페이지를 참조하십시오.
2.2.3. OLM을 사용하여 3scale Operator 업그레이드
3scale Operator를 단일 네임스페이스에서 Operator 기반 배포의 모든 네임스페이스에 클러스터 전체 설치로 업그레이드하려면 네임스페이스에서 3scale Operator를 제거한 다음 클러스터에서 Operator를 다시 설치해야 합니다.
클러스터 관리자는 웹 콘솔을 사용하여 선택한 네임스페이스에서 설치된 Operator를 삭제할 수 있습니다. Operator를 설치 제거해도 기존 3scale 인스턴스가 제거되지 않습니다.
네임스페이스에서 3scale Operator를 제거한 후 OLM을 사용하여 클러스터 전체 모드로 Operator를 설치할 수 있습니다.
사전 요구 사항
- 3scale 관리자 권한 또는 네임스페이스에 대한 삭제 권한이 있는 OpenShift 역할입니다.
절차
OpenShift Container Platform 콘솔에서 관리자 권한이 있는 계정을 사용하여 로그인합니다.
참고메뉴 구조는 사용 중인 OpenShift 버전에 따라 다릅니다.
- Operators > OperatorHub를 클릭합니다. 설치된 Operator 페이지가 표시됩니다.
- 이름으로 필터링에 3scale을 입력하여 Operator를 찾은 후 클릭합니다.
- Operator 세부 정보 페이지의 작업 드롭다운 메뉴에서 Operator 설치 제거를 선택하여 특정 네임스페이스에서 제거합니다.
Operator 설치 제거? 대화 상자가 표시되고 다음이 표시됩니다.
Removing the operator will not remove any of its custom resource definitions or managed resources. If your operator has deployed applications on the cluster or configured off-cluster resources, these will continue to run and need to be cleaned up manually. This action removes the operator as well as the Operator deployments and pods, if any. Any operands and resources managed by the operator, including CRDs and CRs, are not removed. The web console enables dashboards and navigation items for some operators. To remove these after uninstalling the operator, you might need to manually delete the operator CRDs.
- 설치 제거를 선택합니다. 이 Operator는 실행을 중지하고 더 이상 업데이트를 수신하지 않습니다.
- OpenShift Container Platform 콘솔에서 Operator > OperatorHub를 클릭합니다.
- 키워드로 필터링 상자에 3scale operator 를 입력하여 Red Hat Integration - 3scale 을 찾습니다.
- Red Hat Integration - 3scale 을 클릭합니다. Operator에 대한 정보가 표시됩니다.
- 설치를 클릭합니다. Operator 설치 페이지가 열립니다.
- Operator 설치 페이지의 채널 업데이트 섹션에서 업데이트할 채널을 선택합니다.
- 설치 모드 섹션에서 클러스터의 모든 네임스페이스(기본값)를 선택합니다. Operator는 클러스터의 모든 네임스페이스에서 사용할 수 있습니다.
- Subscribe를 클릭합니다. 3scale Operator 세부 정보 페이지가 표시되고 서브스크립션 개요를 볼 수 있습니다.
- 서브스크립션 업그레이드 상태가 업데이트로 표시되는지 확인합니다.
- 3scale Operator CSV(ClusterServiceVersion)가 표시되는지 확인합니다.
추가 리소스
- 3scale Operator 설치에 대한 자세한 내용은 3scale API Management 설치 및 구성을 참조하십시오.
2.2.3.1. 마이크로 릴리스의 자동화된 애플리케이션 구성
자동 업데이트를 가져오려면 3scale Operator에 승인 전략이 자동으로 설정되어 있어야 합니다. 이를 통해 마이크로 릴리스 업데이트를 자동으로 적용할 수 있습니다. 다음에서는 자동 설정과 수동 설정의 차이점을 설명하고 절차의 단계를 간략하게 설명합니다.
자동 및 수동:
- 설치하는 동안 자동 설정은 기본적으로 선택한 옵션입니다. 새 업데이트의 설치는 사용 가능할 때 발생합니다. 설치 중 또는 설치 후 언제든지 변경할 수 있습니다.
- 설치 중 또는 설치 후 수동 옵션을 선택하면 언제든지 사용 가능한 업데이트를 받게 됩니다. 다음으로 설치 계획을 승인하고 직접 적용해야 합니다.
절차
- Operators > 설치된 Operators를 클릭합니다.
- 설치된 Operator 목록에서 3scale API Management를 클릭합니다.
- 서브스크립션 탭을 클릭합니다. 서브스크립션 세부 정보 제목 아래에는 하위 승인이 표시됩니다.
- 승인 아래 링크를 클릭합니다. 이 링크는 기본적으로 자동으로 설정됩니다. 업데이트 승인 전략 변경 이라는 제목이 있는 모달이 표시됩니다.
- 기본 설정 옵션 자동 (기본값) 또는 수동을 선택한 다음 저장을 클릭합니다.
추가 리소스
- 네임스페이스의 Operator 설치 아래의 승인 전략을 참조하십시오.