Containers e Kubernetes
Container
Unidade leve de execução que inclui uma aplicação e as suas dependências, garantindo comportamento consistente entre ambientes.
Docker
Plataforma utilizada para criar, executar e gerir containers.
Imagem Docker
Template imutável usado para criar containers, contendo o código da aplicação e as dependências necessárias.
Kubernetes
Sistema de orquestração de containers que automatiza deployment, gestão, recuperação e escalabilidade de aplicações.
K3s
Distribuição leve de Kubernetes, adequada a ambientes com recursos limitados, como uma VM privada.
Cluster
Conjunto de máquinas, chamadas nodes, que trabalham em conjunto para executar workloads Kubernetes.
Node
Máquina física ou virtual que faz parte do cluster Kubernetes.
Pod
Unidade mínima de execução no Kubernetes, podendo conter um ou mais containers.
Deployment
Objeto Kubernetes responsável por criar, atualizar e manter pods da aplicação em execução.
Service
Componente que expõe pods e permite comunicação estável dentro ou fora do cluster.
Ingress Controller
Componente que gere o acesso externo HTTP/HTTPS às aplicações do cluster.
Traefik
Ingress Controller incluído por omissão no K3s, usado para encaminhar hosts públicos para Services internos.
Namespace
Mecanismo de isolamento lógico dentro do Kubernetes para organizar recursos e aplicações.
Workload
Aplicação ou serviço em execução no cluster.
Control Plane
Conjunto de componentes responsáveis pela gestão e estado global do cluster Kubernetes.
Orquestração de Containers
Gestão automática de containers, incluindo deploy, monitorização, recuperação e atualização.
CI/CD e automação
CI/CD
Conjunto de práticas que automatizam integração, validação e deployment de código.
Continuous Integration
Processo de integração contínua de código com validações e testes automáticos.
Continuous Deployment
Processo de publicação automática de aplicações após validação.
GitHub Actions
Ferramenta de automação do GitHub usada para executar pipelines de build e deploy.
Workflow
Conjunto de passos automatizados definidos num ficheiro YAML.
Build
Processo de preparação da aplicação e construção da imagem Docker.
Deploy
Processo de disponibilização da aplicação no ambiente de execução.
Rolling Updates
Estratégia de atualização gradual que reduz interrupções de serviço.
Autoscaling
Capacidade de ajustar automaticamente o número de instâncias de uma aplicação.
DevOps
Conjunto de práticas que aproxima desenvolvimento e operações através de automação, entrega contínua e fiabilidade.
Helm
Gestor de pacotes para Kubernetes usado para instalar e atualizar aplicações de forma parametrizável.
Helm chart
Pacote Helm com templates dos recursos Kubernetes necessários a uma aplicação.
Segurança e configuração
GitHub Secrets
Mecanismo seguro para guardar credenciais e dados sensíveis usados nas pipelines.
Kubernetes Secret
Objeto Kubernetes usado para guardar dados sensíveis e injetá-los nos pods sem os expor no código.
APP_RUNTIME_ENV
GitHub Secret opcional com variáveis KEY=VALUE convertidas pela pipeline num Secret Kubernetes.
RBAC
Mecanismo Kubernetes de controlo de permissões baseado em papéis.
ServiceAccount
Identidade usada por uma aplicação para aceder à API do Kubernetes com permissões controladas.
Port-forward
Túnel temporário criado com kubectl para aceder a recursos internos, como PostgreSQL, sem exposição pública.
Base de dados e backups
PostgreSQL
Sistema de gestão de base de dados relacional usado pela plataforma no namespace databases.
Migration
Operação que cria ou atualiza o esquema da base de dados de uma aplicação.
Kubernetes Job
Objeto que executa uma tarefa pontual até à conclusão, usado para correr migrations.
CronJob
Objeto Kubernetes que executa Jobs periodicamente, usado para backups automáticos.
Cloudflare R2
Serviço de armazenamento de objetos compatível com S3, usado para guardar backups fora do cluster.
pg_dumpall
Utilitário PostgreSQL que exporta todas as bases de dados para um ficheiro de backup.
Componentes do projeto
Container Registry (GHCR)
Registo de imagens Docker do GitHub onde são publicadas as imagens das aplicações.
platform-orchestrator
Repositório privado central com workflow reutilizável de GitHub Actions e Helm chart genérico.
deisi-management
Portal público em Django que apresenta a infraestrutura, lista aplicações publicadas e disponibiliza documentação.