https://github.com/lhc/infra
Homelab do LHC gerenciado via GitOps
https://github.com/lhc/infra
gitops kubernetes
Last synced: 3 months ago
JSON representation
Homelab do LHC gerenciado via GitOps
- Host: GitHub
- URL: https://github.com/lhc/infra
- Owner: lhc
- License: gpl-3.0
- Created: 2025-01-25T01:34:48.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2026-01-12T23:08:54.000Z (5 months ago)
- Last Synced: 2026-01-13T03:11:03.467Z (5 months ago)
- Topics: gitops, kubernetes
- Language: Shell
- Homepage:
- Size: 56.6 KB
- Stars: 13
- Watchers: 13
- Forks: 8
- Open Issues: 13
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE.md
- Codeowners: CODEOWNERS
Awesome Lists containing this project
README
# 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](https://docs.k3s.io/quick-start#install-script)
- [helm](https://helm.sh/docs/intro/install/#from-script)
- [terraform](https://developer.hashicorp.com/terraform/install?product_intent=terraform#linux)
- [kubectl](https://kubernetes.io/pt-br/docs/tasks/tools/install-kubectl-linux/#instale-o-bin%C3%A1rio-kubectl-no-linux-usando-o-curl)
- [git](https://git-scm.com/downloads)
### 🔧 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](https://github.com/lhc/infra/blob/main/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](http://semver.org/) para controle de versão. Para as versões disponíveis, observe as [tags neste repositório](https://github.com/suas/tags/do/projeto).
## ✒️ 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](https://github.com/lhc/infra/graphs/contributors) que participam deste projeto.
## 📄 Licença
Este projeto está sob a licença (GPL v3) - veja o texto original em [LICENSE.md](https://github.com/lhc/infra/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](https://lhc.net.br/) 😊