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.
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.
De que coisas você precisa para instalar o software e como instalá-lo?
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
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
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/
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.
Nós usamos SemVer para controle de versão. Para as versões disponíveis, observe as tags neste repositório.
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.
Este projeto está sob a licença (GPL v3) - veja o texto original em LICENSE.md para detalhes.
- Conte a outras pessoas sobre este projeto 📢;
- Convide alguém da equipe para um café ☕;
- Um agradecimento publicamente 🫂;
- etc.
⌨️ com ❤️ por LHC 😊