Kubernetes 레이블과 어노테이션
Apollo 에이전트는 스포크 환경(Spoke Environment)에 제품을 배포할 때 Kubernetes 리소스에 레이블과 어노테이션을 추가합니다. 이 메타데이터는 상태 수집 대상을 식별하고 Kubernetes 객체를 Apollo 환경, 배포 개체와 제품 릴리스에 연결합니다.
상태 수집 레이블
서비스의 생존 상태(Liveness)와 준비 상태(Readiness)를 Apollo에 보고하려면 Pod 명세 템플릿에 다음 레이블이 있어야 합니다. 제공되는 Apollo 에이전트로 배포한 개체에는 자동으로 추가합니다.
apollo.palantir.com/status.liveness_and_readiness: ""
빈 문자열 값도 의도된 값입니다. 레이블 키를 임의로 줄이거나 바꾸지 않습니다.
리소스 식별 어노테이션
다음 어노테이션은 Apollo 에이전트가 배포할 때 자동으로 추가합니다.
| 어노테이션 | 값 |
|---|---|
apollo.palantir.com/metadata.environment.id | 개체가 속한 Apollo 환경 ID |
apollo.palantir.com/metadata.entity.id | Kubernetes 객체에 연결된 Apollo 배포 개체 ID |
apollo.palantir.com/metadata.product.name | 제품 이름 |
apollo.palantir.com/metadata.product.group | 제품 그룹 |
apollo.palantir.com/metadata.product.version | 제품 버전 |
배포 개체 ID는 aeid:<apollo-environment-id>:<entity-type>:<entity-name> 형식이며 255자 미만이어야 합니다. 다음은 값의 형태를 보여 주는 예시입니다.
apollo.palantir.com/metadata.environment.id: example-apollo-environment-id
apollo.palantir.com/metadata.entity.id: "aeid:example-apollo-environment-id:helm-chart:prometheus-helm"
apollo.palantir.com/metadata.product.name: prometheus
apollo.palantir.com/metadata.product.group: com.palantir
apollo.palantir.com/metadata.product.version: 2.0.0
이 예시에서 helm-chart는 배포 개체 유형입니다. 매니페스트의 제품 유형과는 별도 필드입니다. 사용자 정의 운영 상태까지 보고하려면 이 식별 정보와 별도로 Health 점검 어노테이션을 Pod 템플릿에 구성합니다.