Skip to content

First version

Choose a tag to compare

View all tags
@kascat kascat released this 08 Aug 19:16
· 13 commits to main since this release
1.0
5d84811

Projeto base

O projeto base possui a estrutura inicial para inicialização de um projeto.

Setup e automações

Abaixo se encontram os passos para SETUP e demais comandos disponíveis.

Ambiente de desenvolvimento

OBS: É necessário que já estejam previamente instalados Docker e Docker compose

A estrutura do projeto após o setup está demonstrada abaixo:

>
  | > backend
  | > frontend
  | > database (caso possua)

O comando abaixo realiza o setup no ambiente local:

./setup-local.sh

O comando abaixo é utilizado para iniciar o projeto:

./start-local.sh

O comando abaixo é utilizado para parar a execução do projeto:

./stop-local.sh

Para executar comandos dentro dos containers backend e frontend execute os respectivos scripts
abaixo seguido do comando desejado, como no exemplo: ./container-backend php artisan migrate:status

./container-backend [comando]
./container-frontend [comando]

O comando abaixo pode ser utilizado para atualizar o backend e frontend com a branch dev.

./git-pull-local.sh

Ambiente de Homolog

Para realizar o setup no ambiente de homolog os itens abaixo precisam ser seguidos:

  • Instalação de Docker e Docker compose
  • Criação de chaves SSH para operações de cada repositório Git
  • Adição no Git das chaves SSH criadas
  • Mapeamento dos repositórios para as respectivas chaves SSH em ~/.ssh/config
  • Clone dos repositórios backend e frontend (Caso seja repositório individual) dentro do diretório principal

O comando abaixo realiza a configuração dos containers no ambiente de homolog:

./setup-homolog.sh

Após a execução do script setup-homolog.sh é necessário realizar mais alguns passos para concluir a configuração:

  • Configurar NGINX do servidor para as portas dos containers backend e frontend
  • Configurar .env backend para as credenciais do BD (Caso necessário)
  • Configurar .env frontend para a URL da API
  • Restartar containers

O comando abaixo pode ser utilizado para execução do deploy em homolog,
podendo passar as flags --all, --backend ou --frontend realizando o deploy do respectivo ambiente:

deploy.sh --all

OBS: O arquivo .env contém as credenciais para criação da base de dados, as mesmas credenciais definidas
nesse arquivo devem ser usadas no .env do backend para conexão com a base. Além de variáveis gerais dos containers.

Criando primeiro usuário

Para criar o primeiro usuário da base pode ser executado o script abaixo:

./first-user.sh

Ou execute manualmente os 3 comandos a seguir:

./container-backend php artisan ti

$permission = Permission::create(["name" => "Administrador"])

User::create(["name"=>"The first","email"=>"email@mail.com","password"=>bcrypt("projeto"),"permission_id"=>$permission->id])

Informações gerais

Arquivo pipe

O arquivo pipe na pasta backend é um arquivo pipe/FIFO utilizado no projeto para execução de shell script
a partir do php que utiliza o usuário 'nginx', diretamente no container como usuário 'root'.

Para isso o arquivo exec-pipe.sh deve ser executado (terminal ou cron) para começar ouvir
os scripts que forem chamados.

Para entender melhor esse processo vide exec-pipe.sh e pesquise por "Arquivos FIFO".

Assets 2
Loading