Engine Yard 命令行工具 (ey) 技术文档

安装指南

安装前提

• 确保本地已安装 Ruby 1.8.7 或 1.9.2 版本。
• 注意：此处的 Ruby 版本仅用于运行 engineyard gem，不会影响 Engine Yard 环境中的 Ruby 版本。

安装步骤

1. 使用以下命令安装 engineyard gem：

   gem install engineyard
   

2. 注意：不要将 engineyard gem 添加到应用程序的 Gemfile 中，因为它不是应用程序的一部分，可能会导致版本冲突。

项目的使用说明

登录

首次运行命令时，系统会提示您输入 Engine Yard 的电子邮件和密码进行登录。

配置

ey.yml 文件允许为每个部署环境保存选项。典型的 Rails 应用程序会在 config/ey.yml 中配置如下内容：

---
defaults:
  migrate: true
  migration_command: rake db:migrate
  precompile_assets: true

常用命令

• ey init: 初始化仓库以在 Engine Yard Cloud 上进行部署。
• ey deploy: 部署应用程序。
• ey timeout-deploy: 标记最新部署为失败，允许新的部署运行。
• ey status: 显示指定应用程序和环境的最新部署状态。
• ey environments: 显示应用程序的环境列表。

项目API使用文档

配置文件 ey.yml

ey.yml 文件用于配置部署选项，支持全局默认设置和环境特定设置。以下是一些常用选项：

• migrate: 是否运行迁移。
• migration_command: 自定义迁移命令。
• precompile_assets: 是否预编译资产。
• asset_dependencies: 指定在每次部署时检查资产更改的路径列表。

命令行选项

• ey deploy:
  • -r, --ref=REF: 指定要部署的 Git 引用（分支、标签或 SHA）。
  • -c, --account=ACCOUNT: 指定账户名称。
  • -a, --app=APP: 指定应用程序名称。
  • -e, --environment=ENVIRONMENT: 指定部署环境。
  • -m, --migrate=MIGRATE: 指定迁移命令或使用 --no-migrate 跳过迁移。

项目安装方式

安装命令

gem install engineyard

注意事项

• 不要将 engineyard gem 添加到应用程序的 Gemfile 中。
• 确保 ey.yml 文件已提交到应用程序仓库中，以便在部署时使用。