Database Sync - Celso Nery

English README

Sobre DB Sync

O aplicativo DB Sync nasceu porque a equipe de desenvolvimento precisava transferir dados dos bancos de dados prod para dev. Este aplicativo descarta, cria e transfere dados do database-name para database-name_dev, se _dev não existir, o aplicativo o criará.

Requisitos

PHP 8.2+

• Pacotes
  zip unzip libzip libzip-dev libpq-dev libpng-dev oniguruma-dev git lynx nodejs npm postgresql-client
  

• PHP Extensões
  php82-bcmath php82-bz2 php82-calendar php82-exif php82-gettext php82-opcache php82-pcntl php82-zip php82-pgsql
  

Instalação

Este aplicativo está disponível via Github/Gitlab

git clone [email protected]/celsonery/db-sync.git

ou

git clone https://github.com/celsonery/db-sync.git

• Primeiro você deve criar as variáveis de ambiente
  export PGHOST=<ip-do-servidor-postgresql>
  export PGUSER=<usuario-do-postgresql>
  export PGPASSWORD=<senha-do-usuario-postgresql>
  

• Execute estes comandos na pasta do aplicativo em um terminal ou prompt de comando
  composer update
  php artisan key:generate
  php artisan optimize
  php artisan serve
  

> Agora você deve abrir a url informada pelo comando acima.

Como rodar no Docker

• Contrua a imagem Docker
  docker build -t <nome-da-imagem>:<versao-da-imagem> -f docker/dockerfile
  

• Rodando o conteiner Docker
  docker run -itd --rm \
  --name <nome-do-conteiner> \
  -p <porta-local>:8000 \
  -e PGHOST=<ip-do-servidor-postgresql> \
  -e PGUSER=<usuario-do-postgresql> \
  -e PGPASSWORD=<senha-do-usuario-postgresql> \
  <nome-da-imagem-docker-criada-anteriormente>
  

  > Agora você deve abrir a url http://localhost:8000 no seu browser

Para rodar os testes automatizados

php artisan test

Gerar relatório da cobertura de tests

XDEBUG_MODE=coverage php artisan test --coverage-html reports/

Você pode ver a cobertura de testes na pasta reports

/reports

Modificações

Por favor veja em CHANGELOG para mais detalhes.

Contribuindo

Obrigado por considerar contribuir para a DB Sync! O guia de contribuição pode ser encontrado na documentação do Contribute.

Vulnerabilidades de Segurança

Se você descobrir uma vulnerabilidade de segurança no DB Sync, envie um e-mail para Celso Nery via [email protected]. Todas as vulnerabilidades de segurança serão prontamente tratadas.

Licença

O DB Sync é um software de código aberto licenciado sob a licença MIT.