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만 사용됩니다. 일반 규칙에 따라 대체될 매개변수에 대한 참조가 포함될 수 있습니다. |