5장. TemplateInstance [template.openshift.io/v1]


설명

TemplateInstance는 템플릿의 인스턴스화를 요청하고 기록합니다. TemplateInstance는 실험적 API의 일부입니다.

호환성 수준 1: 최소 12 개월 또는 3 개의 마이너 릴리스 (더 긴 버전) 동안 주요 릴리스 내에서 사용할 수 있습니다.

유형
object
필수 항목
  • spec

5.1. 사양

Expand
속성유형설명

apiVersion

string

APIVersion은 버전이 지정된 이 오브젝트 표현의 스키마를 정의합니다. 서버는 인식된 스키마를 최신 내부 값으로 변환해야 하며, 인식되지 않는 값을 거부할 수 있습니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources

kind

string

kind는 이 오브젝트가 나타내는 REST 리소스에 해당하는 문자열 값입니다. 서버는 클라이언트에서 요청을 제출한 끝점에서 이를 유추할 수 있습니다. CamelCase로 업데이트할 수 없습니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds

메타데이터

ObjectMeta

메타데이터는 표준 오브젝트의 메타데이터입니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata

spec

object

TemplateInstanceSpec은 TemplateInstance의 원하는 상태를 설명합니다.

status

object

TemplateInstanceStatus는 TemplateInstance의 현재 상태를 설명합니다.

5.1.1. .spec

설명
TemplateInstanceSpec은 TemplateInstance의 원하는 상태를 설명합니다.
유형
object
필수 항목
  • 템플릿
Expand
속성유형설명

요청자

object

TemplateInstanceRequester에는 템플릿 인스턴스화를 요청하는 에이전트의 ID가 있습니다.

Secret

LocalObjectReference

Secret은 필요한 템플릿 매개변수가 포함된 Secret 오브젝트에 대한 참조입니다.

템플릿

object

템플릿에는 구성을 생성하는 데 필요한 입력이 포함되어 있습니다.

호환성 수준 1: 최소 12 개월 또는 3 개의 마이너 릴리스 (더 긴 버전) 동안 주요 릴리스 내에서 사용할 수 있습니다.

5.1.2. .spec.requester

설명
TemplateInstanceRequester에는 템플릿 인스턴스화를 요청하는 에이전트의 ID가 있습니다.
유형
object
Expand
속성유형설명

extra

object

추가 정보는 Authenticator가 제공하는 추가 정보를 보유하고 있습니다.

extra{}

배열(문자열)

 

groups

배열(문자열)

그룹은 이 사용자가 속한 그룹을 나타냅니다.

uid

string

UID는 시간에 따라 이 사용자를 식별하는 고유한 값입니다. 이 사용자가 삭제되고 동일한 이름의 다른 사용자가 추가되면 UID가 다릅니다.

사용자 이름

string

사용자 이름은 모든 활성 사용자 중에서 이 사용자를 고유하게 식별합니다.

5.1.3. .spec.requester.extra

설명
추가 정보는 Authenticator가 제공하는 추가 정보를 보유하고 있습니다.
유형
object

5.1.4. .spec.template

설명

템플릿에는 구성을 생성하는 데 필요한 입력이 포함되어 있습니다.

호환성 수준 1: 최소 12 개월 또는 3 개의 마이너 릴리스 (더 긴 버전) 동안 주요 릴리스 내에서 사용할 수 있습니다.

유형
object
필수 항목
  • 오브젝트
Expand
속성유형설명

apiVersion

string

APIVersion은 버전이 지정된 이 오브젝트 표현의 스키마를 정의합니다. 서버는 인식된 스키마를 최신 내부 값으로 변환해야 하며, 인식되지 않는 값을 거부할 수 있습니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources

kind

string

kind는 이 오브젝트가 나타내는 REST 리소스에 해당하는 문자열 값입니다. 서버는 클라이언트에서 요청을 제출한 끝점에서 이를 유추할 수 있습니다. CamelCase로 업데이트할 수 없습니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds

labels

오브젝트(문자열)

레이블은 Template to Config 변환 중에 모든 오브젝트에 적용되는 선택적 레이블 집합입니다.

message

string

message는 이 템플릿이 인스턴스화될 때 표시되는 선택적 지침 메시지입니다. 이 필드는 새로 생성된 리소스를 활용하는 방법을 사용자에게 알려주어야 합니다. 생성된 인증 정보 및 기타 매개변수를 출력에 포함할 수 있도록 표시 전에 메시지에서 매개변수 대체가 수행됩니다.

메타데이터

ObjectMeta

메타데이터는 표준 오브젝트의 메타데이터입니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata

오브젝트

array (RawExtension)

오브젝트는 이 템플릿에 포함할 리소스 배열입니다. 오브젝트에서 네임스페이스 값이 하드 코딩된 경우 템플릿 인스턴스화 중에 제거되지만 네임스페이스 값이 ${PARAMETER_REFERENCE}인 경우 매개변수 대체 후 해결된 값이 충족되고 해당 네임스페이스에서 오브젝트가 생성됩니다.

parameters

array

매개변수는 Template to Config 변환 중에 사용되는 매개변수의 선택적 배열입니다.

parameters[]

object

매개 변수는 Template to Config 변환 중에 처리할 이름/값 변수를 정의합니다.

5.1.5. .spec.template.parameters

설명
매개변수는 Template to Config 변환 중에 사용되는 매개변수의 선택적 배열입니다.
유형
array

5.1.6. .spec.template.parameters[]

설명
매개 변수는 Template to Config 변환 중에 처리할 이름/값 변수를 정의합니다.
유형
object
필수 항목
  • name
Expand
속성유형설명

description

string

매개 변수에 대한 설명입니다. 선택 사항입니다.

displayName

string

선택 사항: 매개변수 'Name' 대신 UI에 표시되는 이름입니다.

from

string

에서 은 생성기의 입력 값입니다. 선택 사항입니다.

generate

string

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

string

name을 설정해야 하며 ${PARAMETER_NAME}을 사용하여 템플릿 항목에서 참조할 수 있습니다. 필수 항목입니다.

필수 항목

boolean

선택 사항: 매개변수에 값이 있어야 함을 나타냅니다. 기본값은 false입니다.

value

string

value에는 매개 변수 데이터가 포함됩니다. 지정하면 생성기가 무시됩니다. 이 값은 Template to Config 변환 중에 Parameter ${Name} 표현식의 모든 항목을 대체합니다. 선택 사항입니다.

5.1.7. .status

설명
TemplateInstanceStatus는 TemplateInstance의 현재 상태를 설명합니다.
유형
object
Expand
속성유형설명

conditions

array

조건은 TemplateInstance의 현재 상태에 대한 사용 가능한 최신 관찰을 나타냅니다.

conditions[]

object

TemplateInstanceCondition에는 TemplateInstance에 대한 조건 정보가 포함되어 있습니다.

오브젝트

array

오브젝트는 TemplateInstance에서 생성한 오브젝트를 참조합니다.

objects[]

object

TemplateInstanceObject는 TemplateInstance에서 생성한 오브젝트를 참조합니다.

5.1.8. .status.conditions

설명
조건은 TemplateInstance의 현재 상태에 대한 사용 가능한 최신 관찰을 나타냅니다.
유형
array

5.1.9. .status.conditions[]

설명
TemplateInstanceCondition에는 TemplateInstance에 대한 조건 정보가 포함되어 있습니다.
유형
object
필수 항목
  • type
  • status
  • lastTransitionTime
  • reason
  • message
Expand
속성유형설명

lastTransitionTime

시간

LastTransitionTime은 상태가 한 상태에서 다른 상태로 전환된 마지막 시간입니다.

message

string

message는 마지막 전환에 대한 세부 정보에 대해 사람이 읽을 수 있는 설명으로, 이유를 보완합니다.

reason

string

이유는 조건의 마지막 전환에 대한 간단한 머신에서 읽을 수 있는 설명입니다.

status

string

조건의 상태, True, False 또는 Unknown 중 하나입니다.

type

string

조건 유형(현재 Ready 또는 InstantiateFailure).

5.1.10. .status.objects

설명
오브젝트는 TemplateInstance에서 생성한 오브젝트를 참조합니다.
유형
array

5.1.11. .status.objects[]

설명
TemplateInstanceObject는 TemplateInstance에서 생성한 오브젝트를 참조합니다.
유형
object
Expand
속성유형설명

ref

ObjectReference

ref는 생성된 개체에 대한 참조입니다. .spec에서 사용하는 경우 name 및 namespace만 사용됩니다. 일반 규칙에 따라 대체될 매개변수에 대한 참조가 포함될 수 있습니다.

맨 위로 이동
Red Hat logoGithubredditYoutubeTwitter

자세한 정보

평가판, 구매 및 판매

커뮤니티

Red Hat 문서 정보

Red Hat을 사용하는 고객은 신뢰할 수 있는 콘텐츠가 포함된 제품과 서비스를 통해 혁신하고 목표를 달성할 수 있습니다. 최신 업데이트를 확인하세요.

보다 포괄적 수용을 위한 오픈 소스 용어 교체

Red Hat은 코드, 문서, 웹 속성에서 문제가 있는 언어를 교체하기 위해 최선을 다하고 있습니다. 자세한 내용은 다음을 참조하세요.Red Hat 블로그.

Red Hat 소개

Red Hat은 기업이 핵심 데이터 센터에서 네트워크 에지에 이르기까지 플랫폼과 환경 전반에서 더 쉽게 작업할 수 있도록 강화된 솔루션을 제공합니다.

Theme

© 2025 Red Hat