Wiki source code of k3s-1

Version 3.1 by tech on 2026/07/10 00:29

Hide last authors
tech 1.1 1 # Documentação da Infraestrutura da Junta de Freguesia
2
3 ## 1. Arquitetura e Recursos Globais
4
tech 3.1 5 * [[01. Objetivo e Visão Geral da Arquitetura|doc:.Objetivo.WebHome]]
tech 2.1 6 * _Objetivo, diagrama da infraestrutura e a separação entre serviços Privados e Públicos via Cloudflare._
7 * **[02. Recursos e Infraestrutura Física](Inventario_e_Credenciais.md)**
8 * _Alocação de Recursos e Mapeamento de IPs._
tech 1.1 9
10 ---
11
12 ## 2. Instalação e Configuração (Passo a Passo)
13
14 1. **[Configuração do TrueNAS e Shares NFS](TrueNAS_NFS.md)**
tech 2.1 15 * _Aprovisionamento dos datasets `gitlab` e `k8s-pvc` com ACLs._
16 1. **[Deploy do GitLab CE (VM)](GitLab_Omnibus.md)**
17 * _Configuração da VM cloud-init, mount NFS e parâmetros do Omnibus._
18 1. **[Construção do Cluster K3s em HA](K3s_Cluster.md)**
19 * _Iniciação dos 3 Masters (etcd) com kube-vip, agregação dos Workers, e deploy do MetalLB e Traefik Duplo (Público .41 e Privado .40)._
20 1. **[Instalação do ArgoCD (GitOps)](ArgoCD.md)**
21 * _Automação de deploymentse repósitorios Git._
22 1. **[Authentik SSO e Identidade Centralizada](Authentik_SSO.md)**
23 * _Implementação do IdP, integração OIDC no GitLab e ArgoCD, e políticas rigorosas de bloqueio de rede pública._
24 1. **[Observabilidade Centralizada](Observabilidade.md)**
25 * _Prometheus, Grafana, Loki no Kubernetes, e injeção do Promtail na VM do GitLab via NodePort 30100._
26 1. **[Configuração do GitLab Runner no K3s](GitLab_Runner.md)**
27 * _Runners escaláveis a correr no Kubernetes para pipelines de CI/CD._
28 1. **[Acesso Remoto via Cloudflare Tunnel](Cloudflare_Tunnel.md)**
29 * _Exposição do GitLab Público e Authentik à internet sem NAT/Port Forwarding._
30 1. **[Exemplo de Deploy Manual (Webhook)](Deploy_Aplicacao_Manual.md)**
31 * _Criação de um manifesto prático para expor e testar apps publicamente._
tech 1.1 32
33 ---
34
35 ## 3. Scripts e Templates Automáticos
36
tech 2.1 37 * **[Script de Autojoin: Adicionar Novo Worker ao K3s](k3s_worker_autojoin.md)**
38 * _Como expandir a capacidade de computação criando rapidamente uma nova VM `k3s-w3`._
39 * **[Script de Registo: Novo Runner para Pipelines](k3s_runner_autojoin.md)**
40 * _Adição de runners específicos (ex: para builds pesadas ou deploy shells)._
41 * **[Exemplo de Pipeline Completo (`.gitlab-ci.yml`)](pipeline_deploy_gitlab.md)**
42 * _Template para compilação de código, geração de imagens e sync com o ArgoCD._
tech 1.1 43
44 ---
45
46 ## 4. Exemplos e Manifestos Práticos
47
tech 2.1 48 * **[Pasta de Exemplos](Exemplos.md)**
49 * _Contém `deployment.yaml` e `kustomization.yaml`._