Projeto de extensão realizado pelo IFSudesteMG para a implementação da Juizforana - Projeto Archeîon

Ciclos de desenvolvimento

Criação de feature branches

A branch main é versão de produção. Novas funcionalidades DEVEM ser desenvolvidas em feature branches criadas a partir da branch dev. Para criar uma branch local a partir de development:

git checkout -b <new-feature-branch-name> <dev>

Isso irá criar uma nova feature branch a partir de dev.

Dar git add e git push apenas nos arquivos relativos ao trabalho na feature branch

Não adicionar arquivos de configuração

Pushing uma branch local para remote:

git push -u origin <branch-name>

Pull requests e merging

O código implementado em feature branches passará por processo de code review

Após aprovação, será feito o merge da feature branch no dev. É NECESSÁRIO APAGAR a feature branch criada.

Após dar o merge da branch dev na branch main, NÃO apagar a branch development

Configuração do amazon-ec2/php/apache a partir do ssh:

1. Instalação do php:
   • sudo apt update
   • sudo apt install php7.4-cli
   • sudo apt install php-fpm php-json php-pdo php-mysql php-zip php-gd php-mbstring php-curl php-xml php-pear php-bcmath
   • sudo apt-get install libapache2-mod-php
2. Instalação do composer
   • Visitar https://getcomposer.org/download/
   • Copiar e executar as lihas de instalação
   • sudo mv composer.phar /usr/local/bin/composer (para instalção global do composer)
3. Instalação do laravel
   • composer global require laravel/installer
4. Instalação do mysql
   • sudo apt-get install mysql-server mysql-client
   • sudo mysql_secure_installation
   • CREATE USER 'algumusuario'@'localhost' IDENTIFIED BY 'algumapassword';
   • GRANT ALL PRIVILEGES ON * . * TO 'algumusuario'@'localhost';
5. Instalação do apache
   • sudo apt-get install apache2
   • sudo nano /etc/apache2/apache2.conf
   • Adicionar:
   • <Directory /var/www/> Options Indexes FollowSymLinks AllowOverride All Require all granted </Directory>
     
6. Baixar e instalar repositório
   • cd /var/www/html/
   • sudo git clone https://github.com/Archeion-Project/api.git
   • cd archeion
   • sudo composer install
   • sudo mkdir storage
   • sudo chmod -R 775 storage/
   • chmod -R 775 bootstrap/
   • sudo chmod -R 755 /var/www
7. Definir serviço
   • sudo cp /etc/apache2/sites-available/000-default.conf /etc/apache2/sites-available/archeion.conf
   • sudo nano /etc/apache2/sites-available/archeion.conf
   • Adicionar à archeion.conf
   • <VirtualHost *:80>
 ServerName (adicionar Public IPv4 DNS ou domínio)
 ServerAdmin webmaster@thedomain.com
 DocumentRoot /var/www/html/archeion/public
  <Directory /var/www/html/archeion>
   AllowOverride All
  </Directory>
 ErrorLog ${APACHE_LOG_DIR}/error.log
 CustomLog ${APACHE_LOG_DIR}/access.log combined
</VirtualHost>
     
   • sudo a2dissite 000-default.conf
   • sudo a2ensite archeion.conf
   • sudo a2enmod rewrite
   • sudo systemctl restart apache2
8. Definir permissões
   • cd /var/www/html/archeion/storage execute: sudo mkdir -p framework/{sessions,views,cache}
   • chmod -R 775 sessions, views, cache
   • No diretório archeion/ execute: composer install
   • Alterar bootstrap/cache/config.php session array: de 'driver' => 'file' para 'driver' => 'cookie'
   • sudo systemctl restart apache2
   • sudo mkdir /var/www/html/archeion/storage/framework/cache/data
9. Criar banco de dados
   • Acessar terminal do mysql
   • CREATE DATABASE archeion;
   • No diretório archeion/ execute: composer install
   • Alterar bootstrap/cache/config.php session array: de 'driver' => 'file' para 'driver' => 'cookie'
   • sudo systemctl restart apache2

Debug tools

• cd /etc/apache2 | apache2ctl configtest
• teste