AOEpeople/magento-deployscripts

Name: magento-deployscripts

Owner: AOE

Description: null

Created: 2014-11-18 19:23:57.0

Updated: 2017-09-24 20:44:34.0

Pushed: 2017-04-05 17:26:21.0

Homepage: null

Size: 14247

Language: Shell

GitHub Committers

User	Most Recent Commit	# Commits

Other Committers

User	Email	Most Recent Commit	# Commits

README

Magento Deployment Scripts

Author: Fabrizio Branca

This is a collection of scripts used to build/package, deploy and install Magento projects.

Import note: Never use the master branch in your build jobs. Instead clone a specific tag:

clone -b v1.0.0 https://github.com/AOEpeople/magento-deployscripts.git

Since these scripts might change significantly and your deployment process might fail otherwise.

Overview

• build.sh
• deploy.sh
• install.sh

Usage

Add the magento-deployment scripts to your project using Composer. Checkout composer.json example file below.

Introduction

build vs. provisioning vs. deployment vs. installation

Checkout http://www.slideshare.net/aoepeople/rock-solid-magento/91 (and the next slides after that)

TODO: add more information here

build.sh

e:
eploy.sh -r <packageUrl> -t <targetDir> -e <environment> [-u <downloadUsername>] [-p <downloadPassword>] [-a <awsCliProfile>] [-d]
    Package url (http, S3 or local file)
    Target dir
    Download username
    Download password
    aws cli profile (defaults to 'default')
    Also download and install .extra.tar.gz package

Generated files

• projectName.tar.gz
• projectName.extra.tar.gz
• MD5SUMS

Base package vs extra package

Checkout http://www.slideshare.net/aoepeople/rock-solid-magento/55 (and the next slides after that)

Example Configuration/tar_excludes.txt content

*
docs/install.php
docs/includes
docs/downloader
docs/pkginfo
docs/LICENSE*
docs/RELEASE_NOTES.txt
docs/phpunit.xml*
docs/*.sample
docs/var
docs/media
ols/composer.phar
odman/Aoe_TemplateHints
odman/EcomDev_PHPUnit

Expected project files/directories

• composer.json
• tools/composer.phar (This should be part of your project repo. Obviously this can't be pulled in via Composer. Chicken and egg, problem… :)
• tools/modman (This is part of https://github.com/AOEpeople/magento-deployscripts which is being pulled in via composer)
• htdocs/index.php
• .modman directory: The modules located here can be directly committed to the main project repository (e.g. if they're project specific) or they can be pulled in via Composer)
• .modman/ProjectName_Base: There's no exclipict check for this base module to be present, but this is a recommendation. Add the basic project setup (local.xml, htaccess,…) to this base module.
• .modman/.basedir
• Configuration/tar_excludes.txt (this file controls what goes in the base package and what goes in the extra package. See below)

Additionally install.sh expects/checks these files:

• tools/systemstorage_import.sh (This is part of https://github.com/AOEpeople/magento-deployscripts which is being pulled in via composer)
• tools/apply (This is part of https://github.com/AOEpeople/EnvSettingsTool which is being pulled in via composer)
• tools/n98-magerun.phar (This is part of https://github.com/AOEpeople/magento-deployscripts which is being pulled in via composer)
• Configuration/settings.csv (This is being used by EnvSettingsTool to apply all environment specific settings during the installation process)
• Configuration/mastersystem.txt (Defines which system is the master system. E.g. “production”. This is required to determine if the systemstorage backup needs to be imported during the installation process.)
• Configuration/project.txt (project name. E.g. “acme”)

These files and folders can easily be constructud by using following composer.json as a basis for your project

"name": "my/project",
"minimum-stability": "dev",
"require": {
    "aoepeople/composer-installers": "*",
    "aoepeople/envsettingstool": "*",
    "tmp/magento_community": "1.9.0.1"
    "aoepeople/magento-deployscripts": "1.0.3"
},
"repositories": [
    {
        "type": "vcs",
        "url": "https://github.com/AOEpeople/composer-installers.git"
    },
    {
        "type": "vcs",
        "url": "https://github.com/AOEpeople/EnvSettingsTool.git"
    },
    {
        "type": "package",
        "package": {
            "name": "tmp/magento_community",
            "type": "magento-source",
            "version": "1.9.0.1",
            "dist": {
                "url": "https://github.com/OpenMage/magento-mirror/archive/1.9.0.1.zip",
                "type": "zip"
            }
        }
    },
    {
        "type": "vcs",
        "url": "https://github.com/AOEpeople/magento-deployscripts.git"
    }
],
"config" : {
    "bin-dir": "tools"
}

Auto-generated meta files

Following files will be stored inside the base package

• build.txt
• htdocs/version.txt (will be accessible from the web)

deploy.sh

install.sh

opsworks_*.sh

systemstorage_import.sh

*lint.sh

Tools

n98-magerun modman