2장. APIService [apiregistration.k8s.io/v1]
- 설명
- APIService는 특정 GroupVersion에 대한 서버를 나타냅니다. name은 "version.group"이어야 합니다.
- 유형
-
object
2.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 | |
|
| APIServiceSpec에는 서버 위치 및 통신에 대한 정보가 포함되어 있습니다. 인증서 확인을 비활성화할 수 있지만 https만 지원됩니다. |
|
| APIServiceStatus에는 API 서버에 대한 파생 정보가 포함되어 있습니다. |
2.1.1. .spec
- 설명
- APIServiceSpec에는 서버 위치 및 통신에 대한 정보가 포함되어 있습니다. 인증서 확인을 비활성화할 수 있지만 https만 지원됩니다.
- 유형
-
object
- 필수 항목
-
groupPriorityMinimum
-
versionPriority
-
속성 | 유형 | 설명 |
---|---|---|
|
| cabundle은 API 서버의 제공 인증서의 유효성을 검사하는 데 사용할 PEM 인코딩 CA 번들입니다. 지정되지 않은 경우 apiserver의 시스템 신뢰 루트가 사용됩니다. |
|
| group은 이 서버 호스트 이름인 API 그룹 이름입니다. |
|
| GroupPriorityMinimum은 이 그룹에 최소한 있어야 하는 우선 순위입니다. 우선 순위가 높은 경우 클라이언트가 우선 순위가 낮은 그룹을 우선 순위로 설정합니다. 이 그룹의 다른 버전에서는 전체 그룹이 우선 순위를 갖도록 더 높은 GroupPriorityMinimum 값을 지정할 수 있습니다. 기본 정렬은 GroupPriorityMinimum을 기반으로 하며 가장 높은 수를 가장 낮은 수로 10보다 낮게 정렬합니다. 보조 정렬은 오브젝트 이름의 알파벳순 비교를 기반으로 합니다. (v1.bar 이전 v1.foo) We'd recommend something like: *.k8s.io (확장 제외) 18000 및 PaaS (OpenShift, Deis)는 2000s에 있는 것이 좋습니다. |
|
| InsecureSkipTLSVerify는 이 서버와 통신할 때 TLS 인증서 확인을 비활성화합니다. 이는 매우 권장되지 않습니다. 대신 CABundle을 사용해야 합니다. |
|
| ServiceReference에는 Service.legacy.k8s.io에 대한 참조가 있습니다. |
|
| version은 이 서버 호스트인 API 버전입니다. 예: "v1" |
|
| VersionPriority는 그룹 내에서 이 API 버전의 순서를 제어합니다. 0보다 커야 합니다. 기본 정렬은 VersionPriority를 기반으로 하며, 가장 높은 우선 순위(10개 이전)를 기준으로 합니다. 그룹 내에 있기 때문에 숫자는 10s에서 작을 수 있습니다. 버전 우선순위가 동일한 경우 버전 문자열이 그룹 내부의 순서를 계산하는 데 사용됩니다. 버전 문자열이 "kube-like"인 경우 사전순으로 정렬된 "kube-like" 버전 문자열을 정렬합니다. "kube-like" 버전은 "v"로 시작한 다음 숫자 뒤에 숫자(주요 버전), 선택 옵션으로 "alpha" 또는 "beta" 문자열과 다른 숫자(마이너 버전)가 옵니다. 이들은 먼저 GA > 베타 버전 > 알파 (GA는 베타 또는 알파와 같은 접미사가 없는 버전임), 주요 버전을 비교한 다음 마이너 버전으로 정렬됩니다. 예를 들면 v10, v2, v1, v11beta2, v10beta3, v3beta1, v12alpha1, v11alpha2, foo1, foo1, foo10입니다. |
2.1.2. .spec.service
- 설명
- ServiceReference에는 Service.legacy.k8s.io에 대한 참조가 있습니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| name은 서비스 이름입니다. |
|
| 네임스페이스는 서비스의 네임스페이스입니다. |
|
|
지정된 경우 Webhook를 호스팅하는 서비스의 포트입니다. 이전 버전과의 호환성을 위해 기본값은 443입니다. |
2.1.3. .status
- 설명
- APIServiceStatus에는 API 서버에 대한 파생 정보가 포함되어 있습니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| apiService의 현재 서비스 상태. |
|
| APIServiceCondition은 특정 시점에서 APIService의 상태를 설명합니다. |
2.1.4. .status.conditions
- 설명
- apiService의 현재 서비스 상태.
- 유형
-
array
2.1.5. .status.conditions[]
- 설명
- APIServiceCondition은 특정 시점에서 APIService의 상태를 설명합니다.
- 유형
-
object
- 필수 항목
-
type
-
status
-
속성 | 유형 | 설명 |
---|---|---|
| 조건이 한 상태에서 다른 상태로 전환된 마지막 시간입니다. | |
|
| 마지막 전환에 대한 세부 정보를 나타내는 사람이 읽을 수 있는 메시지입니다. |
|
| 조건의 마지막 전환에 대한 고유하고 한단어, CamelCase 이유. |
|
| Status는 조건의 상태입니다. True, False, 알 수 없음 |
|
| type은 조건의 유형입니다. |