Capítulo 3.2 - Declaração YAML de Pods

Objetivos de Aprendizagem

Ao final deste capítulo, você será capaz de:

• Compreender a estrutura YAML de um Pod
• Criar Pods com kubectl
• Definir recursos (CPU, memória)
• Configurar variáveis de ambiente
• Montar volumes

---

Estrutura YAML de um Pod

Estrutura Básica

apiVersion: v1
kind: Pod
metadata:
  name: my-pod
  labels:
    app: my-app
    env: production
spec:
  containers:
  - name: my-container
    image: nginx:1.20
    ports:
    - containerPort: 80

Seções Principais

1. apiVersion: Versão da API do Kubernetes
2. kind: Tipo de recurso (Pod)
3. metadata: Metadados (nome, labels, annotations)
4. spec: Especificação do Pod

---

Exemplo Completo

apiVersion: v1
kind: Pod
metadata:
  name: web-server
  namespace: default
  labels:
    app: web
    tier: frontend
    version: v1
spec:
  containers:
  - name: nginx
    image: nginx:1.20
    imagePullPolicy: IfNotPresent
    ports:
    - name: http
      containerPort: 80
      protocol: TCP
    env:
    - name: ENV_VAR
      value: "production"
    resources:
      requests:
        cpu: "100m"
        memory: "128Mi"
      limits:
        cpu: "500m"
        memory: "512Mi"
    volumeMounts:
    - name: config
      mountPath: /etc/nginx/conf.d
  volumes:
  - name: config
    configMap:
      name: nginx-config
  restartPolicy: Always

---

Recursos (CPU e Memória)

Requests e Limits

resources:
  requests:    # Recursos garantidos
    cpu: "100m"      # 0.1 CPU core
    memory: "128Mi"  # 128 Mebibytes
  limits:      # Recursos máximos
    cpu: "500m"      # 0.5 CPU core
    memory: "512Mi"  # 512 Mebibytes

Unidades de CPU:

• 100m = 0.1 CPU
• 1 = 1 CPU core
• 2.5 = 2.5 CPU cores

Unidades de Memória:

• 128Mi = 128 Mebibytes
• 1Gi = 1 Gibibyte
• 500M = 500 Megabytes

---

Variáveis de Ambiente

Método 1: Direto

env:
- name: DATABASE_URL
  value: "postgresql://localhost:5432/mydb"
- name: LOG_LEVEL
  value: "info"

Método 2: A partir de ConfigMap

env:
- name: CONFIG_VALUE
  valueFrom:
    configMapKeyRef:
      name: my-config
      key: config-key

Método 3: A partir de Secret

env:
- name: PASSWORD
  valueFrom:
    secretKeyRef:
      name: my-secret
      key: password

---

Volumes

Tipos de Volumes

volumes:
# Volume a partir de ConfigMap
- name: config
  configMap:
    name: my-config

# Volume a partir de Secret
- name: secrets
  secret:
    secretName: my-secret

# Volume temporário
- name: temp
  emptyDir: {}

# Volume persistente
- name: data
  persistentVolumeClaim:
    claimName: my-pvc

Montagem no Contêiner

volumeMounts:
- name: config
  mountPath: /etc/config
  readOnly: true

---

Comandos kubectl

Criar um Pod

# A partir de um arquivo YAML
kubectl apply -f pod.yaml

# Pela linha de comando
kubectl run my-pod --image=nginx:1.20

# Criar e exibir o YAML
kubectl run my-pod --image=nginx:1.20 --dry-run=client -o yaml > pod.yaml

Gerenciar Pods

# Listar os Pods
kubectl get pods

# Ver detalhes
kubectl describe pod my-pod

# Ver logs
kubectl logs my-pod

# Executar um comando
kubectl exec -it my-pod -- /bin/bash

# Remover um Pod
kubectl delete pod my-pod

---

Resumo

Neste capítulo, você aprendeu:

Estrutura YAML: apiVersion, kind, metadata, spec
Recursos: Requests (garantidos) e Limits (máximos)
Variáveis de ambiente: Diretas, ConfigMap, Secret
Volumes: ConfigMap, Secret, emptyDir, PVC
Comandos: kubectl apply, get, describe, logs, exec, delete

---

Próximos Passos

Agora que você sabe criar Pods:

Capítulo 3.3: Labels e Selectors
Lab 3.1: Criação e Gerenciamento de Pods

---

Capítulo criado em: Dezembro 2024