Guia 01 / 3
Glossário de Kubernetes
Compreender a orquestração e o papel dos recursos Kubernetes através de definições simples e de exemplos concretos.
Explicar a relação cluster → nós → Pods e identificar os controladores, serviços e mecanismos de armazenamento.
01 · Compreender o cluster
O Kubernetes não constrói imagens: organiza a execução de aplicações em contentores em várias máquinas.
Kubernetes (K8s)
Plataforma de orquestração que implementa, monitoriza e ajusta aplicações sob a forma de contentores. Procura continuamente aproximar a realidade da configuração pedida.
Exemplo
Demander 3 répliques : Kubernetes tente de maintenir 3 Pods.
O Kubernetes complementa o Docker e outros motores; não substitui um Dockerfile.
Cluster
Conjunto de máquinas e de componentes Kubernetes que cooperam para executar aplicações. Compreende um plano de controlo e nós de trabalho.
Exemplo
Un cluster de TP : 1 control plane et 2 workers.
Plano de controlo (control plane)
Conjunto de componentes que tomam as decisões: receber pedidos, memorizar objetos, planear e corrigir o estado do cluster.
Exemplo
API server + etcd + scheduler + controller manager.
Não é necessariamente uma máquina única.
Nó de trabalho (worker node)
Máquina física ou virtual que aloja os Pods e executa as tarefas atribuídas pelo cluster.
Exemplo
Un worker héberge les Pods web et api.
Servidor de API (API server)
Ponto de entrada da API do Kubernetes. Valida os pedidos e permite criar, consultar ou modificar recursos.
Exemplo
kubectl get pods interroge l’API server.
etcd
Base de dados chave-valor utilizada para conservar o estado e a configuração do cluster.
Exemplo
Les objets Deployment sont stockés via le plan de contrôle.
As suas cópias de segurança são críticas para a recuperação de um cluster autogerido.
Escalonador (scheduler)
Componente do plano de controlo que escolhe o nó em que um Pod ainda não atribuído poderá ser executado.
Exemplo
Tient compte des ressources, affinités, contraintes et taints.
Controlador / reconciliação
Ciclo de controlo que observa o estado real e age para alcançar o estado desejado (reconciliação).
Exemplo
Un contrôleur recrée un Pod perdu pour maintenir 3 répliques.
Kubelet
Agente presente em cada nó, encarregado de fazer funcionar os Pods atribuídos ao nó e de comunicar o seu estado.
Exemplo
Kubelet supervise les conteneurs d’un Pod.
Ambiente de execução de contentores (container runtime)
Software presente nos nós que executa os contentores (muitas vezes containerd ou CRI-O) através da interface CRI.
Exemplo
Kubelet demande à containerd de démarrer un conteneur.
O Docker Engine não é indispensável nos nós Kubernetes modernos.
02 · Pods e cargas de trabalho
O Pod é a unidade de execução; os controladores tornam essa execução duradoura, repetível ou planeada.
Pod
Menor unidade implementável do Kubernetes. Agrupa um ou vários contentores que partilham um endereço IP, portas e certos volumes.
Exemplo
Un Pod nginx avec son conteneur web.
Um Pod não é uma máquina; o seu IP e a sua identidade podem mudar.
Contentor
Processo aplicacional isolado lançado a partir de uma imagem dentro de um Pod.
Exemplo
Le Pod web exécute nginx:stable.
Deployment
Objeto de controlo adaptado às aplicações sem identidade estável. Gere um ReplicaSet, as réplicas e as atualizações progressivas.
Exemplo
Un Deployment web avec replicas: 3.
ReplicaSet
Controlador que mantém um número desejado de Pods correspondentes a um seletor de labels. É geralmente criado por um Deployment.
Exemplo
Le ReplicaSet du Deployment web maintient 3 Pods.
StatefulSet
Controlador destinado às aplicações que necessitam de uma identidade de rede e/ou de um armazenamento estáveis por réplica.
Exemplo
Une base de données distribuée avec des Pods db-0, db-1.
Continua a ser necessária uma cópia de segurança: um StatefulSet não protege automaticamente os dados.
DaemonSet
Controlador que coloca habitualmente um Pod em cada nó elegível, nomeadamente para agentes técnicos.
Exemplo
Agent de logs ou de supervision sur chaque worker.
Job
Objeto que executa uma tarefa até à sua conclusão, em vez de manter um servidor ativo permanentemente.
Exemplo
Traitement d’un fichier ou migration ponctuelle.
CronJob
Objeto que cria Jobs segundo um planeamento em formato cron.
Exemplo
Planifier un rapport chaque nuit à 02:00.
O horário depende do fuso indicado ou do do controlador.
Réplica
Instância desejada de uma aplicação: na prática, uma réplica corresponde a um Pod gerido por um controlador.
Exemplo
replicas: 3 demande 3 Pods.
Init container / sidecar
Um init container prepara o Pod antes do arranque aplicacional; um sidecar acompanha o contentor principal, por exemplo para um proxy ou registos.
Exemplo
Init : préparer un fichier ; sidecar : collecter des traces.
O seu ciclo de vida e a sua configuração não são idênticos.
03 · Objetos, labels e configuração
Descreve-se o que se pretende obter em recursos da API, muitas vezes escritos em YAML.
Objeto / recurso Kubernetes
Registo na API que representa uma intenção: Pod, Service, ConfigMap, Deployment, etc.
Exemplo
kubectl get deployments retourne des objets Deployment.
Manifesto YAML
Ficheiro de texto declarativo que descreve um ou vários recursos Kubernetes, com chaves e indentação significativa.
Exemplo
kubectl apply -f web.yaml
Utilizar espaços, nunca tabulações YAML.
apiVersion / kind
apiVersion identifica a versão da API para um tipo de recurso; kind precisa de que tipo de objeto se trata.
Exemplo
apiVersion: apps/v1 ; kind: Deployment.
apiVersion depende do kind; não é a versão do cluster.
metadata / name
Bloco de identificação de um objeto: nome, namespace, labels e anotações.
Exemplo
metadata:
name: web
spec / status
spec descreve o estado esperado pelo utilizador; status reflete o estado observado pelo Kubernetes.
Exemplo
spec.replicas: 3 ; status.readyReplicas: 2.
Evitar modificar status manualmente.
Namespace
Perímetro lógico que organiza muitos recursos e facilita as regras de acesso e as quotas; não é um cluster separado.
Exemplo
Namespace dev et namespace prod.
Recursos como Node e PersistentVolume não pertencem a um namespace.
Label / seletor
Um label é um par chave-valor associado a um objeto; um seletor filtra ou liga os objetos que têm os labels esperados.
Exemplo
app: web ; selector.matchLabels.app: web.
A coerência dos labels determina quais os Pods visados por um Service.
Anotação
Metadado textual para armazenar um contexto ou uma configuração auxiliar, sem vocação principal para a seleção.
Exemplo
Description, référence de build ou indication d’un contrôleur.
Configuração declarativa
Abordagem em que se descreve o estado final desejado e se confia depois ao Kubernetes a tarefa de o manter.
Exemplo
kubectl apply -f deployment.yaml
Privilegiar ficheiros versionados para os recursos duradouros.
04 · Comunicação e exposição de rede
Um Pod tem um IP efémero; um Service fornece um ponto de contacto estável para Pods que podem ser substituídos.
Service
Objeto que oferece um acesso de rede estável a um conjunto de Pods, geralmente selecionados pelos seus labels.
Exemplo
Le Service web route le trafic vers les Pods app: web.
Um Service não é um contentor suplementar.
ClusterIP
Tipo de Service acessível através de um endereço interno ao cluster; é o tipo por omissão.
Exemplo
L’API appelle http://web:80 à l’intérieur du cluster.
NodePort
Tipo de Service acessível numa porta TCP/UDP atribuída em cada nó, para além do ClusterIP.
Exemplo
http://IP-du-noeud:30080
A firewall e a topologia de rede podem impedir este acesso.
LoadBalancer
Tipo de Service que pede um balanceador de carga fornecido por uma cloud ou por uma integração de rede compatível.
Exemplo
Exposition d’un service par IP externe.
Num cluster local, é necessária uma solução adequada.
Ingress / controlador de Ingress
O Ingress descreve rotas HTTP/HTTPS por anfitrião e caminho; um controlador instalado no cluster aplica essas regras.
Exemplo
app.exemple.test → Service web.
Criar apenas um Ingress não basta; a Gateway API merece ser estudada para os novos projetos.
Gateway API
Família de API mais expressiva para configurar os acessos de rede, distinta dos controladores que a implementam efetivamente.
Exemplo
HTTPRoute associé à une Gateway.
Requer a instalação de uma implementação compatível.
DNS do cluster
Resolução de nomes que permite encontrar um Service pelo nome, tipicamente através do CoreDNS.
Exemplo
web.dev.svc.cluster.local pointe vers le Service web.
NetworkPolicy
Regra de rede que descreve que fluxos de entrada e/ou de saída os Pods selecionados podem aceitar ou emitir.
Exemplo
Limiter les flux vers la base aux Pods de l’API.
Requer um plugin de rede (CNI) que aplique as NetworkPolicies.
05 · Armazenamento, segurança e disponibilidade
A orquestração não dispensa de proteger os dados, o acesso ao cluster e a saúde das aplicações.
Volume / emptyDir
Espaço de armazenamento montado num Pod; emptyDir é criado para um Pod e eliminado quando esse Pod é retirado do nó.
Exemplo
Fichiers temporaires partagés entre conteneurs du Pod.
emptyDir não convém a dados de negócio duradouros.
PersistentVolume (PV)
Recurso de armazenamento disponível no cluster, fornecido manualmente ou através de um aprovisionamento dinâmico.
Exemplo
Disque associé à une capacité de 10 Gi.
PersistentVolumeClaim (PVC)
Pedido de capacidade de armazenamento emitido por uma aplicação; o PVC é ligado a um PV compatível.
Exemplo
Demander 2Gi pour les données d’un Pod.
A eliminação de um PVC pode provocar perda de armazenamento consoante a política de recuperação.
StorageClass
Perfil que descreve como pedir e aprovisionar automaticamente um armazenamento persistente consoante a infraestrutura.
Exemplo
StorageClass fast pour des volumes rapides.
ConfigMap
Objeto que armazena uma configuração não confidencial, utilizável sob a forma de variáveis de ambiente ou de ficheiros.
Exemplo
MODE=production
Não colocar palavras-passe nele.
Segredo (secret)
Objeto destinado a dados sensíveis, injetáveis nos Pods através de variáveis ou volumes.
Exemplo
Mot de passe de base de données.
Base64 não é cifragem; proteger o RBAC e o armazenamento do etcd.
ServiceAccount / RBAC
Um ServiceAccount é uma identidade de workload; o RBAC atribui permissões a sujeitos através de Role/ClusterRole e RoleBinding/ClusterRoleBinding.
Exemplo
Autoriser un agent à lire des Pods dans dev.
Aplicar o princípio do menor privilégio.
Request / limit
Request = recursos garantidos para o planeamento; limit = teto de utilização, que pode provocar limitação de CPU ou paragem por memória.
Exemplo
requests.cpu: 100m ; limits.memory: 256Mi.
Um excesso de memória pode provocar OOMKilled.
Readiness / liveness / startup
Readiness indica se o Pod aceita tráfego; liveness indica se o contentor deve ser reiniciado; startup dá tempo a um arranque lento.
Exemplo
/ready et /health interrogés par le kubelet.
Más configurações = reinícios em ciclo.
Rolling update / rollback
Atualização progressiva que substitui os Pods por etapas; o rollback permite voltar a uma revisão anterior do Deployment.
Exemplo
kubectl rollout undo deployment/web.
Verificar a compatibilidade dos dados e das migrações.