Pod 호스트네임

Pod 호스트네임 (pod-hostname)

출처: 쿠버네티스 공식 문서 — Pod Hostname

이 페이지는 Pod의 호스트네임을 설정하는 방법, 구성 후의 잠재적 부작용, 그리고 그 뒤에 있는 기본 메커니즘을 설명해요.

기본 Pod 호스트네임 (Default Pod hostname)

Pod가 생성되면, 그 호스트네임(Pod 내부에서 관찰되는)은 Pod의 metadata.name 값에서 파생돼요. 호스트네임과 그에 대응하는 FQDN(fully qualified domain name) 모두 (Pod의 관점에서) metadata.name 값으로 설정돼요.

apiVersion: v1
kind: Pod
metadata:
  name: busybox-1
spec:
  containers:
  - image: busybox:1.28
    command:
      - sleep
      - "3600"
    name: busybox

이 매니페스트로 생성된 Pod의 호스트네임과 FQDN은 busybox-1로 설정돼요.

pod의 hostname과 subdomain 필드로 호스트네임 설정 (Hostname with pod's hostname and subdomain fields)

Pod 스펙에는 선택적인 hostname 필드가 있어요. 설정하면 이 값이 호스트네임(Pod 내부에서 관찰되는)으로 metadata.name보다 우선해요.

예를 들어 spec.hostname이 my-host로 설정된 Pod의 호스트네임은 my-host가 돼요.

pod의 setHostnameAsFQDN 필드로 호스트네임 설정 (Hostname with pod's setHostnameAsFQDN fields)

Pod의 FQDN은 앞서 정의한 것과 같은 방식으로 구성돼요. Pod의 spec.hostname(지정된 경우) 또는 metadata.name 필드, spec.subdomain, namespace 이름, 클러스터 도메인 접미사로 이루어져요.

pod의 hostnameOverride로 호스트네임 설정 (Hostname with pod's hostnameOverride)

기능 상태: Kubernetes v1.35 [beta] (기본 활성화)

Pod 스펙에 hostnameOverride 값을 설정하면 kubelet이 Pod의 호스트네임과 FQDN을 모두 조건 없이 hostnameOverride 값으로 설정해요.

참고 (Note)

hostnameOverride가 다른 필드(hostname, subdomain, setHostnameAsFQDN, hostNetwork)와 함께 설정됐을 때의 동작에 대한 자세한 내용은 KEP-4762 설계 세부사항의 표를 참고하세요.