Page:
Guia de Instalação
Clone
5
Guia de Instalação
renato.ramos edited this page 2026-03-26 19:38:48 +00:00
🚀 AttendanceSystem — Instalação
Pré-requisitos
Antes de começar, certifique-se de que a máquina possui:
| Ferramenta | Como instalar |
|---|---|
| Docker + Docker Compose v2 | https://docs.docker.com/engine/install/ |
| Git | sudo apt install git |
| Make | sudo apt install make |
Instalar o Docker e o Docker Compose v2
# Atualizar pacotes
sudo apt-get update && sudo apt-get upgrade -y
# Instalar dependências
sudo apt-get install -y ca-certificates curl gnupg lsb-release
# Adicionar chave GPG oficial do Docker
sudo install -m 0755 -d /etc/apt/keyrings
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg
sudo chmod a+r /etc/apt/keyrings/docker.gpg
# Adicionar repositório do Docker
echo \
"deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.gpg] https://download.docker.com/linux/ubuntu \
$(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
# Instalar Docker Engine + Docker Compose
sudo apt-get update
sudo apt-get install -y docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin
# Adicionar o utilizador atual ao grupo docker (evita usar sudo)
sudo usermod -aG docker $USER
# Verificar instalação
docker --version
docker compose version
# 1. Criar o grupo docker manualmente
sudo groupadd docker
# 2. Adicionar o utilizador ao grupo
sudo usermod -aG docker $USER
# 3. Aplicar na sessão atual
newgrp docker
# na pasta que será escolhida pra rodar o comando, setar permissão para o usuario:
sudo chown seu_user:seu_user ~/pasta_escolhida/
#sudo chown academy:academy ~/seventh/
Instalação (recomendada)
Execute o comando abaixo no terminal da máquina de destino:
bash <(curl -fsSL "https://git.seventh.com.br/seventh.p7/attendance-system.install/raw/branch/main/install.sh")
O instalador irá:
- ✅ Verificar as dependências
- 📥 Baixar os arquivos do projeto
- ❓ Fazer perguntas sobre IPs e portas da sua rede
- ⚙️ Gerar os arquivos de configuração automaticamente
- 🚀 Subir o ambiente
Instalação manual (alternativa)
Se preferir configurar manualmente:
# 1. Clone o repositório
git clone https://git.seventh.com.br/seventh.p7/attendance-system.install.git
attendance-system.install
cd attendance-system.install
# 2. Edite as configurações
nano .env.prod # ajuste IPs e portas
# 3. Suba o ambiente
make install
Comandos disponíveis
| Comando | Descrição |
|---|---|
make install |
Sobe todo o ambiente (infra + app) |
make update |
Remove imagens do projeto e sobe novamente |
make infra |
Sobe apenas o banco de dados (MongoDB) |
make app |
Sobe apenas a aplicação |
make nuke-project |
Remove containers, volumes e imagens do projeto |
make nuke |
⚠️ Remove tudo (containers, volumes, imagens) |
Atualização
Para atualizar o sistema para uma nova versão (quando usada instalção recomendada):
# Acessar pasta da instalação
git pull # baixa novos arquivos
make update # limpa imagens antigas e sobe com a versão atualizada
Suporte
Em caso de problemas, entre em contato com o suporte.