PHPackages mwltr/magedeploy2-base - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [DevOps & Deployment](/categories/devops) 4. / 5. mwltr/magedeploy2-base ActiveProject[DevOps & Deployment](/categories/devops) mwltr/magedeploy2-base ====================== Magento2 Deployment Setup using Robo and Deployer 3.0.0(8y ago)425.3k13[8 issues](https://github.com/mwr/magedeploy2-base/issues)MITPHP Since Feb 7Pushed 8y ago4 watchersCompare [ Source](https://github.com/mwr/magedeploy2-base)[ Packagist](https://packagist.org/packages/mwltr/magedeploy2-base)[ RSS](/packages/mwltr-magedeploy2-base/feed)WikiDiscussions master Synced yesterday READMEChangelogDependencies (4)Versions (13)Used By (0) MageDeploy2 Base ================ [](#magedeploy2-base) Magento2 Deployment Setup using Robo and Deployer. This is the base project you should base your deployments on. It provides an configurable and customizable setup to create push deployments for Magento2. Getting Started --------------- [](#getting-started) ### Requirements [](#requirements) - deployer/deployer - consolidation/robo - mwltr/magedeploy2 - netz98/n98-deployer ### Prerequisites [](#prerequisites) MageDeploy2 requires deployer and robo to be available on your system. Those Tools can be used globaly or added as a requirement to your local composer.json. The path to those tools can be configured in the magedeploy2.php Furthermore `gtar` ( gnu-tar) is required, it can be installed via brew ``` brew install gnu-tar ``` ### Installation [](#installation) Create a new deployment setup ``` composer create-project mwltr/magedeploy2-base ``` Robo needs to be installed using composer, otherwise the usage of custom Tasks is not available. See the Robo Documentation [Including Additional Tasks](http://robo.li/extending/#including-additional-tasks) ### Configure Deployment [](#configure-deployment) This tool assumes you have a git repository containing the magento composer.json. Furthermore your local build environment can clone said repository and download the Magento packages using composer. #### MageDeploy2 Configuration [](#magedeploy2-configuration) To configure the MageDeploy2 use the following command: ``` ./vendor/bin/robo config:init ``` It will guide you throught the most important configuration options. Don't worry you can edit the magedeploy2.php lateron. Next, run ``` ./vendor/bin/robo validate ``` to validate your build environment is setup. #### Setup local build environment [](#setup-local-build-environment) If you are done with the configuration in `magedeploy2.php`, you can see if your build environment can be setup. To do so run this command: ``` ./vendor/bin/robo deploy:magento-setup develop ``` You can use a different branch depending on your git repository setup. After the magento-setup has run successfully, you can now generate the assets by running the command: ``` ./vendor/bin/robo deploy:artifacts-generate ``` After this command is complete you should see the packages beneath `shop`. At this point we are sure that the local build setup is working and we can now continue with releasing our project. #### Deployer Configuration [](#deployer-configuration) After the Installation and general configuration of magedeploy2, you have to edit the `deploy.php` file to suit your needs. To evaluate we will create a local deployment target. To do so create run ``` cp config/local.php.dist config/local.php ``` and set the config values according to your local deploy target. Check the configuration in `deploy.php` and adjust it to your requirements. The default configurations and tasks are defined in `\N98\Deployer\Recipe\Magento2Recipe`. You can also have a look at all the configurations available in the [Deployer Documentation](https://deployer.org/docs/configuration) #### Setting up deploy directory tree [](#setting-up-deploy-directory-tree) After you are done with setting the configuration, you can now initialize the directory tree of the deploy target run ``` ./vendor/bin/dep deploy:prepare local ``` This will create the required directories on your local deploy target. #### Setting up deploy target (optional) [](#setting-up-deploy-target-optional) If you want to set up your deploy target as well you can use the command ``` ./vendor/bin/dep server:setup local ``` It will make an initial deployment to push your code to the deploy target. When this is done navigate to your local `deploy_path` and run the magento install command to setup the database. This might look something like this: ``` cd php bin/magento setup:install --db-host=127.0.0.1 --db-name=magedeploy2_dev_test_1_server --db-user=root --admin-email=admin@mwltr.de --admin-firstname=Admin --admin-lastname=Admin --admin-password=admin123 --admin-user=admin --backend-frontname=admin --base-url=http://magedeploy2_dev --base-url-secure=https://magedeploy2_dev --currency=EUR --language=en_US --session-save=files --timezone=Europe/Berlin --use-rewrites=1 ``` Now we have Magento database and configuration on our deploy target and are ready to continue with the final step. #### Deploying the project [](#deploying-the-project) At this point, you have setup the build environment and target environment and can finally start with the actual deployment. You can do so by running: ``` ./vendor/bin/dep deploy local ``` Congrats you have successfully setup your deployment pipeline and run the first deployment! CONFIGURATION FILES ------------------- [](#configuration-files) ### magedeploy2.php [](#magedeploy2php) This is the config file to set all parameters required for the deployment in general. The most common settings are to adjust on a project basis: - deploy/git\_url (path to your git repository) - deploy/themes (the themes that are to be generated) - build/db (the database settings for the build environment) A complete list of configuration options is provided further down. #### env [](#env) KeyDescriptionDefaultgit\_binPath to git executable/usr/local/bin/gitphp\_binPath to php executable/usr/local/bin/phptar\_binPath to tar executable/usr/local/bin/gtarcomposer\_binPath to composer executable/usr/local/bin/composer.phardeployer\_binPath to deployer executable/usr/local/bin/deployer.phar#### deploy [](#deploy) KeyDescriptionDefaultgit\_urlGit-Url to your repositorygit\_dirSub-directory on build server to clone the repository toshopapp\_dirIf you have your magento composer.json in another sub-dirthemesAn array of themes to compileassetsList of assets to generateclean\_dirslist of dirs to clean on each deployment#### build/db [](#builddb) Contains the database configuration being used to create and update a local magento setup during deployment. ### deploy.php [](#deployphp) This file is for the actual deployment of your project to the server. It has a basic setup that should work on most of the environments. You can adjust this to your needs as well. Leave out unwanted steps, add new ones, exchange existing ones, etc. The `deploy.php` uses the `N98\Deploy\Recipe\Magento2Recipe` as base recipe and overwrites some of the default settings. The server configuration is defined using the `config/*.php` files. CUSTOM PROJECT CHANGES ---------------------- [](#custom-project-changes) ### General [](#general) Replace all **ADD\_XXX** to suit your demands. Files to customize and check: ### .ssh/config [](#sshconfig) This deployment uses a native ssh client with a ssh-config file per default. It needs to be defined in `.ssh/config` and needs to match with your server configs beneath `config`. **CAUTION** The Hostname in the `.ssh/config` has to be an IP otherwise an error during the deployment will occur. ### .ssh/known\_hosts [](#sshknown_hosts) A list of known hosts can also be added within this directory: `.ssh/known_hosts`Keys can be added here, e.g. - 127.128.129.130 ssh-rsa {long\_public\_key} - 127.128.129.131 ssh-rsa {long\_public\_key2} ### config/\* [](#config) Take a look at `config/production.php` and config/staging.php` and change it accordingly. ### Jenkinsfile [](#jenkinsfile) The Jenkinsfile defines the Jenkins Pipeline. It has to be adjusted to the project needs. ### deploy.php [](#deployphp-1) `deploy.php` is the main entry point that can be used to customize. ### Getting Started [](#getting-started-1) Install dependencies with `composer install` start deployment with `./dep deploy staging` COMMANDS -------- [](#commands) ### config:init [](#configinit) Generate a new magedeploy2.php. Be aware: this will overwrite your existing configuration ### validate [](#validate) Validates that - the bin config values are execuatble, - the git repository is reachable ### deploy [](#deploy-1) Triggers the deployment with all it's stages ### deploy:magento-setup [](#deploymagento-setup) Runs all tasks in the stage magento-setup. It will setup or update a local Magento instance by pulling the source-code from git, installing composer dependencies and installing or updating a local database. ### deploy:artifacts-generate [](#deployartifacts-generate) Runs the Magento `di:compile` and `setup:static-content-deploy`commands to generate the assets. It is using your configurartion from the `magedeploy2.php`. After generating those assets it will create packages, again according to your configuration. ### deploy:deploy [](#deploydeploy) This command will invoke deployer to release your project and push the prepared artifacts to the server. Versioning ---------- [](#versioning) We use [SemVer](http://semver.org/) for versioning. For the versions available, see the [tags on this repository](https://github.com/mwr/magedeploy2-skeleton/tags). Authors ------- [](#authors) - **Matthias Walter** - *Initial work* - [mwr](https://github.com/mwr) License ------- [](#license) This project is licensed under the MIT License - see the [LICENSE.md](LICENSE.md) file for details ### Health Score 37 — LowBetter than 81% of packages Maintenance16 Infrequent updates — may be unmaintained Popularity31 Limited adoption so far Community15 Small or concentrated contributor base Maturity70 Established project with proven stability Bus Factor1 Top contributor holds 97% of commits — single point of failure How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Every ~22 days Total 11 Last Release 3206d ago Major Versions 1.3.0 → 2.0.02017-06-19 2.1.0 → 3.0.02017-09-20 ### Community Maintainers ![](https://www.gravatar.com/avatar/f30c3b4c4281c9e771bd267d0086c4f56b2fde98ae2cf624dc2daeab1738ff15?d=identicon)[mwltr](/maintainers/mwltr) --- Top Contributors [![mwr](https://avatars.githubusercontent.com/u/80516?v=4)](https://github.com/mwr "mwr (32 commits)")[![decius7bc](https://avatars.githubusercontent.com/u/3243458?v=4)](https://github.com/decius7bc "decius7bc (1 commits)") --- Tags composerdeploymentmagedeploy2magento2magento2-deploymentphprobo ### Embed Badge ![Health badge](/badges/mwltr-magedeploy2-base/health.svg) ``` [![Health](https://phpackages.com/badges/mwltr-magedeploy2-base/health.svg)](https://phpackages.com/packages/mwltr-magedeploy2-base) ``` ### Alternatives [lorisleiva/laravel-deployer Laravel Deployer is a lightweight wrapper of Deployer giving Artisan the power of zero-downtime deployment. 1.7k1.3M4](/packages/lorisleiva-laravel-deployer)[pantheon-systems/terminus A command line interface for Pantheon 3421.5M17](/packages/pantheon-systems-terminus)[sourcebroker/deployer-extended Library with some additional tasks for deployer (deployer.org). 25292.2k11](/packages/sourcebroker-deployer-extended)[hypernode/deploy-configuration Hypernode deploy configuration files 12133.0k](/packages/hypernode-deploy-configuration)[ngmy/webloyer Webloyer is a Web UI for managing Deployer deployments 2191.1k](/packages/ngmy-webloyer) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)