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

addresses

배열(문자열)

이 끝점의 주소입니다. 이 필드의 내용은 해당 EndpointSlice addressType 필드에 따라 해석됩니다. 소비자는 자체 기능 컨텍스트에서 다양한 유형의 주소를 처리해야 합니다. 여기에는 하나 이상의 주소가 포함되어야 하지만 100을 초과해서는 안 됩니다. 이러한 모든 것은 번거로 간주되며 클라이언트는 첫 번째 요소 만 사용하도록 선택할 수 있습니다. 참조: https://issue.k8s.io/106267

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 값은 알 수 없는 상태를 나타냅니다. 대부분의 경우 소비자는 이 unknown 상태를 ready로 해석해야 합니다. 호환성을 위해 종료 끝점에 대해 ready는 "true"여야 합니다.

서빙

boolean

서빙은 끝점의 종료 상태에 관계없이 설정되어 있다는 점을 제외하고는 준비와 동일합니다. 이 조건은 종료 중인 준비된 끝점에 대해 true로 설정해야 합니다. nil인 경우 소비자는 ready 상태로 지연해야 합니다. 이 필드는 EndpointSliceTerminatingCondition 기능 게이트를 사용하여 활성화할 수 있습니다.

종료

boolean

종료는 이 끝점이 종료되었음을 나타냅니다. nil 값은 알 수 없는 상태를 나타냅니다. 소비자는 이 알 수 없는 상태를 해석하여 끝점이 종료되지 않음을 의미합니다. 이 필드는 EndpointSliceTerminatingCondition 기능 게이트를 사용하여 활성화할 수 있습니다.

forZones

array

forZones는 토폴로지 인식 라우팅을 활성화하기 위해 이 끝점이 사용해야 하는 영역을 나타냅니다.

forZones[]

object

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

name

string

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

appProtocol

string

이 포트의 애플리케이션 프로토콜입니다. 이 필드는 표준 Kubernetes 라벨 구문을 따릅니다. UN-prefixed 이름은 IANA 표준 서비스 이름(RFC-6335 및 https://www.iana.org/assignments/service-names)용으로 예약되어 있습니다. 비표준 프로토콜은 mycompany.com/my-custom-protocol과 같은 접두사가 지정된 이름을 사용해야 합니다.

name

string

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

port

integer

끝점의 포트 번호입니다. 이 값을 지정하지 않으면 포트가 제한되지 않으며 특정 소비자의 컨텍스트에서 해석되어야 합니다.

프로토콜

string

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