LHC Kubernetes Homelab Infra

Esse é um projeto aberto e colaborativo e têm como objetivo, prover um ambiente para criação de laboratórios, utilizando Kubernetes com a utilização da IaC e GitOps para gerenciar toda a sua configuração.

🚀 Começando

Essas instruções permitirão que você obtenha uma cópia do projeto em operação na sua máquina local para fins de desenvolvimento e teste.

📋 Pré-requisitos

De que coisas você precisa para instalar o software e como instalá-lo?

• k3s
• helm
• terraform
• kubectl
• git

🔧 Instalação

Para realizar a instalação do seu ambiente, execute os seguintes passos (substituindo os valores das variáveis REPO e BRANCH) e indique que apps deseja instalar:

export REPO=SEU_USERNAME/NOME_DO_REPO
export BRANCH=SUA_BRANCH
export APPS='kube-prometheus'

E execute a instalação:

export INSTALL_URL=https://raw.githubusercontent.com/${REPO}/refs/heads/${BRANCH}/install.sh
curl -s $INSTALL_URL | sudo env INSTALL_URL="$INSTALL_URL" BRANCH="$BRANCH" REPO="$REPO" APPS="$APPS" bash

⚙️ Executando

Para operar o cluster kubernetes use o binário do k3s sob o sudo, por exemplo sudo k3s kubectl get pods -A ou copie as configurações do k3s para seu usuário:

sudo cp /etc/rancher/k3s/k3s.yaml ~/.kube/k3s-config.yaml
sudo chown $(id -u):$(id -g) ~/.kube/k3s-config.yaml
export KUBECONFIG=~/.kube/k3s-config.yaml

🌐 Acesso

Adicione o IP do loadbalancer e os nomes dos serviços utilizados no seu /etc/hosts, como por exemplo:

echo "$(kubectl get svc -A -l app.kubernetes.io/name=traefik -o jsonpath='{.items[0].status.loadBalancer.ingress[0].ip}') argo.homelab grafana.homelab prometheus.homelab alertmanager.homelab" | sudo tee -a /etc/hosts > /dev/null

A senha do usuário admin do argocd pode ser obtida com o comando:

kubectl -n argocd get secret argocd-initial-admin-secret -o jsonpath="{.data.password}" | base64 -d

Use a URL https://argo.homelab/

🖇️ Colaborando

Por favor, leia o CONTRIBUTING.md para obter detalhes sobre o nosso código de conduta e o processo para nos enviar pedidos de solicitação.

📌 Versão

Nós usamos SemVer para controle de versão. Para as versões disponíveis, observe as tags neste repositório.

✒️ Autores

Mencione todos aqueles que ajudaram a levantar o projeto desde o seu início

• Andreyev -
• Marcelo Pires -
• Douglas Esteves -
• Manassés Souza -
• Bruno Lima -

Você também pode ver a lista de todos os colaboradores que participam deste projeto.

📄 Licença

Este projeto está sob a licença (GPL v3) - veja o texto original em LICENSE.md para detalhes.

🎁 Expressões de gratidão

• Conte a outras pessoas sobre este projeto 📢;
• Convide alguém da equipe para um café ☕;
• Um agradecimento publicamente 🫂;
• etc.

---

⌨️ com ❤️ por LHC 😊