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á:

  1. Verificar as dependências
  2. 📥 Baixar os arquivos do projeto
  3. Fazer perguntas sobre IPs e portas da sua rede
  4. ⚙️ Gerar os arquivos de configuração automaticamente
  5. 🚀 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.