Red Hat Summit Red Hat Summit지원콘솔개발자평가판 시작연락처

11장. Endpoints [v1]

설명

끝점은 실제 서비스를 구현하는 끝점의 컬렉션입니다. 예제: 

 Name: "mysvc",
 Subsets: [
   {
     Addresses: [{"ip": "10.10.1.1"}, {"ip": "10.10.2.2"}],
     Ports: [{"name": "a", "port": 8675}, {"name": "b", "port": 309}]
   },
   {
     Addresses: [{"ip": "10.10.3.3"}],
     Ports: [{"name": "a", "port": 93}, {"name": "b", "port": 76}]
   },
]
Copy to Clipboard Toggle word wrap
유형
object

11.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

하위 집합

array

모든 끝점의 세트는 모든 하위 집합의 결합입니다. 주소는 공유하는 IP에 따라 하위 집합에 배치됩니다. 여러 포트가 있는 단일 주소이며, 그 중 일부는 준비되었으며 그 중 일부는 (다른 컨테이너에서 제공되기 때문에) 다른 포트의 다른 하위 집합에 주소가 표시됩니다. 동일한 하위 집합의 addresses 및 NotReadyAddresses에 주소가 표시되지 않습니다. 서비스를 구성하는 주소 및 포트 세트입니다.

subsets[]

object

EndpointSubset은 일반적인 포트 세트가 있는 주소 그룹입니다. 확장된 엔드 포인트 세트는 addresses x Ports의 카테시안 제품입니다. 예를 들면 다음과 같습니다.

{ addresses: [{"ip": "10.10.1.1"}, {"ip": "10.10.2.2"}], Ports: [{"name": "a", "port": 8675}, {"name": "b", "b", "port": 309}] }

결과 끝점 세트는 다음과 같이 볼 수 있습니다.

a: [ 10.10.1.1:8675, 10.10.2.2:8675 ], b: [ 10.10.1.1:309, 10.10.2.2:309 ]

11.1.1. .subsets
링크 복사

설명
모든 끝점의 세트는 모든 하위 집합의 결합입니다. 주소는 공유하는 IP에 따라 하위 집합에 배치됩니다. 여러 포트가 있는 단일 주소이며, 그 중 일부는 준비되었으며 그 중 일부는 (다른 컨테이너에서 제공되기 때문에) 다른 포트의 다른 하위 집합에 주소가 표시됩니다. 동일한 하위 집합의 addresses 및 NotReadyAddresses에 주소가 표시되지 않습니다. 서비스를 구성하는 주소 및 포트 세트입니다.
유형
array

11.1.2. .subsets[]
링크 복사

설명

EndpointSubset은 일반적인 포트 세트가 있는 주소 그룹입니다. 확장된 엔드 포인트 세트는 addresses x Ports의 카테시안 제품입니다. 예를 들면 다음과 같습니다. 

{
  Addresses: [{"ip": "10.10.1.1"}, {"ip": "10.10.2.2"}],
  Ports:     [{"name": "a", "port": 8675}, {"name": "b", "port": 309}]
}
Copy to Clipboard Toggle word wrap

결과 끝점 세트는 다음과 같이 볼 수 있습니다. 

a: [ 10.10.1.1:8675, 10.10.2.2:8675 ],
b: [ 10.10.1.1:309, 10.10.2.2:309 ]
Copy to Clipboard Toggle word wrap
유형
object
Expand
속성유형설명

주소

array

ready으로 표시된 관련 포트를 제공하는 IP 주소입니다. 이러한 끝점은 로드 밸런서 및 클라이언트가 사용할 수 있는 안전한 것으로 간주되어야 합니다.

addresses[]

object

EndpointAddress는 단일 IP 주소를 설명하는 튜플입니다.

notReadyAddresses

array

관련 포트를 제공하지만 아직 시작을 완료하지 않았거나 최근에 준비 상태 점검에 실패했거나 최근에 활성 검사에 실패했기 때문에 현재 준비 상태로 표시되지 않은 IP 주소입니다.

notReadyAddresses[]

object

EndpointAddress는 단일 IP 주소를 설명하는 튜플입니다.

포트

array

관련 IP 주소에서 사용할 수 있는 포트 번호입니다.

ports[]

object

EndpointPort는 단일 포트를 설명하는 튜플입니다.

11.1.3. .subsets[].addresses
링크 복사

설명
ready으로 표시된 관련 포트를 제공하는 IP 주소입니다. 이러한 끝점은 로드 밸런서 및 클라이언트가 사용할 수 있는 안전한 것으로 간주되어야 합니다.
유형
array

11.1.4. .subsets[].addresses[]
링크 복사

설명
EndpointAddress는 단일 IP 주소를 설명하는 튜플입니다.
유형
object
필수 항목
  • ip
Expand
속성유형설명

hostname

string

이 끝점의 호스트 이름

ip

string

이 끝점의 IP입니다. 루프백(127.0.0.0/8 또는 ::1), 링크-로컬(169.254.0.0/16 또는 fe80::/10) 또는 링크-로컬 멀티 캐스트(224.0.0.0/24 또는 ff02::/16)가 아닐 수 있습니다.

nodeName

string

선택 사항: 이 끝점을 호스팅하는 노드입니다. 노드에 로컬 끝점을 결정하는 데 사용할 수 있습니다.

targetRef

object

ObjectReference에는 참조된 오브젝트를 검사하거나 수정할 수 있는 충분한 정보가 포함되어 있습니다.

11.1.5. .subsets[].addresses[].targetRef
링크 복사

설명
ObjectReference에는 참조된 오브젝트를 검사하거나 수정할 수 있는 충분한 정보가 포함되어 있습니다.
유형
object
Expand
속성유형설명

apiVersion

string

참조의 API 버전입니다.

fieldPath

string

전체 객체 대신 객체의 일부를 참조하는 경우 이 문자열에는 desiredState.manifest.containers[2]와 같은 유효한 JSON/Go 필드 액세스 문이 포함되어야 합니다. 예를 들어, 객체 참조가 포드 내의 컨테이너에 대한 경우 "spec.containers{name}"(여기서 "name"은 이벤트를 트리거한 컨테이너의 이름을 나타냄)와 같은 값을 갖거나 컨테이너 이름이 지정되지 않은 경우 "spec.containers[2]"(이 포드에서 인덱스 2를 갖는 컨테이너)를 갖습니다. 이 구문은 객체의 일부를 참조하는 잘 정의된 방법을 갖기 위해서만 선택되었습니다.

kind

string

일종의 참조 대상이에요. 자세한 정보: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds

name

string

참조 대상의 이름. 자세한 정보: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names

네임스페이스

string

참조 대상의 네임스페이스. 자세한 정보: https://kubernetes.io/docs/concepts/overview/working-with-objects/namespaces/

resourceVersion

string

참조가 이루어진 구체적인 resourceVersion이 있는 경우. 자세한 정보: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#concurrency-control-and-consistency

uid

string

참조 대상의 UID. 자세한 정보: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#uids

11.1.6. .subsets[].notReadyAddresses
링크 복사

설명
관련 포트를 제공하지만 아직 시작이 완료되지 않았거나, 최근 준비 검사에 실패했거나, 최근 활성 검사에 실패했기 때문에 현재 준비 완료로 표시되지 않은 IP 주소입니다.
유형
array

11.1.7. .subsets[].notReadyAddresses[]
링크 복사

설명
EndpointAddress는 단일 IP 주소를 설명하는 튜플입니다.
유형
object
필수 항목
  • ip
Expand
재산유형설명

hostname

string

이 엔드포인트의 호스트 이름

ip

string

이 엔드포인트의 IP입니다. 루프백(127.0.0.0/8 또는 ::1), 링크 로컬(169.254.0.0/16 또는 fe80::/10) 또는 링크 로컬 멀티캐스트(224.0.0.0/24 또는 ff02::/16)가 될 수 없습니다.

nodeName

string

선택 사항: 이 엔드포인트를 호스팅하는 노드입니다. 이는 노드의 로컬 엔드포인트를 결정하는 데 사용될 수 있습니다.

targetRef

object

ObjectReference에는 참조된 객체를 검사하거나 수정하는 데 필요한 충분한 정보가 포함되어 있습니다.

11.1.8. .subsets[].notReadyAddresses[].targetRef
링크 복사

설명
ObjectReference에는 참조된 객체를 검사하거나 수정하는 데 필요한 충분한 정보가 포함되어 있습니다.
유형
object
Expand
재산유형설명

apiVersion

string

참조 대상의 API 버전입니다.

fieldPath

string

전체 객체 대신 객체의 일부를 참조하는 경우 이 문자열에는 desiredState.manifest.containers[2]와 같은 유효한 JSON/Go 필드 액세스 문이 포함되어야 합니다. 예를 들어, 객체 참조가 포드 내의 컨테이너에 대한 경우 "spec.containers{name}"(여기서 "name"은 이벤트를 트리거한 컨테이너의 이름을 나타냄)와 같은 값을 갖거나 컨테이너 이름이 지정되지 않은 경우 "spec.containers[2]"(이 포드에서 인덱스 2를 갖는 컨테이너)를 갖습니다. 이 구문은 객체의 일부를 참조하는 잘 정의된 방법을 갖기 위해서만 선택되었습니다.

kind

string

일종의 참조 대상이에요. 자세한 정보: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds

name

string

참조 대상의 이름. 자세한 정보: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names

네임스페이스

string

참조 대상의 네임스페이스. 자세한 정보: https://kubernetes.io/docs/concepts/overview/working-with-objects/namespaces/

resourceVersion

string

참조가 이루어진 구체적인 resourceVersion이 있는 경우. 자세한 정보: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#concurrency-control-and-consistency

uid

string

참조 대상의 UID. 자세한 정보: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#uids

11.1.9. .subsets[].ports
링크 복사

설명
관련 IP 주소에서 사용 가능한 포트 번호입니다.
유형
array

11.1.10. .subsets[].ports[]
링크 복사

설명
EndpointPort는 단일 포트를 설명하는 튜플입니다.
유형
object
필수 항목
  • port
Expand
재산유형설명

appProtocol

string

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

* 접두사가 없는 프로토콜 이름 - 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- 에 설명된 대로 일반 텍스트를 통한 HTTP/2 사전 지식 * 'kubernetes.io/ws' - https://www.rfc-editor.org/rfc/rfc6455 에 설명된 대로 일반 텍스트를 통한 웹 소켓 * 'kubernetes.io/wss' - https://www.rfc-editor.org/rfc/rfc6455 에 설명된 대로 TLS를 통한 웹 소켓

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

name

string

이 항구의 이름. 이는 해당 ServicePort의 'name' 필드와 일치해야 합니다. DNS_LABEL이어야 합니다. 포트가 하나만 정의된 경우에만 선택 사항입니다.

port

integer

엔드포인트의 포트 번호입니다.

규약

string

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

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

맨 위로 이동
Red Hat logoGithubredditYoutubeTwitter

자세한 정보

평가판, 구매 및 판매

커뮤니티

Red Hat 문서 정보

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

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

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

Red Hat 소개

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

Theme

© 2025 Red Hat