Compartilhamento

Repositório com código fonte do projeto Compartilhamento(TownSQ)

Softwares / runtimes necessários

JDK 11
Docker e Docker-Compose
Git
Como editor de código, recomenda-se o uso do IntelliJ (pode-se usar o VSCode também)

Se você estiver usando o IntelliJ, recomenda-se instalar o plugin Lombok. Caso use o VSCode, instale os seguintes plugins.

vscode-lombok
Java Extension Pack
Spring Boot Tools
thymeleaf

IMPORTANTE: Se você estiver no Windows, utilize o comando ./mvnw.cmd no lugar de ./mvnw

Processo de instalação

Clonar o projeto:

Execute o comando a seguir em um prompt de comand / terminal dentro de uma pasta de sua escolha (recomenda-se o uso da pasta $HOME).

git clone http://tools.ages.pucrs.br/compartilhamento/compartilhamento.git

Executar o projeto

Em um primeiro momento, abra o terminal da raíz do projeto e rode o comando

./mvnw package

Se você preferir, abra o diretório do projeto no IntelliJ e aguarde as dependências do Maven e o classpath ser atualizado. Isso poder demorar alguns bons minutos.

Após a instalação das dependências e plugins do Maven, vamos subir os containers do Docker. Para isso, novamente na raiz do projeto, execute o seguinte comando

docker-compose up -d

Com isso, podemos rodar as migrações do banco de dados e executar a aplicação Spring Boot.

Na raíz do projeto, execute o comando

./mvnw liquibase:update

Em seguida, para executar a aplicação, rode o seguinte comando

./mvnw spring-boot:start

No IntelliJ, esses comandos podem ser executados utilizando a interface gráfica do programa. O mesmo pode ser feito no VSCode.

Limpeza das classes compiladas

Para limpar as classes compiladas, execute ./mvnw clean

IMPORTANTE

Sempre que for desenvolver código novo, utilize uma nova branch. Para isso, rode git checkout -b <nome-da-branch>

ERROR PORT:5432 IN USE

No linux, use o comando 'sudo lsof -t -i :5432' e depois 'sudo kill '. PID é o numero que vai aparecer após o primeiro comando. No Windows, abra o gerenciador de tarefas do windows e finaliza o Postgress.

ARQUIVOS FALTANTES

Os arquivos de configuração / docker-compose não estão sendo rastreados pelo git. Assim, é preciso fazer o download deles e colocar nas pastas do projeto. O docker-compose.yaml fica na raíz do projeto e os outros arquivos na pasta src/main/resources.

ignored-files.zip

Outras referências

Você pode ver mais comandos e referências nos seguintes links:

gabrierabelo / compartilhamento Goto Github PK