jalogut/magento2-deployer-plus

Magento 2 deployment tool based on deployer.org

Tuesday, July 24, 2018
by jalogut
Repository
7 Watchers
56 Stars
1,130 Installations

PHP
0 Dependents
0 Suggesters
11 Forks
0 Open issues
23 Versions
639 % Grown

The README.md

Magento 2 Deployer Plus

, _(*1)

Reliable fully-automated deployments tool for Magento 2.
Zero downtime deployments on Magento versions >= 2.2
Automating your deployments is as easy as defining the servers where you want to deploy to.

Motivation

This project aims to offer a common solution for fully-automated deployments on all versions of Magento 2. This tool uses the well known Deployer and adds specific recipes for each Magento 2 version., _(*2)

Important Features

Deployer code syntax
Super easy setup
Deploy to multiple servers
Zero Downtime (only Magento >= 2.2)
Build and Deploy artifacts (only Magento >= 2.2)
Secure rollbacks (only Magento >= 2.2)

Installation

composer require "jalogut/magento2-deployer-plus"

Setup

Magento >= 2.1

cp <vendor_dir>/jalogut/magento2-deployer-plus/deploy.php.sample_2_1 deploy.php

Magento >= 2.2

cp <vendor_dir>/jalogut/magento2-deployer-plus/deploy.php.sample_2_2 deploy.php

Magento >= 2.2.5

cp <vendor_dir>/jalogut/magento2-deployer-plus/deploy.php.sample_2_2_5 deploy.php

Usage

Git deploys:

<bin_dir>/dep deploy [<stage>]

Build artifact deploys: (only Magento >= 2.2)

<bin_dir>/dep build
<bin_dir>/dep deploy-artifact [<stage>]

Disclaimer

Build command

Build command can only be used if config propagation is properly configured. See Magento DevDocs:, _(*3)

Propagate config accross systems

Also check app:config:dump issue and workaround here:, _(*4)

Troubleshooting

Js translations missing (magento versions >=2.1.3 <2.2.1)

Problem: Known Magento issue when executing setup:static-content:deploy for several languages., _(*5)
Github Issues:, _(*6)
- 7862
- 10673

Solution: Until that gets fixed in 2.2.1, the only workaround is to execute setup:static-content:deploy individually for each language:, _(*7)

// deploy.php
task('files:static_assets', '
    {{bin/php}} {{magento_bin}} setup:static-content:deploy en_US {{static_deploy_options}}
    {{bin/php}} {{magento_bin}} setup:static-content:deploy de_CH {{static_deploy_options}}
    {{bin/php}} {{magento_bin}} setup:static-content:deploy fr_FR {{static_deploy_options}}
');

Compilation error

Solution: Increase php memory_limit configuration to 728M o 1024M

Static deploy error when setting a new template (if config propagation is not used)

Problems:
- [LogicException] Unable to load theme by specified key: 'Template'
- @variable is undefined in file
Reason: If a new template is set, running setup:upgrade is required before executing setup:static-content:deploy
Solution: Skip setup:static-content:deploy first time you deploy the new template:, _(*8)
1. Temporary disable task files:static_assets, _(*9)
```
// deploy.php
task('files:static_assets')->onRoles('Skip');
```
2. Perform a new release, _(*10)
3. Enable back files:static_assets on your deploy.php file, _(*11)
  - Remove task('files:static_assets')->onRoles('Skip');
4. Manually execute files:static_assets, _(*12)
```
<bin_dir>/dep files:static_assets [<stage>]
```
After that, future deployments will work without issues, _(*13)

Prerequisites

PHP >= 7.0.8
MAGENTO >= 2.1

ChangeLog

CHANGELOG.md, _(*14)

Developers

Licence

GNU General Public License, version 3 (GPLv3), _(*15)

Copyright

The Versions

24/07 2018

dev-master

9999999-dev

Magento 2 deployment tool based on deployer.org

library magento2-deployer-plus

Magento 2 deployment tool based on deployer.org

jalogut/magento2-deployer-plus

The README.md

Magento 2 Deployer Plus

Motivation

Important Features

Installation

Setup

Magento >= 2.1

Magento >= 2.2

Magento >= 2.2.5

Usage

Git deploys:

Build artifact deploys: (only Magento >= 2.2)

Disclaimer

Build command

Troubleshooting

Js translations missing (magento versions >=2.1.3 <2.2.1)

Compilation error

Static deploy error when setting a new template (if config propagation is not used)

Prerequisites

ChangeLog

Developers

Licence

Copyright

The Versions

dev-master

The Requires

The Development Requires

by Juan Alonso

dev-develop

The Requires

The Development Requires

by Juan Alonso

2.2

The Requires

The Development Requires

by Juan Alonso

2.1

The Requires

The Development Requires

by Juan Alonso

dev-fix-shared-caches

The Requires

The Development Requires

by Juan Alonso

dev-update-require-path

The Requires

The Development Requires

by Juan Alonso

2.0

The Requires

The Development Requires

by Juan Alonso

1.1.3

The Requires

The Development Requires

by Juan Alonso

dev-fixes-improvements

The Requires

The Development Requires

by Juan Alonso

1.1.2

The Requires

The Development Requires

by Juan Alonso

1.1.1

The Requires

by Juan Alonso

1.1

The Requires

by Juan Alonso

1.0.8

The Requires

by Juan Alonso

1.0.7

The Requires

by Juan Alonso

1.0.6