Wallogit.com
2017 © Pedro Peláez
script deployer
GIT/SVN deployer for Yii 2 apps.
humandevice/deployer
GIT/SVN deployer for Yii 2 apps.
- Thursday, August 17, 2017
- by bizley-code
- Repository
- 8 Watchers
- 2 Stars
- 65 Installations
- Shell
- 0 Dependents
- 0 Suggesters
- 1 Forks
- 0 Open issues
- 17 Versions
- 2 % Grown
The README.md
deployer
Deploys SVN/GIT version of Yii 2 project, (*1)
SYNOPSIS
deployer -d TAG [-v] [-s] [-e ENV] deployer -r TAG [-v] [-e ENV] deployer -dev [-v] [-s] [-e ENV] deployer -b BRANCH [-v] [-s] [-e ENV] deployer -h deployer -c deployer -u
LOCAL INSTALLATION
Copy deployer to the project folder., (*2)
GLOBAL INSTALLATION
Run, (*3)
composer global require humandevice/deployer
and then, (*4)
composer run-script post-update-cmd -d COMPOSER_VENDOR/humandevice/deployer
where COMPOSER_VENDOR is the vendor composer folder. You can find it by running composer global config vendor-dir --absolute., (*5)
GLOBAL UPDATE
Run, (*6)
deployer -u
CONFIGURATION
Run deployer -c to generate configuration file and set all variables there., (*7)
DESCRIPTION
Deploys the target TAG version of Yii 2 project or rollbacks to the target TAG version.
Creates the releases and composer folders. Deployed version is stored in the releases
folder under the TAG name. Composer folder stores the vendor folder with composer
dependencies. TAG version is SVN-imported or GIT-cloned using provided credentials.
Script deletes environments folder and runs migration., (*8)
If environment is set to Production composer runs with option --no-dev --optimize-autoloader., (*9)
Deployed or rollbacked version is symlinked to the Apache host target folder., (*10)
| option | alias | description |
|---|---|---|
| -d TAG | --deploy TAG | deploy TAG version |
| -r TAG | --rollback TAG | rollback to TAG version |
| -dev | deploy development version | |
| -b BRANCH | --branch BRANCH | deploy development version from BRANCH branch (no starting and ending trailers) |
| -v | --verbose | runs the script in verbose mode where output of svn, composer and init is visible |
| -s | --skipmigrate | skips the migration process |
| -e ENV | --env ENV | sets environment name ENV for init |
| -h | --help | help screen |
| -c | --config | creates (overwrites) deployer.cfg file |
| -u | --update | updates deployer using composer in global mode |
CONFIGURATION
Configuration can be stored in separate file deployer.cfg (in the same folder)., (*11)
| name | description |
|---|---|
| HOST | Project folder name, this is virtual host target folder. |
| ENV | Environment name for Yii 2 init command (can be set with -e flag also). |
| REPO_TYPE | Repo type: GIT or SVN. |
| REPO_URL | URL of the repo server. |
| REPO_USER | Name of the repo user with read rights. |
| REPO_PASS | Repo password for REPO_USER. |
| DEV_BRANCH | Repo branch for development releases (no starting and ending trailers). |
| RIGHTS | Optional folder rights to be set (use chown syntax owner:group). |
| PROJECT | Project name (for display purposes only). |
EVENTS
The following events are available for additional scripts:, (*12)
- BEFORE_START
- AFTER_END
- BEFORE_DOWNLOAD
- AFTER_DOWNLOAD
- BEFORE_DEPLOY
- AFTER_DEPLOY
- BEFORE_DEPLOYDEV
- AFTER_DEPLOYDEV
- BEFORE_INIT
- AFTER_INIT
- BEFORE_MIGRATE
- AFTER_MIGRATE
- BEFORE_UPDATE
- AFTER_UPDATE
- BEFORE_ROLLBACK
- AFTER_ROLLBACK
- BEFORE_INSTALL
- AFTER_INSTALL
- BEFORE_SWITCH
- AFTER_SWITCH