Merge pull request #31 from aurelijusb/deploy-improvements

Deploy improvements

.deploy/build.sh

@@ -0,0 +1,17 @@
+#!/usr/bin/env bash
+
+# This script prepares all dependent files to be deployed to server as a single .tar file
+# This script intended to be executed in Jenkins CI, but likelly to be extended by you.
+
+set -e # Stop on error
+set -x # Show commands being executed
+
+# Downloading dependencies and building frontend
+composer install --no-dev --no-scripts --no-interaction --optimize-autoloader
+yarn
+yarn run encore production
+
+# <-- This is a good place to add custom commands for your project
+
+# Generating deployment artifact (one file with everything you need to be deployed on the server)
+tar czf project.tar.gz * --exclude="node_modules" --exclude=".git" --owner 0 --group 0 --anchored

.deploy/deploy.sh

@@ -0,0 +1,12 @@
+#!/usr/bin/env bash
+
+# This script deploys to *.projektai.nfqakademija.lt
+# This script is intended to be used in Jenkins CI, where Ansible is installed
+
+set -e # Stop on error
+set -x # Show commands being executed
+
+# .deploy/ansible_hosts will be generated in Jenkins CI
+
+# Use Ansible to SSH to server, copy files and finish deployment there
+ansible-playbook -i .deploy/ansible_hosts .deploy/deploy_playbook.yaml

.deploy/playbook.yaml → .deploy/deploy_playbook.yaml

@@ -1,13 +1,17 @@
 ---
 
+# This is Ansible playbook (configuration), used by .deploy/deploy.sh
+# It is used to automate common deployment tasks.
+# (E.g. copy to server, change deployed version, merge configs, warmup framework)
+
 - hosts: all
   vars:
       deployment:
           deploy_path: "/home/{{ ansible_user_id }}"
           archive_path: ../project.tar.gz
-          linked_files:
+          linked_files: # <-- Common place to add your files, that should be reused between deployments
               - .env
-          linked_directories:
+          linked_directories: # <-- Common place to add your files, that should be reused between deployments
               - var/log
 
   tasks:
@@ -55,7 +59,7 @@
             state: link
         with_items: "{{ deployment.linked_directories + deployment.linked_files }}"
 
-      - name: Warm up application cache
+      - name: "Warm up application cache" # <-- Symfony specific task, to be ready for new version
         shell: bin/console cache:warmup --env=prod --no-debug
         args:
             chdir: "{{ deploy_helper.new_release_path }}"

README.md

@@ -96,6 +96,26 @@ scripts/logs.sh
 scripts/clean-and-start-fresh.sh
 ```
 
+### Dažniausiai užduodami klausimai
+
+* **Kaip įkelti savo pakeitimus į LIVE?**
+Jei viskas gerai sukonfiguruota, užteks sudėti pakeitimus į `master`.
+Jei neveiks, plačiau žr. [įkėlimo į serverį dokumentacijoje](https://github.com/nfqakademija/docker/blob/master/docs/deploy-project.md)
+
+* **Kaip prisijungti prie duomenų bazės su savo mėgstamu MySql redagtoriumi?**
+Trumpai: `scripts/mysql.sh` atspausdina visus prisijungimus.
+Plačiau žr. [MySql GUI dokumentacijoje](https://github.com/nfqakademija/docker/blob/master/docs/use-mysql-with-gui.md)
+
+* **Kaip pasileisti xDebug?**
+Trumpai: `./scripts/backend.sh /enable_xdebug.sh <TAVO_KOMPO_IP_ADRESAS>`
+Plačiau žr. [xDebug dokumentacijoje](https://github.com/nfqakademija/docker/blob/master/docs/setup-xdebug.md)
+
+* **Turių daugiau techninių klausimų?**
+Google ir StackOverflow yra geriausi tavo draugai.
+Nepavykus – kreipkis į savo mentorių. Jei jis nepadės,
+nukreips į atitinkamą lektorių arba pamokys `git blame`,
+kad žinotumei, kur kreiptis toliau. 
+
 ### Feedbackas
 
 Jeigu taip nutiktų, kad repositorijoje, projekto template ar instrukcijoje rastumėte klaidą, tai nesišnibždėkite vieni tarp kitų, o sukurkite "issue".