Wiki source code of k3s-1

Version 1.1 by tech on 2026/07/10 00:27

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