AWS Elastic Beanstalk
开发人员指南
AWS 文档中描述的 AWS 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅中国的 AWS 服务入门

开始设置

注意

此工具、Elastic Beanstalk API CLI 及其文档已由 AWS CLI 取代。请参阅 AWS CLI 用户指南以开始使用 AWS CLI。另请尝试 EB CLI 以获取简化的高级命令行体验。

Elastic Beanstalk 提供了命令行界面 (CLI),方便您使用各种 Elastic Beanstalk 功能,而无需使用 AWS 管理控制台或 API。本部分介绍了运行 CLI 工具 (或命令行工具) 的先决条件、从何处获取这些工具、如何设置这些工具及其环境,并包含了一系列有关工具使用的常见示例。

先决条件

本文档假定您可以在 Linux/UNIX 或 Windows 环境中工作。Elastic Beanstalk 命令行界面还可在 Mac OS X (类似于 Linux 和 UNIX 命令环境) 上正常运行,但是本指南中未包含具体的 Mac OS X 说明。

就惯例而言,所有命令行文本以通配的 PROMPT> 命令行提示符作为前缀。您的机器上的实际命令行提示符可能有所不同。我们还使用 $ 表示 Linux/UNIX 特定命令,使用 C:\> 表示 Windows 特定命令。由命令得出的示例输出在其后立即显示,同时不带任何前缀。

本指南中使用的命令行工具需要 Ruby (版本 1.8.7+ 或 1.9.2+) 和 Python 版本 2.7 才能运行。要查看和下载适用于 Linux/UNIX 和 Windows 等一系列平台的 Ruby 客户端,请转到 http://www.ruby-lang.org/en/。Python 可在 python.org 上获得。

注意

如果您使用的 Linux 系统版本低于 2.7,请使用发行版的程序包管理器安装 Python 2.7,然后修改 eb 下的 eb/linux/python2.7/eb 脚本以引用 Python 2.7 可执行文件:

#!/usr/bin/env python2.7

此外,您需要使用 boto 安装 pip 模块:

$ sudo /usr/bin/easy_install-2.7 pip $ sudo pip install boto

获得命令行工具

可在 AWS 示例代码库网站上获取 .zip 文件格式的命令行工具。这些工具是用 Ruby 编写的,且包含适用于 Windows 2000、Windows XP、Windows Vista、Windows 7、Linux/UNIX 和 Mac OS X 的外壳脚本。.zip 文件是一种自包含式文件,无需安装;只需下载 .zip 文件,然后将其提取到本地计算机的目录上即可。您可在 api 目录中查找这些工具。

提供命令行界面凭证

命令行界面需要访问密钥 ID 和秘密访问密钥。若要获取访问密钥(访问密钥 ID 和秘密访问密钥),请参阅 AWS General Reference 中的如何获取安全凭证?

您需要创建包含访问密钥 ID 和秘密访问密钥的文件。文件内容应与以下内容类似:

AWSAccessKeyId=Write your AWS access ID AWSSecretKey=Write your AWS secret key

重要

在 UNIX 上,限制凭证文件拥有者的权限:

$ chmod 600 <the file created above>

设置凭证文件后,您需要设置 AWS_CREDENTIAL_FILE 环境变量,以便 Elastic Beanstalk CLI 工具找到您的信息。

设置 AWS_CREDENTIAL_FILE 环境变量

  • 使用以下命令设置环境变量:

    在 Linux 和 UNIX 上 在 Windows 上
    $ export AWS_CREDENTIAL_FILE=<the file created above> C:\> set AWS_CREDENTIAL_FILE=<the file created above>

设置服务终端节点 URL

默认情况下,AWS Elastic Beanstalk 使用美国东部(弗吉尼亚北部)区域 (us-east-1),服务终端节点 URL 为 elasticbeanstalk.us-east-1.amazonaws.com.cn。本部分描述了如何通过设置服务终端节点 URL 指定不同区域。有关此产品的区域的信息,请转到 Amazon Web Services 一般参考 中的区域和终端节点

设置服务终端节点 URL

  • 使用以下命令设置环境变量:

    在 Linux 和 UNIX 上 在 Windows 上
    $ export ELASTICBEANSTALK_URL=<service_endpoint> C:\> set ELASTICBEANSTALK_URL=<service_endpoint>

    例如,在 Linux 上,键入以下内容,将您的终端节点设置为 us-west-2:

    export ELASTICBEANSTALK_URL="https://elasticbeanstalk.us-west-2.amazonaws.com.cn"

    例如,在 Windows 上,键入以下内容,将您的终端节点设置为 us-west-2:

    set ELASTICBEANSTALK_URL=https://elasticbeanstalk.us-west-2.amazonaws.com.cn