Skip to content

2. Instalação local usando Docker

Diego Marczal edited this page Mar 29, 2023 · 1 revision

Instalação local usando Docker

Este sistema contém alguns requisitos para rodar localmente:

1. Requisitos

Primeiro é preciso instalar os seguintes pacotes

docker
docker compose

2. Clonar o projeto

$ git clone https://github.com/MarczalTSIGP/SGTCC.git

3. Construção das imagens necessárias

$ docker compose build --no-cache

Esse comando criará a imagem Docker para os serviços especificados no arquivo docker-compose.yml, sem usar nenhuma camada em cache.

4. Instalação das dependências do Rails

$ docker compose run --rm web bundle install

O comando executa o serviço web por meio de um contêiner e roda o comando bundle install para instalar as dependências do projeto Ruby on Rails listadas no arquivo Gemfile.lock. A opção --rm usado nesse comando e no próximo, instrui o Docker a remover o contêiner após a execução, fazendo com que o ambiente fique mais limpo e também economiza espaço em disco.

5. Instalação das dependências de Javascript

$ docker compose run --rm web yarn install

O comando executa o serviço web por meio de um contêiner especificado no arquivo docker-compose.yml e executa o comando yarn install dentro do contêiner Docker.

6. Configurar as Variáveis de Ambiente para Aplicação

$ cp config/application.yml.example config/application.yml

Esse comando copia o arquivo application.yml.example que está dentro do diretório config e cria uma cópia com o nome application.yml, ou seja, um arquivo de configuração personalizado.

6. Configurar Mailtrap

Editar os seguintes campos do arquivo application.yml conforme necessidade do projeto, como nome do host, nome de usuário e senha baseados no MailTrap.

mailer.smtp.username: 'username'
mailer.smtp.password: 'password'

7. Criação do Banco de Dados

$ docker compose run --rm web bundle exec rails db:create

Cria o banco de dados especificado na aplicação Rails

8. Criação das tabelas

$ docker compose run --rm web bundle exec rails db:migrate

Executa as migrações do banco de dados na aplicação Rails

9. Criação dados necesssários para rodar aplicação

$ docker compose run --rm web bundle exec rails db:seed

Executa o arquivo de seed da aplicação Rails, que preenche o banco de dados com dados iniciais da aplicação

10. Levantar todos serviços

$ docker compose up web -d

Iniciar o serviços específicados no docker-compose.yml em segundo plano.

11. Popular a aplicação com registros fake

$ docker compose exec web bundle exec rails db:populate

11. Acessar a aplicação no navegador

Clone this wiki locally