Kubernetes · 3 min read · Dec 14, 2025

Pods Estáticos no Kubernetes

Pods Estáticos são gerenciados diretamente pelo kubelet e o servidor API não tem controle sobre esses pods. O kubelet é responsável por monitorar cada Pod Estático e reiniciá-lo se ele falhar. Os Pods Estáticos em execução em um nó são visíveis no servidor API, mas não podem ser controlados pelo Servidor API. O Pod Estático não tem nenhum controlador de replicação associado, o próprio serviço kubelet o monitora e o reinicia quando falha. Não há verificação de saúde para pods estáticos. O processo kubelet monitora o diretório específico designado para Pods Estáticos.

Para saber mais sobre os Pods Estáticos, visite a página oficial do Kubernetes aqui.

Neste artigo, veremos os passos para criar um Pod Estático a partir do arquivo salvo na localização padrão de onde o kubelet lê os manifests e também mudaremos a localização padrão para outro diretório e veremos a criação do pod estático a partir daí. Criaremos pods estáticos no nó Worker.

Pré-requisitos

  1. Cluster Kubernetes com pelo menos 1 nó worker.
    Se você quiser aprender a criar um Cluster Kubernetes, clique aqui. Este guia ajudará você a criar um cluster Kubernetes com 1 Master e 2 Nós em Instâncias EC2 AWS Ubuntu 18.04.

O que faremos?

  1. Criar Pods Estáticos

Criar Pods Estáticos

Execute os seguintes comandos a partir do nó master para obter os detalhes dos nós e pods no cluster.

$master kubectl get nodes
$master kubectl get pods

get-all-pods

Você pode verificar os contêineres em execução como parte dos pods

$worker docker ps
$worker docker ps -a

Agora, faça login no nó worker e crie um novo arquivo com o seguinte conteúdo no caminho padrão dos manifests de pods estáticos.

$worker vim /etc/kubernetes/manifests/static-web.yaml
apiVersion: v1
kind: Pod
metadata:
  name: static-web
  labels:
    role: myrole
spec:
  containers:
    - name: web
      image: nginx
      ports:
        - name: web
          containerPort: 80
          protocol: TCP

static-pod-definition-at-default-location

Assim que você criar uma definição de pod na localização padrão do manifest dos pods estáticos, o pod é criado, o que não é controlado pelo servidor API.

Você pode verificar o pod recém-criado com o seguinte comando para listar pods de todos os namespaces a partir do nó master.

$master kubectl get pods
$master kubectl get pods --all-namespaces

static-pod-created

Para verificar os contêineres criados como parte do Pod, execute o seguinte comando no nó worker

$worker docker ps
$worker docker ps -a

Podemos também mudar a localização padrão de onde o kubelet lê os manifests.

Agora crie uma nova pasta onde gostaríamos de armazenar os manifests dos Pods Estáticos.

Aqui, estamos criando “/etc/kubelet.d/“.

$worker mkdir -p /etc/kubelet.d/

Crie um arquivo de definição de pod no diretório que criamos.

$worker vim /etc/kubelet.d/static-web.yaml
apiVersion: v1
kind: Pod
metadata:
  name: static-web-2
  labels:
    role: myrole
spec:
  containers:
    - name: web
      image: nginx
      ports:
        - name: web
          containerPort: 80
          protocol: TCP

Para mudar o caminho padrão de onde os Kubelets lêem os manifests dos Pods Estáticos, edite o arquivo /var/lib/kubelet/config.yaml e mude o valor de “staticPodPath” para “staticPodPath=/etc/kubelet.d”.

change-static-pod-path

Assim que a configuração estiver em vigor, reinicie o Serviço Kubelet

$worker systemctl restart kubelet

Assim que o serviço for reiniciado, o Kubelet detecta a nova localização e lê os manifests a partir dessa localização e cria os pods.

Verifique se o pod foi criado ou não.

$master kubectl get pods

Verifique o contêiner criado como parte do Pod no nó worker usando o seguinte comando.

$worker docker ps

Conclusão

Neste artigo, vimos os passos para criar pods estáticos e também vimos a mudança de configuração necessária no Kubelet para alterar o diretório padrão para os manifests dos Pods Estáticos.

Share: X/Twitter LinkedIn

Receba novas postagens na sua caixa de entrada

Sem spam. Cancele a assinatura a qualquer momento.