[descrição do repositório: ] Projeto que gerencia as informações de implementação e configuração do orquestrador de containers docker.
[descrição da relação das branch para o ambiente da aplicação: ] Essa relação indica qual será o ambiente alvo a depender da branch do versionamento.
| Branch | Ambiente |
|---|---|
| develop | Aplica no ambiente DSV |
| release/** | Aplica no ambiente HMG |
| pre-release/** | Aplica no ambiente STG |
| main | Aplica no ambiente PRD |
[descrição da estrutura do diretório: ] Essa estrutura descreve quais são os diretórios do projeto.
├── .github
│ └── workflows
│ └── script
│ └── manifest.sh
│ └── namespace.yml
│ └── secrets.yml
│ └── branch_default_rule.json
│ └── dependabot.yml
│ └── tag_default_rule.json
├── app
│ └── namespace
│ └── deployment.yml
│ └── secrets
│ └── deployment.yml
├── docs
│ └── CONTRIBUTING.md
│ └── CODE_OF_CONDUCT.md
│ └── PULL_REQUEST_TEMPLATE.md
└── README.md
[descrição da visão geral do projeto: ] Esse projeto tem a finalidade de documentar e padronizar o processo de instalação e configuração do servidor de gerenciamento a implementação, manutenção dos containers utilizados pelas aplicações.
[descrição do aplicativo: ] Segundo o site oficial da aplicação, o kubernetes é um gerenciador de implementação e configuração de containers baseado num estrutura declarativa através de um arquivo contendo as informações necessárias do container, proporcionando o versionamento da instalação, configuração e manutenção além da possibilidade de automatização.
[descrição do aplicativo: ] Segundo o site oficial da aplicação, o rancher é um software livre que administra os clusters kubernetes, fornece uma interface para o usuário administrar os clusters.
[relação das versões de aplicativos externos: ] A aplicação utiliza as seguintes versões:
| Software | Versão |
|---|---|
| Ubuntu | 24.04 |
| Docker | 27.5.1 |
| Rancher | 2.4.3 |
| Traefik | 1.7 |
| Longhorn | 0.8 |
[Relação dos requisitos necessários para concluir o tutorial: ] Os requisitos para prosseguir com a instalação e configuração são esses:
| Item | Descrição | Observação |
|---|---|---|
| 1 | 4 máquinas virtuais com 2/4 processadores e 6/8 gb de memória ram | Numa hospedagem cloud de preferência com a instalção do SO Ubuntu 24.04 |
| 2 | 1 domínio | Devidamente configurado num serviço de Hospedagem DNS |
[descrição da etapa instalação: ] Nessa seção é descrito as etapas necessárias para implentar a aplicação.
[relação das VM: ] As maquinas serão distribuidas da seguinte maneira:
| Item | Descrição |
|---|---|
| 1 | Rancher Server |
| 2 | node-1 |
| 3 | node-2 |
| 4 | node-3 |
[descrição do processo de instalação do rancher: ] Esse é o processo para instalação do aplicativo rancher na maquina virtual.
No terminal da maquina destinada para instalar o rancher execute os comandos abaixo:
sudo apt-get update && sudo apt install docker.io && y \
sudo docker run -d --name rancher-server --restart=always -v /opt/rancher:/var/lib/rancher -p 80:80 -p 443:443 rancher/rancher:v2.4.3[descrição do processo de instalação dos nodes: ] Esse é o processo para instalação do aplicativo node-rancher nas maquinas virtuais.
No terminal das maquinas destinada para instalar os nodes execute os comandos abaixo:
sudo apt-get update && sudo apt install docker.io && yNa interface do ranche configure o cluster, no final do processo será disponibilizado um script shell conforme exemplo abaixo:
sudo docker run -d --privileged --restart=unless-stopped --net=host -v /etc/kubernetes:/etc/kubernetes -v /var/run:/var/run rancher/rancher-agent:v2.4.3 --server https://rancher.{{dominio}}.site --token n6gmrf2mkbf77fm4w9znfdnfn5gxszrt5jjvn5vpl2q4525r6wn9rh --ca-checksum 9775da6d0427f86dfae6d5e6fc23b81f0f6925180937bc97c93c0cb8a1c88e7b --node-name node-1 --etcd --controlplane --worker
Execute o script fornecido nas vm destinadas aos nodes-rancher.
Important
O código fonte neste projeto não possui licença de uso.
É terminantemente proibido reproduzir, distribuir, alterar, utilizar engenharia reversa ou valer-se de qualquer tentativa de reverter ao seu código-fonte qualquer dos componentes que compõem o SOFTWARE, bem como utilizar subterfúgios para burlar a quantidade de usuários licenciados.