5장. 콘솔 [operator.openshift.io/v1]

사용자 정의

object

사용자 지정은 선택적으로 웹 콘솔에 작은 사용자 지정 옵션 세트를 제공하는 데 사용됩니다.

Ingress

object

Ingress를 사용하면 콘솔의 대체 인그레스를 구성할 수 있습니다. 이 필드는 Ingress 기능이 없는 클러스터의 경우 경로에 액세스할 수 없습니다.

logLevel

string

로그 수준은 전체 구성 요소에 대한 의도 기반 로깅입니다. 이는 세분화된 제어를 제공하지 않지만 Operator가 피연산자에 대해 해석해야 하는 집계된 로깅 옵션을 관리하는 간단한 방법입니다. 유효한 값은 "Normal", "Debug", "Trace", "TraceAll"입니다. 기본값은 "Normal"입니다.

managementState

string

managementState는 운영자가 구성 요소를 관리하는지 여부와 방법을 나타냅니다.

observedConfig

``

observedConfig에는 컨트롤러가 클러스터 상태에서 관찰한 스파스 구성이 있습니다. 이는 Operator의 수준에 대한 입력이기 때문에 spec에 존재합니다.

operatorLogLevel

string

operatorLogLevel은 Operator 자체에 대한 의도 기반 로깅입니다. 이는 세분화된 제어를 제공하지 않지만 운영자가 자체적으로 해석해야 하는 집계된 로깅 옵션을 관리하는 간단한 방법입니다. 유효한 값은 "Normal", "Debug", "Trace", "TraceAll"입니다. 기본값은 "Normal"입니다.

plugins

배열(문자열)

플러그인은 활성화된 콘솔 플러그인 이름 목록을 정의합니다.

공급자

object

공급자에는 특정 서비스 공급자를 사용하기 위한 구성이 포함되어 있습니다.

라우트

object

route에는 제공 인증서가 포함된 호스트 이름 및 시크릿 참조가 포함되어 있습니다. 사용자 정의 경로가 지정되면 콘솔을 사용할 수 있는 제공된 호스트 이름으로 새 경로가 생성됩니다. 사용자 정의 호스트 이름의 경우 클러스터의 기본 라우팅 접미사를 사용하는 경우 제공 인증서에 대한 Secret 사양이 필요하지 않습니다. 사용자 지정 호스트 이름이 임의의 도메인을 가리키는 경우 수동 DNS 구성 단계가 필요합니다. 사용자 정의 경로가 제거된 경우 콘솔의 기본 호스트 이름을 예약하도록 기본 콘솔 경로가 유지 관리됩니다. 지정하지 않으면 기본 경로가 사용됩니다. 더 이상 사용되지 않음

unsupportedConfigOverrides

``

unsupportedConfigOverrides는 Operator에서 계산된 최종 구성을 재정의합니다. Red Hat은 이 필드의 사용을 지원하지 않습니다. 이 필드를 오용하면 예기치 않은 동작이 발생하거나 다른 구성 옵션과 충돌할 수 있습니다. 이 필드를 사용하기 전에 Red Hat 지원에서 지침을 구하십시오. 이 속성을 사용하면 클러스터 업그레이드가 차단되며 클러스터를 업그레이드하기 전에 제거해야 합니다.

addPage

object

AddPage를 사용하면 개발자 화면의 추가 페이지에서 작업을 사용자 지정할 수 있습니다.

브랜드

string

브랜드는 브랜드 필드를 제공하여 재정의할 수 있는 웹 콘솔의 기본 브랜드입니다. 제한된 특정 브랜드 옵션 세트가 있습니다. 이 필드는 로고와 같은 콘솔의 요소를 제어합니다. 잘못된 값은 콘솔 롤아웃을 방지합니다.

capabilities

array

capabilities는 콘솔 UI에서 상호 작용할 수 있는 기능 배열을 정의합니다. 각 기능은 UI에서 렌더링할 콘솔과 상호 작용할 수 있는 시각적 상태를 정의합니다. 사용 가능한 기능은 LightspeedButton입니다. 사용 가능한 각 기능은 목록에 한 번만 표시될 수 있습니다.

capabilities[]

object

기능에는 UI 기능 세트와 콘솔 UI의 상태가 포함되어 있습니다.

customLogoFile

object

customLogoFile은 마스트 헤드 및 소개 대화 상자의 기본 OpenShift 로고를 대체합니다. openshift-config 네임스페이스의 ConfigMap에 대한 참조입니다. 이는 'oc create configmap custom-logo --from-file=/path/to/file -n openshift-config'와 같은 명령을 사용하여 생성할 수 있습니다. ConfigMap 크기의 제약 조건으로 인해 이미지 크기가 1MB 미만이어야 합니다. ConfigMap 키에는 콘솔이 올바른 MIME 유형으로 파일을 제공하도록 파일 확장자가 포함되어야 합니다. 권장 로고 사양: Cryostats: 68px의 최대 높이 및 최대 너비의 200px SVG 형식

customProductName

string

customProductName은 일반 OpenShift 제품 이름 대신 페이지 제목, 로고 대체 텍스트 및 관련 대화 상자에 표시되는 이름입니다.

developerCatalog

object

developerCatalog를 사용하면 표시된 개발자 카탈로그 카테고리(필터) 및 유형(sub-catalogs)을 구성할 수 있습니다.

documentationBaseURL

string

외부 문서에 대한 documentationBaseURL 링크는 웹 콘솔의 다양한 섹션에 표시됩니다. documentationBaseURL을 제공하면 기본 문서 URL이 재정의됩니다. 잘못된 값은 콘솔 롤아웃을 방지합니다.

perspectives

array

관점을 사용하면 Perspective Switcher 드롭다운에서 사용자가 볼 수 있는 관점을 활성화/비활성화할 수 있습니다.

perspectives[]

object

perspective는 클러스터 관리자가 화면 전환기 드롭다운에 표시/해제하려는 관점을 정의합니다.

projectAccess

object

ProjectAccess를 사용하면 개발자 화면 프로젝트 액세스 페이지에서 사용 가능한 ClusterRole 목록을 사용자 지정할 수 있으며 프로젝트 관리자가 다른 사용자에게 역할을 지정하고 프로젝트 내 액세스를 제한할 수 있습니다. 설정된 경우 목록은 기본 ClusterRole 옵션을 대체합니다.

퀵스타트

object

빠른 시작을 사용하면 콘솔에서 사용 가능한 ConsoleQuickStart 리소스를 사용자 지정할 수 있습니다.

disabledActions

배열(문자열)

DisabledActions는 사용자에게 표시되지 않는 작업 목록입니다. 목록의 각 작업은 해당 ID로 표시됩니다.

name

string

이름은 기능의 고유 이름입니다. 사용 가능한 기능은 LightspeedButton입니다.

가시성

object

가시성은 기능의 가시성 상태를 정의합니다.

상태

string

State는 콘솔 UI에서 기능이 활성화 또는 비활성화되었는지 여부를 정의합니다. 콘솔 UI에서 기능을 활성화하는 것은 "Enabled" 값으로 표시됩니다. 콘솔 UI에서 기능을 비활성화하는 것은 "Disabled" 값으로 표시됩니다.

key

string

key를 사용하면 configmap 내의 특정 키/값을 가리킬 수 있습니다. 이는 논리 파일 참조에 유용합니다.

name

string

카테고리

array

개발자 카탈로그에 표시되는 카테고리입니다.

categories[]

object

개발자 콘솔 카탈로그의 DeveloperConsoleCatalogCategory.

유형

object

유형을 사용하면 개발자 카탈로그에서 사용자가 볼 수 있는 하위 컬렉션 유형을 활성화하거나 비활성화할 수 있습니다. 생략하면 모든 하위 카탈로그 유형이 표시됩니다.

id

string

ID는 콘솔에서 깊은 연결을 활성화하기 위해 URL에 사용되는 식별자입니다. ID는 필수이며 1~3~2개의 URL 안전(A-Z, a-z, 0-9, - 및 _) 문자가 있어야 합니다.

label

string

레이블은 카테고리 표시 레이블을 정의합니다. 필수이며 1~64자여야 합니다.

하위 범주

array

하위 범주는 하위 카테고리 목록을 정의합니다.

subcategories[]

object

DeveloperConsoleCatalogCategoryMeta는 개발자 카탈로그 카테고리의 주요 식별자입니다.

tags

배열(문자열)

태그는 카테고리와 일치하는 문자열 목록입니다. 선택한 카테고리는 범주와 항목 간에 겹치는 태그가 하나 이상 있는 모든 항목을 표시합니다.

id

string

ID는 콘솔에서 깊은 연결을 활성화하기 위해 URL에 사용되는 식별자입니다. ID는 필수이며 1~3~2개의 URL 안전(A-Z, a-z, 0-9, - 및 _) 문자가 있어야 합니다.

label

string

레이블은 카테고리 표시 레이블을 정의합니다. 필수이며 1~64자여야 합니다.

tags

배열(문자열)

태그는 카테고리와 일치하는 문자열 목록입니다. 선택한 카테고리는 범주와 항목 간에 겹치는 태그가 하나 이상 있는 모든 항목을 표시합니다.

비활성화됨

배열(문자열)

disabled는 사용자에게 표시되지 않는 개발자 카탈로그 유형(하위 카탈로그 ID) 목록입니다. 유형(sub-catalog)은 콘솔 플러그인을 통해 추가되며, 사용 가능한 유형(하위 카탈로그 ID)은 클러스터 구성 페이지의 콘솔에서 또는 콘솔에서 YAML을 편집할 때 사용할 수 있습니다. 예: "Devfile", "HelmChart", "BuilderImage" 목록이 비어 있거나 사용 가능한 모든 하위 카탈로그가 추가되면 전체 개발자 카탈로그를 숨겨야 합니다.

enabled

배열(문자열)

enabled는 사용자에게 표시되는 개발자 카탈로그 유형(하위 카탈로그 ID) 목록입니다. 유형(sub-catalog)은 콘솔 플러그인을 통해 추가되며, 사용 가능한 유형(하위 카탈로그 ID)은 클러스터 구성 페이지의 콘솔에서 또는 콘솔에서 YAML을 편집할 때 사용할 수 있습니다. 예: "Devfile", "HelmChart", "BuilderImage" 목록이 비어 있지 않으면 목록에 추가할 때까지 새 유형이 사용자에게 표시되지 않습니다. 목록이 비어 있으면 전체 개발자 카탈로그가 표시됩니다.

상태

string

State는 카탈로그 유형 목록을 활성화하거나 비활성화해야 하는지를 정의합니다.

id

string

ID는 관점의 ID를 정의합니다. 예: "dev", "admin". 사용 가능한 관점 ID는 yaml 편집기 옆에 있는 코드 스니펫 섹션에서 확인할 수 있습니다. 올바르지 않거나 알 수 없는 ID는 무시됩니다.

pinnedResources

array

pinnedResources는 이러한 고정된 리소스를 직접 사용자 지정하지 않은 경우 사용자가 화면 탐색에 표시되는 기본 고정 리소스 목록을 정의합니다. 사용 가능한 Kubernetes 리소스 목록은 kubectl api-resources 를 통해 읽을 수 있습니다. 콘솔은 또한 구성 UI와 탐색에 고정할 수 있는 사용 가능한 리소스를 나열하는 YAML 스니펫을 제공합니다. 잘못되었거나 알 수 없는 리소스는 무시됩니다.

pinnedResources[]

object

PinnedResourceReference에는 리소스 그룹, 버전 및 유형이 포함됩니다.

가시성

object

가시성은 해당 관점에 필요한 경우 액세스 검토 검사와 함께 관점 상태를 정의합니다.

group

string

Group은 리소스의 API 그룹입니다. core 그룹에 빈 문자열을 입력합니다. 이 값은 소문자 영숫자, 하이픈 및 마침표로만 구성되어야 합니다. 예: "", "apps", "build.openshift.io" 등

resource

string

resource는 참조되는 유형입니다. 일반적으로 소문자로 리소스 유형의 복수형 형식입니다. 이 값은 소문자 영숫자 및 하이픈으로만 구성되어야 합니다. 예: "deployments", "deploymentconfigs", "pods" 등.

version

string

Version은 리소스의 API 버전입니다. 이 값은 소문자 영숫자만 구성되어야 합니다. 예: "v1", "v1beta1" 등

accessReview

object

accessReview는 필수 및 누락된 액세스 검토 검사를 정의합니다.

상태

string

State는 관점을 활성화 또는 비활성화하거나 액세스 검토 검사가 필요합니다.

누락됨

array

missing은 권한 검사 목록을 정의합니다. 하나 이상의 검사가 실패하는 경우에만 관점이 표시됩니다. 생략하면 액세스 검토가 건너뛰고 필요한 액세스 검토 목록 구성에 따라 필요한 경우가 아니면 관점이 표시되지 않습니다.

missing[]

object

ResourceAttributes에는 Authorizer 인터페이스에 리소스 요청에 사용할 수 있는 권한 부여 속성이 포함되어 있습니다.

필수 항목

array

필수는 권한 검사 목록을 정의합니다. 관점은 모든 검사가 성공할 때만 표시됩니다. 생략하면 액세스 검토가 건너뛰고 누락된 액세스 검토 목록의 구성에 따라 필요한 경우가 아니면 관점이 표시되지 않습니다.

required[]

object

ResourceAttributes에는 Authorizer 인터페이스에 리소스 요청에 사용할 수 있는 권한 부여 속성이 포함되어 있습니다.

group

string

group은 리소스의 API 그룹입니다. "*"는 모든 것을 의미합니다.

name

string

name은 "get"에 대해 요청되거나 "삭제"에 대해 요청된 리소스의 이름입니다. ""(비어 있음)는 모두 의미합니다.

네임스페이스

string

namespace는 요청된 작업의 네임스페이스입니다. 현재는 LocalSubjectAccessReviews ""(비어 있음)에 대해 네임스페이스와 모든 네임스페이스 ""(빈)가 기본적으로 비어 있는 경우 클러스터 범위 리소스 ""(빈)는 SubjectAccessReview 또는 SelfSubjectAccessReview의 네임스페이스 범위 리소스에 대해 "all"을 의미합니다.

resource

string

리소스는 기존 리소스 유형 중 하나입니다. "*"는 모든 것을 의미합니다.

하위 리소스

string

하위 리소스는 기존 리소스 유형 중 하나입니다. ""는 none을 의미합니다.

verb

string

동사는 get, list, watch, create, update, delete, proxy와 같은 kubernetes 리소스 API 동사입니다. "*"는 모든 것을 의미합니다.

version

string

버전은 리소스의 API 버전입니다. "*"는 모든 것을 의미합니다.

group

string

group은 리소스의 API 그룹입니다. "*"는 모든 것을 의미합니다.

name

string

name은 "get"에 대해 요청되거나 "삭제"에 대해 요청된 리소스의 이름입니다. ""(비어 있음)는 모두 의미합니다.

네임스페이스

string

namespace는 요청된 작업의 네임스페이스입니다. 현재는 LocalSubjectAccessReviews ""(비어 있음)에 대해 네임스페이스와 모든 네임스페이스 ""(빈)가 기본적으로 비어 있는 경우 클러스터 범위 리소스 ""(빈)는 SubjectAccessReview 또는 SelfSubjectAccessReview의 네임스페이스 범위 리소스에 대해 "all"을 의미합니다.

resource

string

리소스는 기존 리소스 유형 중 하나입니다. "*"는 모든 것을 의미합니다.

하위 리소스

string

하위 리소스는 기존 리소스 유형 중 하나입니다. ""는 none을 의미합니다.

verb

string

동사는 get, list, watch, create, update, delete, proxy와 같은 kubernetes 리소스 API 동사입니다. "*"는 모든 것을 의미합니다.

version

string

버전은 리소스의 API 버전입니다. "*"는 모든 것을 의미합니다.

availableClusterRoles

배열(문자열)

availableClusterRoles는 프로젝트 액세스 탭을 통해 사용자에게 할당할 수 있는 ClusterRole 이름 목록입니다.

비활성화됨

배열(문자열)

disabled는 사용자에게 표시되지 않는 ConsoleQuickStart 리소스 이름 목록입니다.

clientDownloadsURL

string

clientDownloadsURL은 클라이언트 바이너리를 다운로드하는 주소로 사용되는 URL입니다. 지정하지 않으면 다운로드 경로 호스트 이름이 사용됩니다. 이 필드는 Ingress 기능이 없는 클러스터에 필요합니다. 경로 액세스가 불가능합니다. 콘솔 Operator는 URL을 모니터링하고 연장된 기간 동안 연결할 수 없는 경우 성능이 저하될 수 있습니다. HTTPS 스키마를 사용해야 합니다.

consoleURL

string

consoleURL은 기본 콘솔 주소로 사용할 URL입니다. 지정하지 않으면 콘솔 경로 호스트 이름이 사용됩니다. 이 필드는 Ingress 기능이 없는 클러스터에 필요합니다. 경로 액세스가 불가능합니다. 이 URL에 적절한 수신이 설정되어 있는지 확인합니다. 콘솔 Operator는 URL을 모니터링하고 연장된 기간 동안 연결할 수 없는 경우 성능이 저하될 수 있습니다. HTTPS 스키마를 사용해야 합니다.

statuspage

object

Statuspage에는 status info about을 제공하는 statuspage.io 페이지의 ID가 포함되어 있습니다.

pageID

string

pageid는 페이지에 대한 Statuspage에서 할당한 고유한 ID입니다. 이는 공개 페이지여야 합니다.

hostname

string

hostname은 콘솔을 사용할 수 있는 원하는 사용자 정의 도메인입니다.

Secret

object

시크릿은 사용자 정의 인증서 및 키가 포함된 openshift-config 네임스페이스의 시크릿을 가리키며 클러스터 관리자가 수동으로 생성해야 합니다. 참조된 시크릿은 다음 키 값 쌍을 포함해야 합니다. - "tls.crt" - 사용자 정의 인증서 - "tls.key" - 사용자 정의 인증서의 개인 키를 지정하는 데 사용자 정의 인증서의 개인 키를 지정하는 경우 사용자 정의 호스트 이름이 클러스터의 기본 라우팅 접미사를 사용하는 경우 제공 인증서에 대한 시크릿 사양이 필요하지 않습니다.

name

string

name은 참조된 보안의 metadata.name입니다.

conditions

array

conditions는 조건 및 상태 목록입니다.

conditions[]

object

OperatorCondition은 표준 조건 필드입니다.

생성

array

세대는 항목이 조정되어야 하거나 반응이 필요한 방식으로 변경된 시기를 결정하는 데 사용됩니다.

generations[]

object

GenerationStatus는 지정된 리소스의 생성을 추적하여 강제 업데이트에 대한 결정을 내릴 수 있습니다.

observedGeneration

integer

observedGeneration은 귀하가 다루는 마지막 세대의 변경 사항입니다.

readyReplicas

integer

readyReplicas는 준비된 복제본 수와 원하는 상태를 나타냅니다.

version

string

버전이 이 가용성이 적용되는 수준입니다.

lastTransitionTime

string

message

string

reason

string

status

string

type

string

group

string

그룹은 추적 중인 항목의 그룹입니다.

hash

string

hash는 시크릿 및 configmaps와 같이 민감한 콘텐츠인 생성이 없는 리소스에 대해 설정된 선택적 필드입니다.

lastGeneration

integer

lastGeneration은 관련된 워크로드 컨트롤러의 마지막 생성입니다.

name

string

추적 중인 항목의 이름입니다.Is the name of the item you are tracking

네임스페이스

string

namespace is where you're tracking is where you're tracking is where you're tracking is where you're tracking

resource

string

리소스는 추적 중인 항목의 리소스 유형입니다.