K8s 잘 알려진 레이블

1 개요[ | ]

k8s Well-Known Labels
k8s 잘 알려진 레이블

쿠버네티스에서는 일부 레이블 키가 공식적으로 예약되거나 널리 사용되는 경우가 있다. 이러한 레이블들은 리소스에 자동으로 부여되거나, 애플리케이션을 일관성 있게 식별하기 위해 권장된다.

2 예시[ | ]

레이블 키	주요 대상	설명
app.kubernetes.io/component	Pod(Workload)	애플리케이션 아키텍처 내의 특정 컴포넌트 (예: database, frontend). 권장 레이블
app.kubernetes.io/instance	Pod(Workload)	동일 애플리케이션의 특정 인스턴스를 구분 (예: wordpress-abc123). 권장 레이블
app.kubernetes.io/managed-by	Pod(Workload)	리소스를 관리하는 도구 지정 (예: Helm, kubectl). 권장 레이블
app.kubernetes.io/name	Pod(Workload)	애플리케이션의 이름 (예: mysql). 권장 레이블
app.kubernetes.io/part-of	Pod(Workload)	상위 애플리케이션 이름 (예: wordpress). 권장 레이블
app.kubernetes.io/version	Pod(Workload)	애플리케이션 버전 (예: 5.7.21). 권장 레이블
apps.kubernetes.io/pod-index	Pod(StatefulSet)	StatefulSet이 생성한 Pod의 순번 인덱스 (베타)
kubernetes.io/metadata.name	Pod(Workload)	리소스 메타데이터 이름을 반영 (자동 할당)
kubernetes.io/arch	Node	노드 CPU 아키텍처 (예: amd64, arm64)
kubernetes.io/os	Node	노드 운영체제 (예: linux, windows)
kubernetes.io/hostname	Node	노드의 호스트명
node.kubernetes.io/instance-type	Node	노드 인스턴스 타입 (예: m5.large)
node-role.kubernetes.io/control-plane	Node	제어 플레인 노드를 지정
node-role.kubernetes.io/*	Node	사용자 정의 노드 역할 (확장 가능)
topology.kubernetes.io/region	Node	리전 정보 (예: ap-northeast-2). failure-domain.beta.kubernetes.io/region 대체
topology.kubernetes.io/zone	Node	존 정보 (예: ap-northeast-2a). failure-domain.beta.kubernetes.io/zone 대체

3 같이 보기[ | ]

4 참고[ | ]

https://kubernetes.io/docs/reference/labels-annotations-taints/