16장. GatewayClass [gateway.networking.k8s.io/v1]

controllerName

string

ControllerName은 이 클래스의 게이트웨이를 관리하는 컨트롤러의 이름입니다. 이 필드의 값은 도메인 접두사 경로여야 합니다.

Example: "example.net/gateway-controller".

이 필드는 변경할 수 없으며 비워 둘 수 없습니다.

지원: Core

description

string

설명은 GatewayClass에 대한 자세한 내용을 설명하는 데 도움이 됩니다.

parametersRef

object

ParametersRef는 GatewayClass에 해당하는 구성 매개변수를 포함하는 리소스에 대한 참조입니다. 컨트롤러에 추가 구성이 필요하지 않은 경우 선택 사항입니다.

ParametersRef는 표준 Kubernetes 리소스(예: ConfigMap 또는 구현별 사용자 정의 리소스)를 참조할 수 있습니다. 리소스는 클러스터 범위 또는 네임스페이스 범위일 수 있습니다.

참조자를 찾을 수 없거나 지원되지 않는 종류를 참조하거나 해당 리소스 내의 데이터가 잘못된 형식인 경우 GatewayClass SHOULD는 "False"로 설정된 "Accepted" 상태 조건 및 "InvalidParameters" 이유와 함께 거부됩니다.

이 GatewayClass의 게이트웨이는 자체 매개변수Ref 를 제공할 수 있습니다. 둘 다 지정되면 병합 동작이 구현됩니다. 일반적으로 GatewayClass는 Gateway에서 재정의할 수 있는 기본값을 제공하는 것이 좋습니다.

지원: 구현별

group

string

그룹은 참조 그룹의 그룹입니다.

kind

string

이는 일종의 참조입니다.

name

string

이름은 참조의 이름입니다.

네임스페이스

string

네임스페이스는 참조의 네임스페이스입니다. 이 필드는 네임스페이스 범위 리소스를 참조할 때 필요하며 클러스터 범위 리소스를 참조할 때 설정되지 않아야 합니다.

conditions

array

conditions는 이 GatewayClass에 대한 컨트롤러의 현재 상태입니다.

컨트롤러는 각 조건의 유형에 대해 GatewayClassConditionType 값을 사용하여 조건을 게시하는 것을 선호해야 합니다.

conditions[]

object

condition에는 이 API 리소스의 현재 상태에 대한 한 가지 측면에 대한 세부 정보가 포함되어 있습니다.

lastTransitionTime

string

lastTransitionTime은 조건이 한 상태에서 다른 상태로 전환된 마지막 시간입니다. 이는 기본 조건이 변경된 시점이어야 합니다. 이를 알 수 없는 경우 API 필드가 변경된 시간을 사용합니다.

message

string

메시지는 전환에 대한 세부 정보를 나타내는 사람이 읽을 수 있는 메시지입니다. 빈 문자열일 수 있습니다.

observedGeneration

integer

observedGeneration은 조건이 설정된 .metadata.generation을 나타냅니다. 예를 들어, .metadata.generation이 현재 12이지만 .status.conditions[x].observedGeneration이 9인 경우 해당 조건은 인스턴스의 현재 상태를 기준으로 오래되었습니다.

reason

string

reason에는 조건의 마지막 전환에 대한 이유를 나타내는 프로그래밍 식별자가 포함되어 있습니다. 특정 조건 유형의 생산자는 이 필드에 대한 예상 값과 의미를 정의하고, 해당 값이 보장된 API로 간주되는지 여부를 결정할 수 있습니다. 값은 CamelCase 문자열이어야 합니다. 이 필드는 비어 있을 수 없습니다.

status

string

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

type

string

CamelCase 또는 foo.example.com/CamelCase의 조건 유형입니다.