2.3. OpenShift 4.x에 API kdump 설치
Red Hat Fuse on OpenShift는 REST API를 설계하는 데 사용할 수 있는 웹 기반 API design 툴인 API Authenticator를 제공합니다. APIanchor Operator는 OpenShift Container Platform 4.x에서 APIanchor의 설치 및 업그레이드를 간소화합니다.
OpenShift 관리자는 APIanchor Operator를 OpenShift 프로젝트(네임스페이스)에 설치합니다. Operator가 설치되면 선택한 네임스페이스에서 Operator가 실행됩니다. 그러나 OpenShift 관리자 또는 OpenShift 관리자로서 API 7.3을 서비스로 사용할 수 있도록 하려면 또는 개발자가 APIanchor 인스턴스를 생성해야 합니다. APIanchor 서비스는 APIanchor 웹 콘솔에 액세스할 수 있는 URL을 제공합니다.
사전 요구 사항
- OpenShift 클러스터에 대한 관리자 액세스 권한이 있어야 합니다.
-
registry.redhat.io에 대한 인증이 구성되어 있습니다.
절차
- OpenShift 4.x 서버를 시작합니다.
- 웹 브라우저에서 브라우저에서 OpenShift 콘솔로 이동합니다. 자격 증명을 사용하여 콘솔에 로그인합니다.
- Operators 를 클릭한 다음 OperatorHub 를 클릭합니다.
- 검색 필드에 APIanchor를 입력합니다.
- Red Hat Integration - APIanchor 카드를 클릭합니다. Red Hat Integration - API Authenticator Operator 설치 페이지가 열립니다.
설치를 클릭합니다. Operator 설치 페이지가 열립니다.
- Update Channel 은 fuse-console-7.11.x 를 선택합니다.
- 설치 모드 의 경우 클러스터의 네임스페이스 목록에서 네임스페이스(프로젝트)를 선택합니다.
승인 전략 의 경우 자동 또는 설명서 를 선택하여 OpenShift가 APIanchor Operator에 대한 업데이트를 처리하는 방법을 구성합니다.
- 자동 업데이트를 선택하는 경우 새 버전의 API Authenticator Operator를 사용할 수 있는 경우 OpenShift Operator Lifecycle Manager(OLM)는 사람의 개입 없이 APIanchor의 실행 중인 인스턴스를 자동으로 업그레이드합니다.
- 수동 업데이트를 선택하면 최신 버전의 Operator가 사용 가능할 때 OLM에서 업데이트 요청을 생성합니다. 클러스터 관리자는 APIanchor Operator가 새 버전으로 업데이트되도록 업데이트 요청을 수동으로 승인해야 합니다.
- 설치를 클릭하여 지정된 네임스페이스(프로젝트)에서 API Authenticator Operator를 사용할 수 있도록 합니다.
- API Webhook가 프로젝트에 설치되었는지 확인하려면 Operator 를 클릭한 다음 설치된 Operator 를 클릭하여 목록에서 Red Hat Integration - APIanchor 를 확인합니다.
다음 단계
APIanchor Operator가 설치되면 APIanchor의 인스턴스를 생성하여 OpenShift 프로젝트에 서비스로 API design를 추가해야 합니다. 이 작업은 다음 두 가지 방법으로 수행할 수 있습니다.
- OpenShift 관리자는 2.3.1절. “OpenShift 4.x 프로젝트에 서비스로 API 7.3 추가” 의 단계를 실행할 수 있습니다.
OpenShift 개발자는 Designing API 에 설명된 단계를 실행할 수 있습니다.
APIanchor 서비스는 APIanchor 웹 콘솔에 액세스할 수 있는 URL을 제공합니다.
2.3.1. OpenShift 4.x 프로젝트에 서비스로 API 7.3 추가
APIanchor Operator가 OpenShift 4.x 프로젝트에 설치되면 (또는 OpenShift 개발자)를 OpenShift 프로젝트에 서비스로 추가할 수 있습니다. API 7.3 서비스는 개발자가 API DaemonSet 웹 콘솔에 액세스하는 데 사용하는 URL을 제공합니다.
OpenShift 개발자가 서비스로서 OpenShift 4.x 프로젝트에 API 7.3을 추가하기 위해 수행하는 단계는 API 설계를 참조하십시오.
사전 요구 사항
- OpenShift 클러스터에 대한 관리자 액세스 권한이 있어야 합니다.
- APIanchor Operator가 현재 OpenShift 프로젝트에 설치되어 있습니다.
절차
- OpenShift 웹 콘솔에서 Operator를 클릭한 다음 설치된 Operator 를 클릭합니다.
- 이름 열에서 Red Hat Integration - APIanchor를 클릭합니다.
제공된 API 에서 인스턴스 생성을 클릭합니다.
APIanchor 인스턴스에 대한 시작 템플릿이 최소인 기본 양식이 열립니다. 기본값을 수락하거나 선택적으로 편집합니다.
- 만들기 를 클릭하여 새 apicurito-service 를 생성합니다. OpenShift는 새 API의 pod, 서비스 및 기타 구성 요소를 시작합니다.
APIanchor 서비스를 사용할 수 있는지 확인하려면 다음을 수행하십시오.
- Operators 를 클릭한 다음 설치된 Operator를 클릭합니다.
Provided APIs 열에서 Apicurito CRD 를 클릭합니다.
Operator 세부 정보 페이지에서 apicurito-service 가 나열됩니다.
API Authenticator를 여는 방법은 다음과 같습니다.
- 네트워킹 > 경로 를 선택합니다.
- 올바른 프로젝트가 선택되어 있는지 확인합니다.
apicurito-service-ui 행의 위치 열에서 URL을 클릭합니다.
API DaemonSet 웹 콘솔이 새 브라우저 탭에서 열립니다.
2.3.2. OpenShift 4.x에서 API Webhook 업그레이드
Red Hat OpenShift 4.x는 Red Hat Fuse Operator를 포함한 운영자 업데이트를 처리합니다. 자세한 내용은 Operator OpenShift 설명서 를 참조하십시오.
결과적으로 Operator 업데이트가 애플리케이션 업그레이드를 트리거할 수 있습니다. 애플리케이션 업그레이드 방법은 애플리케이션 구성 방법에 따라 다릅니다.
APIanchor 애플리케이션의 경우 API 지브러 Operator를 업그레이드할 때 OpenShift는 클러스터의 모든 APIPrefix 애플리케이션도 자동으로 업그레이드합니다.
일반 Operator 업그레이드 프로세스는 API Authenticator 7.8에서 APIanchor 7.9로 업그레이드할 때 작동하지 않습니다. APIanchor를 Fuse 7.8에서 Fuse 7.9로 업그레이드하려면 7.8 API Authenticator Operator를 삭제한 다음 7.9 API visualization Operator를 설치해야 합니다.
2.3.3. API Authenticator의 미터링 라벨
OpenShift Metering Operator를 사용하여 설치된 API Authenticator Operator, UI 구성 요소 및 코드 생성기를 분석하여 Red Hat 서브스크립션을 준수하는지 여부를 확인할 수 있습니다. 미터링에 대한 자세한 내용은 OpenShift 설명서 를 참조하십시오.
다음 표에는 APIanchor의 미터링 라벨이 나열되어 있습니다.
| 레이블 | 가능한 값 |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
예
API Authenticator Operator의 예:
apicurito-operator com.company: Red_Hat rht.prod_name: Red_Hat_Integration rht.prod_ver: 7.11 rht.comp: Fuse rht.comp_ver: 7.11 rht.subcomp: fuse-apicurito rht.subcomp_t: infrastructure
API kdump UI 구성 요소의 예:
com.company: Red_Hat rht.prod_name: Red_Hat_Integration rht.prod_ver: 7.11 rht.comp: Fuse rht.comp_ver: 7.11 rht.subcomp: apicurito-service-ui rht.subcomp_t: infrastructure
API Authenticator 생성 구성 요소의 예:
com.company: Red_Hat rht.prod_name: Red_Hat_Integration rht.prod_ver: 7.11 rht.comp: Fuse rht.comp_ver: 7.11 rht.subcomp: apicurito-service-generator rht.subcomp_t: infrastructure
2.3.4. 제한된 환경에서 API Webhook를 설치하기 위한 고려 사항
제한된 환경에 설치된 OpenShift 클러스터는 기본적으로 Red Hat 제공 OperatorHub 소스에 액세스할 수 없습니다. 해당 원격 소스에는 완전한 인터넷 연결이 필요하기 때문입니다. 이러한 환경에서 APITEXT Operator를 설치하려면 다음 사전 요구 사항을 완료해야 합니다.
- OLM(Operator Lifecycle Manager)의 기본 원격 OperatorHub 소스를 비활성화합니다.
- 완전한 인터넷 액세스가 가능한 워크스테이션을 사용하여 OperatorHub 콘텐츠의 로컬 미러를 생성합니다.
- 기본 원격 소스 대신 로컬 소스에서 Operator를 설치하고 관리하도록 OLM을 구성합니다.
자세한 내용은 OpenShift 문서의 제한된 네트워크에서 Operator Lifecycle Manager 사용 섹션을 참조하십시오. OperatorHub의 로컬 미러를 생성한 후에는 다음 단계를 수행할 수 있습니다.
