12장. EndpointSlice [discovery.k8s.io/v1]

addresses

배열(문자열)

이 끝점의 주소입니다. addressType "IPv4" 또는 "IPv6"의 EndpointSlices의 경우 값은 표준 형식의 IP 주소입니다. 다른 addressType 값의 구문 및 의미 체계는 정의되지 않습니다. 여기에는 하나 이상의 주소가 포함되어야 하지만 100을 초과해서는 안 됩니다. EndpointSlice 컨트롤러에서 생성한 endpointslice에는 항상 정확히 1개의 주소가 있습니다. 첫 번째 이외의 추가 주소에 대해 시맨틱이 정의되어 있지 않으며 kube-proxy는 이를 확인하지 않습니다.

conditions

object

EndpointConditions는 끝점의 현재 상태를 나타냅니다.

deprecatedTopology

오브젝트(문자열)

deprecatedTopology에는 v1beta1 API의 토폴로지 정보 부분이 포함되어 있습니다. 이 필드는 더 이상 사용되지 않으며 v1beta1 API가 제거될 때 ( kubernetes v1.24)보다 빨리 제거됩니다. 이 필드는 값을 보유할 수 있지만 v1 API를 통해 쓸 수 없으며 쓰기 시도는 자동으로 무시됩니다. 토폴로지 정보는 대신 zone 및 nodeName 필드에서 찾을 수 있습니다.

팁

object

EndpointHints는 끝점을 사용하는 방법을 설명하는 힌트를 제공합니다.

hostname

string

이 끝점의 호스트 이름입니다. 엔드포인트 소비자는 이 필드를 사용하여 끝점을 서로 구분할 수 있습니다(예: DNS 이름). 동일한 호스트 이름을 사용하는 끝점이 여러 개 있는 것으로 간주해야 합니다(예: DNS의 여러 A 값). 소문자여야 하며 DNS 라벨(RFC 1123) 검증을 통과해야 합니다.

nodeName

string

nodename은 이 엔드포인트를 호스팅하는 노드의 이름을 나타냅니다. 노드에 로컬 끝점을 결정하는 데 사용할 수 있습니다.

targetRef

ObjectReference

targetRef는 이 엔드포인트를 나타내는 Kubernetes 오브젝트에 대한 참조입니다.

영역

string

zone은 이 엔드포인트가 존재하는 영역의 이름입니다.

Ready

boolean

Ready는 엔드포인트를 관리하는 모든 시스템에 따라 이 엔드포인트가 트래픽을 수신할 준비가 되었음을 나타냅니다. nil 값은 "true"로 해석되어야 합니다. 일반적으로 서비스가 publishNotReadyAddresses 플래그를 설정했을 때와 같이 일부 사례에서 이를 재정의할 수 있지만 종료하지 않는 경우 끝점을 준비 상태로 표시해야 합니다.

서빙

boolean

서빙은 엔드포인트를 관리하는 모든 시스템에 따라 이 엔드포인트가 트래픽을 수신할 수 있음을 나타냅니다. Pod에서 지원하는 끝점의 경우 EndpointSlice 컨트롤러는 Pod의 Ready 조건이 True인 경우 끝점을 서비스로 표시합니다. nil 값은 "true"로 해석되어야 합니다.

종료

boolean

종료는 이 끝점이 종료되었음을 나타냅니다. nil 값은 "false"로 해석되어야 합니다.

forNodes

array

ForNodes는 토폴로지 인식 라우팅을 사용할 때 이 끝점이 사용해야 하는 노드를 나타냅니다. 최대 8개의 항목을 포함할 수 있습니다. 이는 알파 기능이며 PreferSameTrafficDistribution 기능 게이트가 활성화된 경우에만 사용됩니다.

forNodes[]

object

ForNode는 이 끝점을 사용해야 하는 노드에 대한 정보를 제공합니다.

forZones

array

forZones는 토폴로지 인식 라우팅을 사용할 때 이 끝점이 사용해야 하는 영역을 나타냅니다. 최대 8개의 항목을 포함할 수 있습니다.

forZones[]

object

ForZone은 이 엔드포인트를 사용해야 하는 영역에 대한 정보를 제공합니다.

name

string

name은 노드 이름을 나타냅니다.

name

string

name은 영역의 이름을 나타냅니다.

appProtocol

string

이 포트의 애플리케이션 프로토콜입니다. 이는 구현이 이해할 수 있는 프로토콜에 대해 보다 풍부한 동작을 제공하기 위한 힌트로 사용됩니다. 이 필드는 표준 Kubernetes 라벨 구문을 따릅니다. 유효한 값은 다음 중 하나입니다.

* UN-prefixed 프로토콜 이름 - IANA 표준 서비스 이름(RFC-6335 및 https://www.iana.org/assignments/service-names)용으로 예약되어 있습니다.

* Kubernetes 정의 접두사 이름: * 'kubernetes.io/h2c' - https://www.rfc-editor.org/rfc/rfc9113.html#name-starting-http-2-with-prior- * 'kubernetes.io/ws'에 설명된 대로 https://www.rfc-editor.org/rfc/rfc9113.html#name-starting-http-2-with-prior- * 'kubernetes.io/ws'에 설명된 대로 일반 텍스트에 설명된 대로 일반 텍스트에 설명된 대로 일반 텍스트보다 일반 텍스트보다 HTTP/2 사전 지식 - https://www.rfc-editor.org/rfc/rfc9113.html#name-starting-http-2-with-prior-에 설명된 대로 TLS를 통한 WebSocket https://www.rfc-editor.org/rfc/rfc6455 https://www.rfc-editor.org/rfc/rfc6455

* 다른 프로토콜은 mycompany.com/my-custom-protocol과 같은 구현 정의 접두사 이름을 사용해야 합니다.

name

string

name은 이 포트의 이름을 나타냅니다. EndpointSlice의 모든 포트에는 고유한 이름이 있어야 합니다. EndpointSlice가 Kubernetes 서비스에서 파생된 경우 이는 Service.ports[].name에 해당합니다. name은 빈 문자열이거나 DNS_LABEL 유효성 검사를 전달해야 합니다. * 길이는 63자 이하여야 합니다. * 소문자 영숫자 또는 '-'로 구성되어야 합니다. * 영숫자 문자로 시작하고 끝나야 합니다. 기본값은 빈 문자열입니다.

port

integer

port는 끝점의 포트 번호를 나타냅니다. EndpointSlice가 Kubernetes 서비스에서 파생된 경우 서비스의 대상 포트로 설정해야 합니다. 다른 용도로 사용되는 endpointslice에는 nil 포트가 있을 수 있습니다.

protocol

string

protocol은 이 포트의 IP 프로토콜을 나타냅니다. UDP, TCP 또는 SCTP여야 합니다. 기본값은 TCP입니다.

가능한 열거 값: - "SCTP" 는 SCTP 프로토콜입니다. - "TCP" 는 TCP 프로토콜입니다. - "UDP" 는 UDP 프로토콜입니다.