Kubernetes · 2 min read · Dec 14, 2025
Kubernetes의 정적 파드

정적 파드는 kubelet에 의해 직접 관리되며 API 서버는 이러한 파드에 대한 제어 권한이 없습니다. kubelet은 각 정적 파드를 감시하고 충돌할 경우 재시작할 책임이 있습니다. 노드에서 실행 중인 정적 파드는 API 서버에서 볼 수 있지만 API 서버에 의해 제어될 수 없습니다. 정적 파드는 관련된 복제 컨트롤러가 없으며, kubelet 서비스 자체가 이를 감시하고 충돌 시 재시작합니다. 정적 파드에 대한 헬스 체크는 없습니다. kubelet 프로세스는 정적 파드를 위해 지정된 특정 디렉토리를 감시합니다.
정적 파드에 대해 더 알고 싶다면 Kubernetes 공식 페이지를 방문하세요.
이 기사에서는 kubelet이 매니페스트를 읽는 기본 위치에 저장된 파일에서 정적 파드를 생성하는 단계와 기본 위치를 다른 디렉토리로 변경하여 그곳에서 정적 파드를 생성하는 방법을 살펴보겠습니다. 우리는 워커 노드에서 정적 파드를 생성할 것입니다.
사전 요구 사항
- 최소 1개의 워커 노드가 있는 Kubernetes 클러스터. Kubernetes 클러스터를 생성하는 방법을 배우고 싶다면 여기를 클릭하세요. 이 가이드는 AWS Ubuntu 18.04 EC2 인스턴스에서 1개의 마스터와 2개의 노드를 가진 Kubernetes 클러스터를 생성하는 데 도움이 됩니다.
우리가 할 일
- 정적 파드 생성
정적 파드 생성
클러스터의 노드 및 파드 세부 정보를 얻기 위해 마스터 노드에서 다음 명령을 실행하세요.
$master kubectl get nodes$master kubectl get pods
파드의 일부로 실행 중인 컨테이너를 확인할 수 있습니다.
$worker docker ps$worker docker ps -a이제 워커 노드에 로그인하고 정적 파드 매니페스트의 기본 경로에 다음 내용을 가진 새 파일을 생성하세요.
$worker vim /etc/kubernetes/manifests/static-web.yamlapiVersion: v1
kind: Pod
metadata:
name: static-web
labels:
role: myrole
spec:
containers:
- name: web
image: nginx
ports:
- name: web
containerPort: 80
protocol: TCP
정적 파드 매니페스트의 기본 위치에 파드 정의를 생성하자마자 API 서버에 의해 제어되지 않는 파드가 생성됩니다.
마스터 노드에서 모든 네임스페이스의 파드를 나열하기 위해 다음 명령으로 새로 생성된 파드를 확인할 수 있습니다.
$master kubectl get pods$master kubectl get pods --all-namespaces
파드의 일부로 생성된 컨테이너를 확인하려면 워커 노드에서 다음 명령을 실행하세요.
$worker docker ps$worker docker ps -a기본적으로 kubelet이 매니페스트를 읽는 위치를 변경할 수도 있습니다.
이제 정적 파드의 매니페스트를 저장할 새 폴더를 생성합니다.
여기서는 “/etc/kubelet.d/“를 생성합니다.
$worker mkdir -p /etc/kubelet.d/우리가 생성한 디렉토리에 파드 정의 파일을 생성합니다.
$worker vim /etc/kubelet.d/static-web.yamlapiVersion: v1
kind: Pod
metadata:
name: static-web-2
labels:
role: myrole
spec:
containers:
- name: web
image: nginx
ports:
- name: web
containerPort: 80
protocol: TCPKubelet이 정적 파드의 매니페스트를 읽는 기본 경로를 변경하려면 /var/lib/kubelet/config.yaml 파일을 편집하고 “staticPodPath”의 값을 “staticPodPath=/etc/kubelet.d”로 변경합니다.

구성이 완료되면 Kubelet 서비스를 재시작합니다.
$worker systemctl restart kubelet서비스가 재시작되자마자 Kubelet은 새 위치를 감지하고 해당 위치에서 매니페스트를 읽어 파드를 생성합니다.
파드가 생성되었는지 확인하세요.
$master kubectl get pods워커 노드에서 다음 명령을 사용하여 파드의 일부로 생성된 컨테이너를 확인하세요.
$worker docker ps결론
이 기사에서는 정적 파드를 생성하는 단계와 정적 파드의 매니페스트를 위한 기본 디렉토리를 변경하기 위해 Kubelet에서 필요한 구성 변경을 살펴보았습니다.
새 게시물을 받은 편지함에서 받기
스팸은 없습니다. 언제든지 구독 해지 가능합니다.