5장. TemplateInstance [template.openshift.io/v1]
- 설명
TemplateInstance는 템플릿의 인스턴스화를 요청하고 기록합니다. TemplateInstance는 실험적 API의 일부입니다.
호환성 수준 1: 최소 12 개월 또는 3 개의 마이너 릴리스 (더 긴 버전) 동안 주요 릴리스 내에서 사용할 수 있습니다.
- 유형
-
object
- 필수 항목
-
spec
-
5.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 | |
|
| TemplateInstanceSpec은 TemplateInstance의 원하는 상태를 설명합니다. |
|
| TemplateInstanceStatus는 TemplateInstance의 현재 상태를 설명합니다. |
5.1.1. .spec
- 설명
- TemplateInstanceSpec은 TemplateInstance의 원하는 상태를 설명합니다.
- 유형
-
object
- 필수 항목
-
템플릿
-
속성 | 유형 | 설명 |
---|---|---|
|
| TemplateInstanceRequester에는 템플릿 인스턴스화를 요청하는 에이전트의 ID가 있습니다. |
| Secret은 필요한 템플릿 매개변수가 포함된 Secret 오브젝트에 대한 참조입니다. | |
|
| 템플릿에는 구성을 생성하는 데 필요한 입력이 포함되어 있습니다. 호환성 수준 1: 최소 12 개월 또는 3 개의 마이너 릴리스 (더 긴 버전) 동안 주요 릴리스 내에서 사용할 수 있습니다. |
5.1.2. .spec.requester
- 설명
- TemplateInstanceRequester에는 템플릿 인스턴스화를 요청하는 에이전트의 ID가 있습니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| 추가 정보는 Authenticator가 제공하는 추가 정보를 보유하고 있습니다. |
|
| |
|
| 그룹은 이 사용자가 속한 그룹을 나타냅니다. |
|
| UID는 시간에 따라 이 사용자를 식별하는 고유한 값입니다. 이 사용자가 삭제되고 동일한 이름의 다른 사용자가 추가되면 UID가 다릅니다. |
|
| 사용자 이름은 모든 활성 사용자 중에서 이 사용자를 고유하게 식별합니다. |
5.1.3. .spec.requester.extra
- 설명
- 추가 정보는 Authenticator가 제공하는 추가 정보를 보유하고 있습니다.
- 유형
-
object
5.1.4. .spec.template
- 설명
템플릿에는 구성을 생성하는 데 필요한 입력이 포함되어 있습니다.
호환성 수준 1: 최소 12 개월 또는 3 개의 마이너 릴리스 (더 긴 버전) 동안 주요 릴리스 내에서 사용할 수 있습니다.
- 유형
-
object
- 필수 항목
-
오브젝트
-
속성 | 유형 | 설명 |
---|---|---|
|
| 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 |
|
| 레이블은 Template to Config 변환 중에 모든 오브젝트에 적용되는 선택적 레이블 집합입니다. |
|
| message는 이 템플릿이 인스턴스화될 때 표시되는 선택적 지침 메시지입니다. 이 필드는 새로 생성된 리소스를 활용하는 방법을 사용자에게 알려주어야 합니다. 생성된 인증 정보 및 기타 매개변수를 출력에 포함할 수 있도록 표시 전에 메시지에서 매개변수 대체가 수행됩니다. |
| 메타데이터는 표준 오브젝트의 메타데이터입니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata | |
| 오브젝트는 이 템플릿에 포함할 리소스 배열입니다. 오브젝트에서 네임스페이스 값이 하드 코딩된 경우 템플릿 인스턴스화 중에 제거되지만 네임스페이스 값이 ${PARAMETER_REFERENCE}인 경우 매개변수 대체 후 해결된 값이 충족되고 해당 네임스페이스에서 오브젝트가 생성됩니다. | |
|
| 매개변수는 Template to Config 변환 중에 사용되는 매개변수의 선택적 배열입니다. |
|
| 매개 변수는 Template to Config 변환 중에 처리할 이름/값 변수를 정의합니다. |
5.1.5. .spec.template.parameters
- 설명
- 매개변수는 Template to Config 변환 중에 사용되는 매개변수의 선택적 배열입니다.
- 유형
-
array
5.1.6. .spec.template.parameters[]
- 설명
- 매개 변수는 Template to Config 변환 중에 처리할 이름/값 변수를 정의합니다.
- 유형
-
object
- 필수 항목
-
name
-
속성 | 유형 | 설명 |
---|---|---|
|
| 매개 변수에 대한 설명입니다. 선택 사항입니다. |
|
| 선택 사항: 매개변수 'Name' 대신 UI에 표시되는 이름입니다. |
|
| 에서 은 생성기의 입력 값입니다. 선택 사항입니다. |
|
| generate는 From 필드에 지정된 입력 값에서 임의의 문자열을 생성하는 데 사용할 생성기를 지정합니다. 결과 문자열은 Value 필드에 저장됩니다. 비어있는 경우 생성기를 사용하지 않고 결과 값을 그대로 둡니다. 선택 사항입니다. 지원되는 유일한 생성기는 "from"이며 범위 표현식 "[a-zA-Z0-9]" 및 길이 표현식 "a{length}"을 포함하는 간단한 정규식의 형태로 "from" 값을 허용합니다. 예: | 값 ------------------------- "test[0-9]{1}x" | "test7x" "[0-1]{8}" | "01001100" "0x[A-F0-9]{4}" | "0xB3AF" "[a-zA-Z0-9]{8}" | "hW4yQU5i" |
|
| name을 설정해야 하며 ${PARAMETER_NAME}을 사용하여 템플릿 항목에서 참조할 수 있습니다. 필수 항목입니다. |
|
| 선택 사항: 매개변수에 값이 있어야 함을 나타냅니다. 기본값은 false입니다. |
|
| value에는 매개 변수 데이터가 포함됩니다. 지정하면 생성기가 무시됩니다. 이 값은 Template to Config 변환 중에 Parameter ${Name} 표현식의 모든 항목을 대체합니다. 선택 사항입니다. |
5.1.7. .status
- 설명
- TemplateInstanceStatus는 TemplateInstance의 현재 상태를 설명합니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| 조건은 TemplateInstance의 현재 상태에 대한 사용 가능한 최신 관찰을 나타냅니다. |
|
| TemplateInstanceCondition에는 TemplateInstance에 대한 조건 정보가 포함되어 있습니다. |
|
| 오브젝트는 TemplateInstance에서 생성한 오브젝트를 참조합니다. |
|
| TemplateInstanceObject는 TemplateInstance에서 생성한 오브젝트를 참조합니다. |
5.1.8. .status.conditions
- 설명
- 조건은 TemplateInstance의 현재 상태에 대한 사용 가능한 최신 관찰을 나타냅니다.
- 유형
-
array
5.1.9. .status.conditions[]
- 설명
- TemplateInstanceCondition에는 TemplateInstance에 대한 조건 정보가 포함되어 있습니다.
- 유형
-
object
- 필수 항목
-
type
-
status
-
lastTransitionTime
-
reason
-
message
-
속성 | 유형 | 설명 |
---|---|---|
| LastTransitionTime은 상태가 한 상태에서 다른 상태로 전환된 마지막 시간입니다. | |
|
| message는 마지막 전환에 대한 세부 정보에 대해 사람이 읽을 수 있는 설명으로, 이유를 보완합니다. |
|
| 이유는 조건의 마지막 전환에 대한 간단한 머신에서 읽을 수 있는 설명입니다. |
|
| 조건의 상태, True, False 또는 Unknown 중 하나입니다. |
|
| 조건 유형(현재 Ready 또는 InstantiateFailure). |
5.1.10. .status.objects
- 설명
- 오브젝트는 TemplateInstance에서 생성한 오브젝트를 참조합니다.
- 유형
-
array
5.1.11. .status.objects[]
- 설명
- TemplateInstanceObject는 TemplateInstance에서 생성한 오브젝트를 참조합니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
| ref는 생성된 개체에 대한 참조입니다. .spec에서 사용하는 경우 name 및 namespace만 사용됩니다. 일반 규칙에 따라 대체될 매개변수에 대한 참조가 포함될 수 있습니다. |