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
-
속성 | 유형 | 설명 |
---|---|---|
|
| 플러그인에 연결해야 하는 서비스 이름입니다. |
|
| 플러그인이 연결해야 하는 서비스의 네임스페이스 |
|
| 플러그인이 연결해야 하는 서비스가 수신 대기 중인 포트입니다. |