本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

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

## Description
<a name="eb3-platformdescription"></a>

本命令支援兩種不同的工作空間：

[平台](#eb3-platform-preconfigured)  
使用此工作空間來管理自訂平台。

[Environment (環境)](#eb3-platform-environment)   
使用此工作空間來選取預設平台，或顯示目前平台的資訊。

Elastic Beanstalk 為 **eb platform** 提供捷徑 **ebp**。

**注意**  
Windows PowerShell 使用 **ebp** 做為命令別名。若您於 Windows PowerShell 執行 EB CLI，請使用此命令的長格式：**eb platform**。

## 在自訂平台使用 eb 平台
<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>


****  

|  名稱  |  描述  | 
| --- | --- | 
| `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 />或<br />`--help` | 顯示協助訊息並退出。 | 
| `--debug` | 顯示其他除錯輸出。 | 
| `--quiet` | 抑制所有輸出。 | 
| `-v`<br />或<br />`--verbose` | 顯示其他輸出。 | 
| `--profile {{PROFILE}}` | 使用您登入資料指定的 {{PROFILE}}。 | 
| `-r {{REGION}}`<br />或<br />`--region {{REGION}}` | 使用區域 {{REGION}}。 | 
| `--no-verify-ssl` | 請勿驗證 AWS SSL 憑證。 | 

### Eb 平台建立
<a name="eb3-platform-create"></a>

建立平台的新版本並回傳其 ARN。若沒有建置器環境在目前區域中執行，本命令會啟動一個建置器環境。{{版本}} 和遞增選項 (`-M`、`-m` 和 `-p`) 互斥。

#### 選項
<a name="eb3-platform-create-options"></a>


****  

|  名稱  |  描述  | 
| --- | --- | 
| {{version}} | 若未指定 {{版本}}，會依據最近的平台建立新版本，且修補程式版本 (n.n.N 中的 N) 會遞增。 | 
| `-M`<br />或<br />`--major-increment` | 增加主要版本編號 (N.n.n 中的 N)。 | 
| `-m`<br />或<br />`--minor-increment` | 增加次要版本編號 (n.N.n 中的 N)。 | 
| `-p`<br />或<br />`--patch-increment` | 增加修補程式版本編號 (n.n.N 中的 N)。 | 
| `-i {{INSTANCE_TYPE}}`<br />或<br />--instance-type {{INSTANCE\_TYPE}} | 將 {{INSTANCE\_TYPE}} 做為執行個體類型 (如 **t1.micro**)。 | 
| `-ip {{INSTANCE_PROFILE}}`<br />或<br />`--instance-profile {{INSTANCE_PROFILE}}` | 在建立自訂平台的 AMI 時將 {{INSTANCE\_PROFILE}} 做為執行個體描述檔。<br />若不指定 `-ip` 選項，會建立執行個體描述檔 `aws-elasticbeanstalk-custom-platforme-ec2-role` 並將其用於自訂平台。 | 
| `--tags {{key1}}={{value1}}[,{{key2}}={{value2}} ...]` | 指定標籤的格式為以逗號分隔的 `key=value` 對清單。 | 
| `--timeout` {{分鐘}} | 設定命令逾時前的分鐘數。 | 
| `--vpc.id {{VPC_ID}}` | 在其中建立 Packer 的 VPC ID。 | 
| `--vpc.subnets {{VPC_SUBNETS}}` | 在其中建立 Packer 的 VPC 子網路。 | 
| `--vpc.publicip` | 將公有 IP 與啟動的 EC2 執行個體建立關聯。 | 

### Eb 平台刪除
<a name="eb3-platform-delete"></a>

刪除平台版本。若環境正在使用該版本，將不會刪除。

#### 選項
<a name="eb3-platform-delete-options"></a>


****  

|  名稱  |  描述  | 
| --- | --- | 
| `{{version}}` | 欲刪除的版本。此值為必填。 | 
| `--cleanup` | 移除所有處於 `Failed` 狀態的平台版本。 | 
| `--all-platforms` | 若指定為 `--cleanup`，會移除所有平台處於 `Failed` 狀態的平台版本。 | 
| `--force` | 刪除版本時不需要進行確認。 | 

### Eb 平台事件
<a name="eb3-platform-events"></a>

顯示一個平台版本的事件。若已指定{{版本}}，會顯示該版本的事件，否則會顯示目前版本的事件。

#### 選項
<a name="eb3-platform-events-options"></a>


****  

|  名稱  |  描述  | 
| --- | --- | 
| {{version}} | 欲顯示事件的版本。此值為必填。 | 
| `-f`<br />或<br />`--follow` | 在事件發生時持續顯示。 | 

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

初始化平台儲存庫。

#### 選項
<a name="eb3-platform-init-options"></a>


****  

|  名稱  |  描述  | 
| --- | --- | 
| `{{platform}}` | 欲初始化的平台名稱。此值為必填，除非啟用 `-i` (互動式模式)。 | 
| `-i`<br />或<br />`--interactive` | 使用互動式模式。 | 
| `-k {{KEYNAME}}`<br />或<br />`--keyname {{KEYNAME}}` | 預設 EC2 金鑰名稱。 | 

您可於之前已初始化的目錄執行本命令，但是將無法變更工作空間類型。

欲使用不同選項重新初始化，請使用 `-i` 選項。

### Eb 平台清單
<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>


****  

|  名稱  |  描述  | 
| --- | --- | 
| `-a`<br />或<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.aws.amazon.com/zh_tw/elasticbeanstalk/latest/dg/eb3-platform.html) | 

### Eb 平台日誌
<a name="eb3-platform-logs"></a>

顯示平台版本建置器環境的日誌。

#### 選項
<a name="eb3-platform-logs-options"></a>


****  

|  名稱  |  描述  | 
| --- | --- | 
| `{{version}}` | 欲顯示記錄的平台版本。若省略，則會顯示目前版本的日誌。 | 
| `--stream` | 串流透過 CloudWatch 設定的部署日誌。 | 

### Eb 平台狀態
<a name="eb3-platform-status"></a>

顯示平台版本的狀態。

#### 選項
<a name="eb3-platform-status-options"></a>


****  

|  名稱  |  描述  | 
| --- | --- | 
| `{{version}}` | 欲擷取狀態的平台版本。若省略，則會顯示目前版本的狀態。 | 

### Eb 平台使用
<a name="eb3-platform-use"></a>

選取已建立新版本的不同平台。

#### 選項
<a name="eb3-platform-use-options"></a>


****  

|  名稱  |  描述  | 
| --- | --- | 
| `{{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>


****  

|  名稱  |  描述  | 
| --- | --- | 
| `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
```