6장. ConsolePlugin [console.openshift.io/v1]
- 설명
- ConsolePlugin은 클러스터에서 실행되는 다른 서비스에서 코드를 동적으로 로드하여 OpenShift 웹 콘솔을 사용자 정의하는 확장 프로그램입니다. 호환성 수준 1: 최소 12 개월 또는 3 개의 마이너 릴리스 (더 긴 버전) 동안 주요 릴리스 내에서 사용할 수 있습니다.
- 유형
- 
						object
- 필수 항목
- 
								메타데이터
- 
								spec
 
- 
								
6.1. 사양
| 속성 | 유형 | 설명 | 
|---|---|---|
| 
								 | 
								 | APIVersion은 버전이 지정된 이 오브젝트 표현의 스키마를 정의합니다. 서버는 인식된 스키마를 최신 내부 값으로 변환해야 하며, 인식되지 않는 값을 거부할 수 있습니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources | 
| 
								 | 
								 | kind는 이 오브젝트가 나타내는 REST 리소스에 해당하는 문자열 값입니다. 서버는 클라이언트에서 요청을 제출한 끝점에서 이를 유추할 수 있습니다. CamelCase로 업데이트할 수 없습니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds | 
| 
								 | 표준 오브젝트의 메타데이터입니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata | |
| 
								 | 
								 | ConsolePluginSpec은 원하는 플러그인 구성입니다. | 
6.1.1. .spec
- 설명
- ConsolePluginSpec은 원하는 플러그인 구성입니다.
- 유형
- 
								object
- 필수 항목
- 
										백엔드
- 
										displayName
 
- 
										
| 속성 | 유형 | 설명 | 
|---|---|---|
| 
									 | 
									 | 백엔드에는 콘솔의 플러그인을 제공하는 백엔드 구성이 있습니다. | 
| 
									 | 
									 | displayName은 플러그인의 표시 이름입니다. dispalyName은 1~128자 사이여야 합니다. | 
| 
									 | 
									 | i18n은 플러그인의 현지화 리소스의 구성입니다. | 
| 
									 | 
									 | proxy는 플러그인이 연결해야 하는 다양한 서비스 유형을 설명하는 프록시 목록입니다. | 
| 
									 | 
									 | ConsolePluginProxy는 콘솔의 백엔드가 플러그인의 요청을 프록시하는 다양한 서비스 유형에 대한 정보를 보유합니다. | 
6.1.2. .spec.backend
- 설명
- 백엔드에는 콘솔의 플러그인을 제공하는 백엔드 구성이 있습니다.
- 유형
- 
								object
- 필수 항목
- 
										type
 
- 
										
| 속성 | 유형 | 설명 | 
|---|---|---|
| 
									 | 
									 | 서비스는 HTTP 서버와의 배포를 사용하여 플러그인을 노출하는 Kubernetes 서비스입니다. 서비스는 HTTPS 및 서비스 제공 인증서를 사용해야 합니다. 콘솔 백엔드는 서비스 CA 번들을 사용하여 서비스에서 플러그인 자산을 프록시합니다. | 
| 
									 | 
									 | type은 콘솔의 플러그인에 있는 서버의 백엔드 유형입니다. 현재 "서비스"만 지원됩니다. --- | 
6.1.3. .spec.backend.service
- 설명
- 서비스는 HTTP 서버와의 배포를 사용하여 플러그인을 노출하는 Kubernetes 서비스입니다. 서비스는 HTTPS 및 서비스 제공 인증서를 사용해야 합니다. 콘솔 백엔드는 서비스 CA 번들을 사용하여 서비스에서 플러그인 자산을 프록시합니다.
- 유형
- 
								object
- 필수 항목
- 
										name
- 
										네임스페이스
- 
										port
 
- 
										
| 속성 | 유형 | 설명 | 
|---|---|---|
| 
									 | 
									 | 
									basePath는 플러그인 자산의 경로입니다. 주요 자산은 플러그인 및 확장에 대한 메타데이터가 포함된 JSON 문서인  | 
| 
									 | 
									 | 플러그인 자산을 제공하는 서비스 이름입니다. | 
| 
									 | 
									 | 플러그인 자산을 제공하는 서비스의 네임스페이스입니다. | 
| 
									 | 
									 | 플러그인을 제공하는 서비스가 수신 대기하는 포트입니다. | 
6.1.4. .spec.i18n
- 설명
- i18n은 플러그인의 현지화 리소스의 구성입니다.
- 유형
- 
								object
- 필수 항목
- 
										loadType
 
- 
										
| 속성 | 유형 | 설명 | 
|---|---|---|
| 
									 | 
									 | loadType은 플러그인의 로컬라이제이션 리소스를 로드하는 방법을 나타냅니다. 유효한 값은 Preload, Lazy 및 빈 문자열입니다. Preload로 설정하면 플러그인이 로드될 때 모든 로컬라이제이션 리소스를 가져옵니다. Lazy로 설정하면 현지화 리소스가 콘솔에 필요한 대로 로드됩니다. 생략하거나 빈 문자열로 설정하면 동작은 Lazy 유형과 동일합니다. | 
6.1.5. .spec.proxy
- 설명
- proxy는 플러그인이 연결해야 하는 다양한 서비스 유형을 설명하는 프록시 목록입니다.
- 유형
- 
								array
6.1.6. .spec.proxy[]
- 설명
- ConsolePluginProxy는 콘솔의 백엔드가 플러그인의 요청을 프록시하는 다양한 서비스 유형에 대한 정보를 보유합니다.
- 유형
- 
								object
- 필수 항목
- 
										별칭
- 
										endpoint
 
- 
										
| 속성 | 유형 | 설명 | 
|---|---|---|
| 
									 | 
									 | alias는 플러그인의 프록시를 식별하는 프록시 이름입니다. 별칭 이름은 플러그인당 고유해야 합니다. 콘솔 백엔드는 프록시 끝점에 따라 노출됩니다. /api/proxy/plugin/<plugin-name>/<proxy-alias>/<request-path>?<optional-query-parameters> 요청 예 경로: /api/proxy/plugin/acm/search/pods?namespace=openshift-apiserver | 
| 
									 | 
									 | 권한 부여는 프록시 요청이 포함되어야 하는 권한 부여 유형에 대한 정보를 제공합니다. | 
| 
									 | 
									 | caCertificate는 프록시 서비스에서 사용자 정의 서비스 CA를 사용하는 경우 인증 기관 인증서 콘텐츠를 제공합니다. 기본적으로 service-ca Operator에서 제공하는 서비스 CA 번들이 사용됩니다. | 
| 
									 | 
									 | 엔드포인트는 요청이 프록시되는 끝점에 대한 정보를 제공합니다. | 
6.1.7. .spec.proxy[].endpoint
- 설명
- 엔드포인트는 요청이 프록시되는 끝점에 대한 정보를 제공합니다.
- 유형
- 
								object
- 필수 항목
- 
										type
 
- 
										
| 속성 | 유형 | 설명 | 
|---|---|---|
| 
									 | 
									 | 서비스는 플러그인이 연결할 클러스터 내 서비스입니다. 서비스는 HTTPS를 사용해야 합니다. 콘솔 백엔드는 플러그인과 서비스 간의 통신을 프록시하기 위해 끝점을 노출합니다. 참고: 현재 "Service" 유형만 지원되므로 현재 service 필드가 필요합니다. | 
| 
									 | 
									 | type은 콘솔 플러그인의 프록시 유형입니다. 현재 "서비스"만 지원됩니다. --- | 
6.1.8. .spec.proxy[].endpoint.service
- 설명
- 서비스는 플러그인이 연결할 클러스터 내 서비스입니다. 서비스는 HTTPS를 사용해야 합니다. 콘솔 백엔드는 플러그인과 서비스 간의 통신을 프록시하기 위해 끝점을 노출합니다. 참고: 현재 "Service" 유형만 지원되므로 현재 service 필드가 필요합니다.
- 유형
- 
								object
- 필수 항목
- 
										name
- 
										네임스페이스
- 
										port
 
- 
										
| 속성 | 유형 | 설명 | 
|---|---|---|
| 
									 | 
									 | 플러그인에 연결해야 하는 서비스 이름입니다. | 
| 
									 | 
									 | 플러그인이 연결해야 하는 서비스의 네임스페이스 | 
| 
									 | 
									 | 플러그인이 연결해야 하는 서비스가 수신 대기 중인 포트입니다. |