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


설명

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

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

유형
object
필수 항목
  • spec

5.1. 사양

속성유형설명

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_v2

메타데이터는 표준 오브젝트의 메타데이터입니다. 자세한 내용은 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
필수 항목
  • 템플릿
속성유형설명

요청자

object

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

Secret

LocalObjectReference_v2

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

템플릿

object

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

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

5.1.2. .spec.requester

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

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
필수 항목
  • 오브젝트
속성유형설명

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_v2

메타데이터는 표준 오브젝트의 메타데이터입니다. 자세한 내용은 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
속성유형설명

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
속성유형설명

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
속성유형설명

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
속성유형설명

ref

ObjectReference

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

Red Hat logoGithubRedditYoutubeTwitter

자세한 정보

평가판, 구매 및 판매

커뮤니티

Red Hat 문서 정보

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

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

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

Red Hat 소개

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

© 2024 Red Hat, Inc.