Uma ferramenta que permite o gerenciamento de imagens e containers para ser usada no navegador, utiliza a API do Docker para executar todas suas funcionalidades.

• Imagem

  • Baixar uma
  • Listar todas
  • Visualizar uma
  • Apagar todas
  • Apagar uma

• Container

  • Executar um
  • Parar um
  • Iniciar um
  • Reiniciar um
  • Apagar todos
  • Apagar um

• Docker Engine v19.03 (mínimo)
• Docker Compose
• Editor de texto qualquer
• Git
• Python v3.9 (não é garantido o funcionamento em versões anteriores)

⚠ Avisos

Todos comandos abaixo estão considerando que seu terminal esteja na pasta raiz do projeto. Ou seja, onde está este README.

Caso esteja no Windows, utilize o cmd pois todos comandos foram usados apenas nele.

git clone https://github.com/NathanReis/BaleiaAzul.git

Faça uma cópia do arquivo .env.example dentro do diretório api.

cd api

cp .env.example .env

cd api

copy .env.example .env

Ele contém todas variáveis de ambiente usadas pela API e pelos containers.

Edite o arquivo .env que foi gerado passando os valores das seguintes varáveis:

• DOCKER_API_HOST
• DB_USERNAME
• DB_PASSWORD

docker-compose up -d

Quando subir os container, os seguintes serviços estarão funcionando:

• Grafana: A aplicação responsável pelos dashboards das estatisticas dos containers.
• MongoDB: Responsável por armazenar os dados históricos dos containers.
• Mongo Express: Uma interface WEB para gerenciamento do MongoDB.
• NGINX: O servidor WEB que irá cuidar do front-end.

cd api

python3 -m venv venv
. venv/bin/activate

python3 -m ensurepip --upgrade
pip install -r requirements.txt

flask run

cd api

py -3 -m venv venv
venv\Scripts\activate

venv\Scripts\python.exe -m ensurepip --upgrade
pip install -r requirements.txt

flask run

Para auxiliar no consumo dela, foi deixado do arquivo de sua collection dentro do diretório api, ele se chama ApiCollection.json.

Obs.: Após iniciar a API, o terminal onde os comandos foram executados ficará ocupado.

cd api

. venv/bin/activate
python3 save_containers_stats_job.py

cd api

venv\Scripts\activate
venv\Scripts\python.exe save_containers_stats_job.py

Este script cria um job que fica a cada 10 segundos consultando os status de todos containers e fazendo a persistência dos mesmos no MongoDB.

Obs.: Após iniciar o script, o terminal onde os comandos foram executados ficará opucado.

💥 Tudo pronto para uso 💥

• Porta 80 (WEB): O front-end feito utilizando HTML, CSS, JavaScript básico
• Porta 3000 (WEB): O dashboard feito utilizando o Grafana
• Porta 5000 (API): A API para gerenciamento das imagens e containers
• Porta 8081 (WEB): O Mongo Express para gerenciamento do banco via interface WEB
• Porta 27017 (Serviço): O MongoDB utilizado para armazenar os dados históricos

• 🎬 YouTube > Funcionamento