README

作者：Fabrizio Branca

这是一个用于构建/打包、部署和安装 Magento 项目的脚本集合。

导入说明：请勿在构建作业中使用 master 分支。相反，克隆特定的标签

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

因为这些脚本可能会发生重大变化，否则您的部署过程可能会失败。

概览

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

用法

使用 Composer 将 magento-deployment 脚本添加到您的项目中。下面是 composer.json 示例文件。

介绍

构建与配置、部署与安装的区别

查看 http://www.slideshare.net/aoepeople/rock-solid-magento/91（以及之后的幻灯片）

待办事项：在此处添加更多信息

build.sh

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

生成的文件

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

基本包与额外包

查看 http://www.slideshare.net/aoepeople/rock-solid-magento/55（以及之后的幻灯片）

Example Configuration/tar_excludes.txt 内容

.git*
./htdocs/install.php
./htdocs/includes
./htdocs/downloader
./htdocs/pkginfo
./htdocs/LICENSE*
./htdocs/RELEASE_NOTES.txt
./htdocs/phpunit.xml*
./htdocs/*.sample
./htdocs/var
./htdocs/media
./tools/composer.phar
./.modman/Aoe_TemplateHints
./.modman/EcomDev_PHPUnit

预期的项目文件/目录

• composer.json
• tools/composer.phar（这应该是您的项目仓库的一部分。显然，这不能通过 Composer 拉取。鸡生蛋，蛋生鸡，问题... :)）
• tools/modman（这是https://github.com/AOEpeople/magento-deployscripts的一部分，通过 composer 拉取）
• htdocs/index.php
• .modman 目录：位于此处的模块可以直接提交到主项目仓库（例如，如果它们是项目特定的），或者可以通过 Composer 拉取。
• .modman/ProjectName_Base：没有明确检查此基本模块必须存在，但这是一个建议。将基本项目设置（local.xml，htaccess 等）添加到此基本模块。
• .modman/.basedir
• Configuration/tar_excludes.txt（此文件控制哪些内容放入基本包和哪些内容放入额外包。见下文）

此外，install.sh 预期/检查以下文件

• tools/systemstorage_import.sh（这是https://github.com/AOEpeople/magento-deployscripts的一部分，通过 composer 拉取）
• tools/apply（这是https://github.com/AOEpeople/EnvSettingsTool的一部分，通过 composer 拉取）
• tools/n98-magerun.phar（这是https://github.com/AOEpeople/magento-deployscripts的一部分，通过 composer 拉取）
• Configuration/settings.csv（此文件由 EnvSettingsTool 在安装过程中应用所有环境特定设置）
• Configuration/mastersystem.txt（定义哪个系统是主系统。例如，“生产”。这是确定在安装过程中是否需要导入系统存储备份所必需的。）
• Configuration/project.txt（项目名称。例如，“acme”）

这些文件和文件夹可以通过使用以下composer.json作为项目基础的简单构建。

{
    "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"
    }
}

自动生成的元文件

以下文件将存储在基本包中

• build.txt
• htdocs/version.txt（可以从网络上访问）

deploy.sh

install.sh

opsworks_*.sh

systemstorage_import.sh

*lint.sh

工具

n98-magerun

modman