Projeto de extensão realizado pelo IFSudesteMG para a implementação da Juizforana - Hemeroteca Digital de Juiz de Fora

Ciclos de desenvolvimento

Criação de feature branches

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

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

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

Dar push apenas nos arquivos relativos ao trabaho na feature branch

Não add arquivos de configuração

Pushing uma branch local para remote:

git push -u origin <branch-name>

Pull requests e merging

Após dar o merge de uma feature branch em development é NECESSÁRIO APAGAR a feature branch criada.

Após dar o merge da branch development na branch master, 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/GioSF/biblioweb.git
   • cd biblioweb
   • 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/biblioweb.conf
   • sudo nano /etc/apache2/sites-available/biblioweb.conf
   • Adicionar à biblioweb.conf
   • <VirtualHost *:80>
 ServerName (adicionar Public IPv4 DNS ou domínio)
 ServerAdmin webmaster@thedomain.com
 DocumentRoot /var/www/html/biblioweb/public
  <Directory /var/www/html/biblioweb>
   AllowOverride All
  </Directory>
 ErrorLog ${APACHE_LOG_DIR}/error.log
 CustomLog ${APACHE_LOG_DIR}/access.log combined
</VirtualHost>
     
   • sudo a2dissite 000-default.conf
   • sudo a2ensite biblioweb.conf
   • sudo a2enmod rewrite
   • sudo systemctl restart apache2
8. Definir permissões
   • cd /var/www/html/biblioweb/storage execute: sudo mkdir -p framework/{sessions,views,cache}
   • chmod -R 775 sessions, views, cache
   • No diretório biblioweb/ 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/biblioweb/storage/framework/cache/data
9. Criar banco de dados
   • Acessar terminal do mysql
   • CREATE DATABASE biblioweb;
   • No diretório biblioweb/ 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