🚀 Manual de Implementação Passo a Passo¶

E aqui começa a jornada! Este é o guia completo para a implementação da arquitetura que elaborei para o meu servidor doméstico, construído do zero. Meu objetivo com este projeto é ter uma infraestrutura duradoura, que possa evoluir mesmo com trocas de hardware, e que resolva problemas de longo prazo de forma elegante.

Se você tiver dúvidas sobre alguma escolha ou quiser explorar alternativas, tentarei ao máximo linkar para explicações mais detalhadas e opções para cada aplicação. Lembre-se: se alguma aplicação não for do seu agrado, você pode optar por não instalá-la, mas preste atenção às possíveis integrações com outros serviços.

Objetivo¶

O objetivo deste manual é levá-lo, passo a passo, desde a preparação inicial do hardware e software até o deploy e configuração de todos os serviços essenciais. Ao final desta seção, você terá um servidor doméstico funcional, seguro e altamente automatizado.

Siga a Ordem!

É crucial seguir os passos apresentados neste manual na ordem exata em que são listados. Muitas etapas dependem de configurações realizadas anteriormente. Pular passos ou alterar a ordem pode levar a problemas de configuração e instabilidade.

Adaptações Necessárias¶

Ao longo deste manual, você encontrará placeholders e exemplos de valores (IPs, domínios, senhas, caminhos). Você DEVE substituí-los pelos seus próprios valores.

Endereços IP: Adapte para a sua sub-rede local (e.g., 192.168.X.Y).
Nomes de Domínio: Use o seu domínio registrado (e.g., meuhomelab.com).
Senhas e Tokens: Gere senhas fortes e únicas. Segredos serão gerenciados pelo Ansible Vault.
Caminhos de Arquivo: Verifique se os caminhos correspondem à sua estrutura e preferências.

Estrutura do Manual de Implementação¶

Este manual está dividido nas seguintes seções, que devem ser seguidas sequencialmente:

Preparação e Planejamento: Requisitos de hardware/software, estrutura do projeto Git e considerações iniciais.
Configuração da Máquina de Controle Ansible: Preparando o ambiente de onde você gerenciará toda a infraestrutura.
Instalação e Configuração Base do Proxmox VE: Instalando o hypervisor, configurando ZFS e o servidor NFS.
Provisionamento das Máquinas Virtuais (VMs) com Ansible: Criando as VMs core-services-vm e ai-desktop-vm de forma automatizada.
Configuração Base das VMs Ubuntu: Configurações essenciais, Docker, Portainer e cliente NFS nas VMs.
Implementação da Rede Segura: Deploy de Traefik, Cloudflare Tunnel e Authelia para acesso externo seguro.
Gerenciamento e Deploy de Stacks Docker com Portainer: Processo geral para implantar aplicações Docker usando Portainer e volumes NFS.
Stack de Inteligência Artificial (LLM/RAG com Ollama): Configurando a ai-desktop-vm para rodar modelos de linguagem e aplicações RAG.
Stack de Mídia (Plex/Jellyfin, *arrs): Deploy dos seus serviços de mídia.
Stack de Produtividade e Automação (Nextcloud, Home Assistant): Implementando Nextcloud para arquivos e Home Assistant para automação residencial.
Stack de Monitoramento (Glances, Prometheus, Grafana, Loki): Configurando ferramentas para monitorar a saúde e performance do seu servidor.

Para começar, avance para a Preparação e Planejamento.