Glossário

Conceitos técnicos da plataforma

Lista de termos utilizados no projeto e no guia de deployment, explicados de forma direta para apoiar alunos, docentes e avaliadores na leitura da arquitetura.

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.