本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# **eb platform**
<a name="eb3-platform"></a>

## 说明
<a name="eb3-platformdescription"></a>

此命令支持两种不同工作区：

[平台](#eb3-platform-preconfigured)  
使用此命令可管理自定义平台。

[环境](#eb3-platform-environment)  
使用此工作区可选择默认平台或显示有关当前平台的信息。

Elastic Beanstalk 提供了 **eb platform** 的快捷方式 **ebp**。

**注意**  
Windows PowerShell 使用**ebp**作为命令别名。如果你在 Windows 中运行 EB CLI PowerShell，请使用此命令的长格式 — **eb platform**。

## 对自定义平台使用 eb platform
<a name="eb3-platform-preconfigured"></a>

列出当前平台的版本并能让您管理自定义平台。

### 语法
<a name="eb3-platformpresyntax"></a>

**eb platform create [{{version}}] [{{options}}]**

**eb platform delete [{{version}}] [{{options}}]**

**eb platform events [{{version}}] [{{options}}]**

**eb platform init [{{platform}}] [{{options}}]**

**eb platform list [{{options}}]**

**eb platform logs [{{version}}] [{{options}}]**

**eb platform status [{{version}}] [{{options}}]**

**eb platform use [{{platform}}] [{{options}}]**

### 选项
<a name="eb3-platform-options"></a>


****  

|  Name  |  描述  | 
| --- | --- | 
| `create [{{version}}] [{{options}}]` | 生成平台的新版本。[了解更多](#eb3-platform-create)。 | 
| `delete {{version}} [{{options}}]` | 删除平台版本。[了解更多](#eb3-platform-delete)。 | 
| `events [{{version}}] [{{options}}]` | 显示平台版本中的事件。[了解更多](#eb3-platform-events)。 | 
| `init [{{platform}}] [{{options}}]` | 初始化平台存储库。[了解更多](#eb3-platform-init)。 | 
| `list [{{options}}]` | 列出当前平台的版本。[了解更多](#eb3-platform-list)。 | 
| `logs [{{version}}] [{{options}}]` | 显示平台版本的生成器环境中的日志。[了解更多](#eb3-platform-logs)。 | 
| `status [{{version}}] [{{options}}]` | 显示平台版本的状态。[了解更多](#eb3-platform-status)。 | 
| `use [{{platform}}] [{{options}}]` | 选择生成新版本所基于的其他平台。[了解更多](#eb3-platform-use)。 | 
| [常用选项](eb3-cmd-options.md) |  | 

### 常用选项
<a name="eb3-platform-common"></a>

所有 **eb platform** 命令均包含以下常用选项。


****  

|  名称  |  描述  | 
| --- | --- | 
| `-h`<br />OR<br />`--help` | 显示帮助消息并退出。 | 
| `--debug` | 显示更多调试输出。 | 
| `--quiet` | 隐藏所有输出。 | 
| `-v`<br />OR<br />`--verbose` | 显示更多输出。 | 
| `--profile {{PROFILE}}` | 使用您的凭证{{PROFILE}}中指定的。 | 
| `-r {{REGION}}`<br />或<br />`--region {{REGION}}` | 使用该区域{{REGION}}。 | 
| `--no-verify-ssl` | 请勿验证 Amazon SSL 证书。 | 

### Eb platform create
<a name="eb3-platform-create"></a>

生成平台的新版本并返回新版本的 ARN。如果当前区域没有正在运行的生成器环境，则此命令将会启动一个。{{version}}和增量选项（`-M``-m`、和`-p`）是互斥的。

#### 选项
<a name="eb3-platform-create-options"></a>


****  

|  Name  |  说明  | 
| --- | --- | 
| {{version}} | 如果{{version}}未指定，则基于最新的平台创建新版本，补丁版本（N.n.n 中的 N）递增。 | 
| `-M`<br />或<br />`--major-increment` | 将主要版本号（N.n.n 中的 N）递增一。 | 
| `-m`<br />OR<br />`--minor-increment` | 将次要版本号（n.N.n 中的 N）递增一。 | 
| `-p`<br />OR<br />`--patch-increment` | 将修补版本号（n.n.N 中的 N）递增一。 | 
| `-i {{INSTANCE_TYPE}}`<br />或<br />--实例类型 {{INSTANCE\_TYPE}} | {{INSTANCE\_TYPE}}用作实例类型，例如**t1.micro**。 | 
| `-ip {{INSTANCE_PROFILE}}`<br />或<br />`--instance-profile {{INSTANCE_PROFILE}}` | 在{{INSTANCE\_PROFILE}}为自定义平台创建 AMIs 时用作实例配置文件。<br />如果未指定 `-ip` 选项，请创建实例配置文件 `aws-elasticbeanstalk-custom-platforme-ec2-role` 并将它用于自定义平台。 | 
| `--tags {{key1}}={{value1}}[,{{key2}}={{value2}} ...]` | 将标签指定为逗号分隔的 `key=value` 对的列表。 | 
| `--timeout` {{minutes}} | 命令超时之前的设定分钟数。 | 
| `--vpc.id {{VPC_ID}}` | 在其中生成 Packer 的 VPC 的 ID。 | 
| `--vpc.subnets {{VPC_SUBNETS}}` | 在其中生成 Packer 的 VPC 子网。 | 
| `--vpc.publicip` | 将公共 EC2 实例 IPs 与启动的实例相关联。 | 

### Eb platform delete
<a name="eb3-platform-delete"></a>

删除平台版本。如果环境在使用该版本，则该版本不会被删除。

#### 选项
<a name="eb3-platform-delete-options"></a>


****  

|  Name  |  描述  | 
| --- | --- | 
| `{{version}}` | 要删除的版本。此值为必填项。 | 
| `--cleanup` | 删除所有处于 `Failed` 状态的平台版本。 | 
| `--all-platforms` | 如果指定了 `--cleanup`，请删除所有平台的处于 `Failed` 状态的所有平台版本。 | 
| `--force` | 在删除版本时，不要求进行确认。 | 

### Eb platform events
<a name="eb3-platform-events"></a>

显示平台版本中的事件。如果{{version}}已指定，则显示该版本的事件，否则显示当前版本的事件。

#### 选项
<a name="eb3-platform-events-options"></a>


****  

|  Name  |  说明  | 
| --- | --- | 
| {{version}} | 为其显示事件的版本。此值为必填项。 | 
| `-f`<br />OR<br />`--follow` | 继续在事件发生时显示它们。 | 

### Eb platform init
<a name="eb3-platform-init"></a>

初始化平台存储库。

#### 选项
<a name="eb3-platform-init-options"></a>


****  

|  Name  |  描述  | 
| --- | --- | 
| `{{platform}}` | 要初始化的平台的名称。该值是必需的，除非启用了 `-i`（交互式模式）。 | 
| `-i`<br />OR<br />`--interactive` | 使用交互式模式。 | 
| `-k {{KEYNAME}}`<br />或<br />`--keyname {{KEYNAME}}` | 默认 EC2 密钥名称。 | 

您可以在之前初始化的目录中运行该命令，但是，如果是在之前初始化的目录中运行，则无法更改工作区类型。

要使用不同选项重新初始化，请使用 `-i` 选项。

### Eb platform list
<a name="eb3-platform-list"></a>

列出与工作区（目录）或区域关联的平台的版本。

该命令将返回不同的结果，具体取决于您在其中运行它的工作区的类型，如下所示：
+ 在平台工作区（由 `eb platform init` 初始化的目录）中，该命令将返回工作区中定义的自定义平台的所有平台版本的列表。添加 `--all-platforms` 或 `--verbose` 选项以获取您的账户在与工作区关联的区域中具有的所有自定义平台的所有平台版本的列表。
+ 在应用程序工作区（由 `eb init` 初始化的目录）中，该命令将返回由 Elastic Beanstalk 托管的平台和您账户的自定义平台的所有平台版本的列表。列表使用简短的平台版本名称，而且一些平台版本变体可进行组合。添加 `--verbose` 选项以获取包含完整名称及分别列出的所有变体的详细列表。
+ 在未初始化的目录中，该命令仅适用于 `--region` 选项。它将返回区域中支持的所有 Elastic Beanstalk 托管的平台版本的列表。列表使用简短的平台版本名称，而且一些平台版本变体可进行组合。添加 `--verbose` 选项以获取包含完整名称及分别列出的所有变体的详细列表。

#### 选项
<a name="eb3-platform-list-options"></a>


****  

|  Name  |  描述  | 
| --- | --- | 
| `-a`<br />OR<br />`--all-platforms` | 仅在已初始化的工作区（由 `eb platform init` 或 `eb init` 初始化的目录）中有效。列出与您的账户关联的所有自定义平台的平台版本。 | 
| `-s {{STATUS}}`<br />或<br />`--status {{STATUS}}` | 仅列出匹配的平台{{STATUS}}：[See the AWS documentation website for more details](http://docs.amazonaws.cn/elasticbeanstalk/latest/dg/eb3-platform.html) | 

### Eb platform logs
<a name="eb3-platform-logs"></a>

显示平台版本的生成器环境中的日志。

#### 选项
<a name="eb3-platform-logs-options"></a>


****  

|  Name  |  描述  | 
| --- | --- | 
| `{{version}}` | 为其显示日志的平台的版本。如果省略，则显示当前版本的日志。 | 
| `--stream` | 流式传输使用设置的部署日志 CloudWatch。 | 

### Eb platform status
<a name="eb3-platform-status"></a>

显示平台版本的状态。

#### 选项
<a name="eb3-platform-status-options"></a>


****  

|  Name  |  描述  | 
| --- | --- | 
| `{{version}}` | 为其检索状态的平台的版本。如果省略，则显示当前版本的状态。 | 

### Eb platform use
<a name="eb3-platform-use"></a>

选择生成新版本所基于的其他平台。

#### 选项
<a name="eb3-platform-use-options"></a>


****  

|  Name  |  说明  | 
| --- | --- | 
| `{{platform}}` | 指定{{platform}}为该工作区的活动版本。该值为必填项。 | 

## 将 eb platform 用于环境
<a name="eb3-platform-environment"></a>

列出支持的平台，并使您能够设置默认平台和在启动环境时要使用的平台版本。使用 **eb platform list** 可查看所有支持平台的列表。使用 **eb platform select** 可更改项目的平台。使用 **eb platform show** 可查看您的项目的选定平台。

### 语法
<a name="eb3-platformenvsyntax"></a>

**eb platform list**

**eb platform select**

**eb platform show**

### 选项
<a name="eb3-platformenvoptions"></a>


****  

|  Name  |  描述  | 
| --- | --- | 
| `list` | 列出当前平台的版本。 | 
| `select` | 选择默认平台。 | 
| `show` | 显示有关当前平台的信息。 | 

### 示例 1
<a name="eb3-platformenvexample1"></a>

以下示例列出 Elastic Beanstalk 支持的所有平台的所有配置的名称。

```
$ eb platform list
docker-1.5.0
glassfish-4.0-java-7-(preconfigured-docker)
glassfish-4.1-java-8-(preconfigured-docker)
go-1.3-(preconfigured-docker)
go-1.4-(preconfigured-docker)
iis-7.5
iis-8
iis-8.5
multi-container-docker-1.3.3-(generic)
node.js
php-5.3
php-5.4
php-5.5
python
python-2.7
python-3.4
python-3.4-(preconfigured-docker)
ruby-1.9.3
ruby-2.0-(passenger-standalone)
ruby-2.0-(puma)
ruby-2.1-(passenger-standalone)
ruby-2.1-(puma)
ruby-2.2-(passenger-standalone)
ruby-2.2-(puma)
tomcat-6
tomcat-7
tomcat-7-java-6
tomcat-7-java-7
tomcat-8-java-8
```

### 示例 2
<a name="eb3-platformenvexample2"></a>

以下示例提示您从平台列表中选择并选择要为指定平台部署的版本。

```
$ eb platform select
Select a platform.
1) PHP
2) Node.js
3) IIS
4) Tomcat
5) Python
6) Ruby
7) Docker
8) Multi-container Docker
9) GlassFish
10) Go
(default is 1): 5

Select a platform version.
1) Python 2.7
2) Python
3) Python 3.4 (Preconfigured - Docker)
```

### 示例 3
<a name="eb3-platformenvexample3"></a>

以下示例显示有关当前默认平台的信息。

```
$ eb platform show
Current default platform: Python 2.7
New environments will be running:  64bit Amazon Linux 2014.09 v1.2.0 running Python 2.7

Platform info for environment "tmp-dev":
Current: 64bit Amazon Linux 2014.09 v1.2.0 running Python
Latest:  64bit Amazon Linux 2014.09 v1.2.0 running Python
```