====== AWS & CI/CD sample Project ====== This page includes a test project about AWS & DevOps. This document is intended for the bSup development team. If you are interested in AWS solutions, please contact us through the AWS Services page. ===== AWS Sample Project ===== This is a simple test which is a sample from a group of our AWS deployments. Our team mostly implements web applications. So the test is about deployment of a web application to Elastic Beanstalk server. ==== App Info ==== The app to be installed on the AWS is built with, * [[https://laravel.com/docs/5.5|Laravel]] - The PHP Framework * [[https://vuejs.org/|vue.js]] - Progressive framework for building user interfaces * [[https://getbootstrap.com/|Bootstrap]] - Front-end component library ==== Deployment ==== //Requirements//: * Nginx * PHP >= 7.0 * MySQL >= 5.7 * NPM * Supervisor //Installation//: 1. Installed php modules must be:

php-common php-fpm php-mbstring php-tokenizer php-xml php-curl php-mysql php-zip php-bcmath php-json

2. Create a database and add a guideline of how to get DB credentials 3. Import a SQL file into the created DB 4. In DB change the id to 3 in users table where the id is 1 5. Copy env variables file called .env from S3 or local storage. For the CI/CD sample project, please add secrets to GitHub for .env file 6. Run (composer is not pre-installed):

code@terminal:~$ composer install %%--%%optimize-autoloader

7. Then run (npm is not pre-installed):

code@terminal:~$ php artisan key:generate code@terminal:~$ php artisan passport:install code@terminal:~$ php artisan storage:link code@terminal:~$ php artisan optimize:config code@terminal:~$ npm install code@terminal:~$ npm run production

8. Setup appropriate permission using:

code@terminal:~$ sudo chgrp -R www-data storage bootstrap/cache code@terminal:~$ sudo chmod -R ug+rwx storage bootstrap/cache

9. Setup a Supervisor config and start it (Supervisor is not pre-installed):

[program:laravel-worker-aws] process_name=%(program_name)s_%(process_num)02d command=php /PATH_TO_PROJECT/artisan queue:work %%--%%tries=3 autostart=true autorestart=true user=root numprocs=4 redirect_stderr=true stdout_logfile=/PATH_TO_PROJECT/storage/logs/worker.log

10. Add a Cron entry:

* * * * * php /var/www/PATH_TO_PROJECT/artisan schedule:run %%>>%% /dev/null 2>&1

11. Setup SSL. We recommend AWS certificates instead of Let’s encrypt. We also expect a guideline, written in markdown format, to setup and config our servers. ===== CI/CD Sample Project ===== We use GitHub as our main Git repository system. Please write a GitHub action to automatically deploy the application to Elastic Beanstalk server. After implementing workflows please push them into a GitHub repository and send us the link. FYI future projects include ECS and possibly other container based deployments. ===== Useful Links ===== * Blog (coming soon) * [[https://docs.google.com/document/d/1wVV1VbQDMDi4USiaq6PC4ghBS_0idju9b9_eLU0vSns/|Related Google Docs]] (access is required) * AWS services (coming soon).