◆ CHIHUAHUAS STUDIOS
PrivacidadeDados locais
◆ CHIHUAHUAS STUDIOS← PROJETOS

ENGINEERING LAB / CONTAINER ORCHESTRATION

KUBERNETES LAB.

Do acesso externo aos Pods. Entenda a arquitetura do cluster e acompanhe os comandos essenciais de administração na ordem em que você investigaria o ambiente.

KUBERNETESKUBECTLNODES & PODSTROUBLESHOOTING

01 / ARCHITECTURE OVERVIEW

UMA REQUISIÇÃO.
VÁRIAS CAMADAS.

Fluxo ilustrativo: cliente → Ingress → Service → Pods. O control plane reconcilia o estado desejado; os worker nodes executam os containers.

KUBERNETES CLUSTER / APP NAMESPACEUSUÁRIOHTTPS / DNSINGRESSHTTP routingSERVICEClusterIP · porta 80CONTROL PLANEAPI · scheduler · controllersDEPLOYMENT / agent-api3 replicas · selector app=agent-api · scheduler distribui PodsWORKER NODE 01kubelet · container runtimeWORKER NODE 02kubelet · container runtimePOD Aagent-apicontainer :8080POD Bagent-apicontainer :8080POD Cagent-apicontainer :8080Service seleciona endpoints prontos · Deployment mantém réplicas · Nodes executam PodsCONTROLADORES
REDEWORKLOADCONTROLELinhas contínuas: tráfego · tracejadas: controle

02 / INFRASTRUCTURE TO WORKLOADS

DO SERVIDOR
AO POD.

Um cluster usa Nodes físicos ou virtuais, normalmente sobre hosts físicos e opcionalmente hypervisors. O Kubernetes agenda Pods nesses Nodes e mantém o número de réplicas declarado nos Deployments.

CAMADA 01 · HARDWARE / VIRTUALIZAÇÃOHOST 01Servidor físicoHOST 02Servidor físicoHOST 03Servidor físicoCAMADA 02 · WORKER NODES / KUBELETWORKER NODE 1kubelet · container runtimeCPU · RAM · rede · armazenamentoWORKER NODE 2kubelet · container runtimeCPU · RAM · rede · armazenamentoWORKER NODE 3kubelet · container runtimeCPU · RAM · rede · armazenamentoCAMADA 03 · CONTROLE DECLARATIVOMANIFEST YAMLkubectl apply -f k8s/Estado desejadoAPI SERVERControl Planeetcd · Controllers · SchedulerESTADO REALReconciliação contínuaReplicas / Pods disponíveisCAMADA 04 · DEPLOYMENT → REPLICASET → PODS (EXEMPLO)FRONTENDDeployment: web-uiNext.js · Service web · ReplicaSetweb-01Pod / containerweb-02Pod / containerBACKENDDeployment: apiAPI · Service interno · ReplicaSetapi-01Pod / containerapi-02Pod / containerapi-03Pod / containerDEVOPS AI AGENTDeployment: agent-workerWorkers · Job / Deployment · ReplicaSetworker-01Pod / containerworker-02Pod / containerPods podem compartilhar Nodes · ReplicaSets mantêm réplicas · Pods não são VMs

Os grupos Frontend, Backend e DevOps representam separação lógica, não três Nodes exclusivos. Em produção, Pods dos três workloads podem coexistir em qualquer Node elegível.

01 / CAMADA FÍSICA

HOST → VM → NODE

SERVIDOR FÍSICO · CPU / RAM / DISCO
↓ HYPERVISOR (OPCIONAL)
VM 01 · VM 02 · VM 03
↓ SISTEMA OPERACIONAL + KUBELET
WORKER NODE · FÍSICO OU VIRTUAL

Um Node pode ser uma VM ou um servidor bare metal. Vários Nodes podem compartilhar um host físico quando virtualizados. Kubernetes não cria VMs automaticamente.

02 / CONTROL PLANE

DO YAML À RÉPLICA

kubectl apply · API SERVER · etcd
↓ CONTROLLERS RECONCILIAM
DEPLOYMENT → REPLICASET
↓ SCHEDULER ATRIBUI NODE
PODS EXECUTAM CONTAINERS

Deployment descreve o estado desejado; ReplicaSet mantém o número de Pods. Scheduler escolhe Nodes e kubelet inicia os containers.

03 / DISTRIBUIÇÃO REAL

OS WORKLOADS COMPARTILHAM OS NODES.

As cores identificam aplicações diferentes. A posição dos Pods muda conforme agendamento, recursos e disponibilidade.

NODE A
web-01api-01worker-01
NODE B
web-02api-02worker-02
NODE C
api-03web-03worker-03

Exemplo ilustrativo de distribuição. Réplicas podem mudar por configuração ou autoscaling; um Service seleciona os Pods por labels, independentemente do Node.

04 / CONFIGURAÇÃO & PERSISTÊNCIA

CONFIGMAP · SECRET · PVC · PV

ConfigMap fornece configurações não sensíveis; Secret armazena dados sensíveis no modelo de recursos Kubernetes (requer controles adicionais de acesso e criptografia); PVC solicita armazenamento persistente, que pode ser associado a um PV.

CONFIGMAPkubectl get configmap -n appConfiguração da aplicação
SECRETkubectl get secrets -n appCredenciais e referências; não exibir valores
PVC / PVkubectl get pvc,pv -AVolumes persistentes; PV é recurso do cluster
05 / RESPONSABILIDADES

TERRAFORM / IaC

Provisiona redes, servidores, VMs e serviços de Kubernetes gerenciado. Não é pré-requisito para usar Kubernetes.

terraform plan

MANIFESTS / GITOPS

Declaram Deployments, Services, ConfigMaps e PVCs. GitOps pode reconciliar manifests versionados com o cluster.

kubectl apply -f k8s/
01 · BUILD

CÓDIGO → IMAGEM

O CI gera uma imagem de container e a publica em um registry.

docker build -t registry.example/agent:v1 .
02 · DECLARE

YAML → API SERVER

Manifests descrevem imagens, réplicas, portas e recursos desejados.

kubectl apply -f k8s/
03 · RECONCILE

DEPLOYMENT → PODS

O Deployment gerencia ReplicaSets, que mantêm Pods; o scheduler escolhe Nodes elegíveis.

kubectl get deploy,pods -n app -o wide

EXEMPLO / DECLARATIVE INFRASTRUCTURE

UM YAML POR WORKLOAD.

Frontend, Backend e Agent têm Deployments separados. Cada um pode definir imagem, quantidade de réplicas, limites de recursos e configuração próprios.

Os exemplos abaixo são ilustrativos: o DevOps AI Agent atual não está sendo apresentado como implantado em Kubernetes.

kubectl apply -f k8s/frontend.yamlkubectl apply -f k8s/backend.yamlkubectl apply -f k8s/devops-agent.yaml
● ● ●k8s/devops-agent.yaml · exemplo
apiVersion: apps/v1
kind: Deployment
metadata:
  name: devops-agent
  namespace: app
spec:
  replicas: 2
  selector:
    matchLabels:
      app: devops-agent
  template:
    metadata:
      labels:
        app: devops-agent
    spec:
      containers:
        - name: agent
          image: registry.example/agent:v1
          resources:
            requests:
              cpu: "100m"
              memory: "128Mi"
            limits:
              memory: "512Mi"
IaC vs YAML: manifests Kubernetes são configuração declarativa da aplicação; ferramentas como Terraform podem provisionar VMs, redes e o próprio cluster. GitOps pode automatizar a aplicação dos manifests. Os Pods executam containers; não são máquinas virtuais em miniatura.

03 / OPERATIONS PLAYBOOK

LEIA O CLUSTER.
ANTES DE ALTERÁ-LO.

Comandos de leitura e diagnóstico, organizados em sequência. Namespace app e recursos agent-api são exemplos.

01CONTROL PLANE

CONTEXTO & CLUSTER

● ● ●kubectl / read-only
$kubectl config current-context
$kubectl cluster-info
$kubectl get namespaces

Confirme primeiro em qual cluster e namespace você está trabalhando.

02INGRESS / SERVICE

ENTRADA & REDE

● ● ●kubectl / read-only
$kubectl get ingress -A
$kubectl get svc -A
$kubectl get endpointslices -n app

Siga o caminho da requisição até os endpoints prontos.

03DEPLOYMENT / POD

WORKLOADS

● ● ●kubectl / read-only
$kubectl get deploy -n app
$kubectl get pods -n app -o wide
$kubectl describe pod <pod> -n app

Confira réplicas desejadas, status, eventos e localização dos Pods.

04NODES

INFRAESTRUTURA

● ● ●kubectl / read-only
$kubectl get nodes -o wide
$kubectl describe node <node>
$kubectl top nodes

Analise capacidade, condições e consumo. top requer Metrics Server.

05LOGS / EVENTS

INVESTIGAÇÃO

● ● ●kubectl / read-only
$kubectl logs <pod> -n app --tail=100
$kubectl logs <pod> -n app --previous
$kubectl get events -n app --sort-by=.lastTimestamp

Quando falhar, consulte eventos e logs antes de modificar recursos.

06HPA / ROLLOUT

ESTADO & ESCALA

● ● ●kubectl / read-only
$kubectl get hpa -n app
$kubectl rollout status deploy/agent-api -n app
$kubectl get rs -n app

Observe o estado do rollout e da escala. Estratégias de deploy virão depois.

04 / NEXT LAB

ESTRATÉGIAS DE DEPLOY EM BREVE.

Rolling Update, Recreate, Blue/Green e Canary serão explorados em uma próxima etapa, com diagramas e comandos próprios.

← VOLTAR AOS PROJETOS