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

# 建立 EC2/現場部署運算平台部署 (CLI)
<a name="deployments-create-cli"></a>

若要使用 AWS CLI 將修訂版部署到 EC2/現場部署運算平台：

1. 當您將執行個體準備完成以後，建立應用程式以及發布修訂版，然後請執行以下其中一項：
   + 如果您想要從 Amazon S3 儲存貯體部署修訂，請現在繼續執行步驟 2。
   + 如果您想要從 GitHub 儲存貯體部署修訂版，先完成 [將 CodeDeploy 應用程式連接至 GitHub 儲存庫](deployments-create-cli-github.md) 步驟，再繼續步驟二。

1. 呼叫 [create-deployment](https://docs.aws.amazon.com/cli/latest/reference/deploy/create-deployment.html) 命令，指定：
   + `--application-name`：應用程式名稱。若要檢視應用程式名稱清單，請呼叫 [list-applications](https://docs.aws.amazon.com/cli/latest/reference/deploy/list-applications.html) 命令。
   + `--deployment-group-name`：Amazon EC2 部署群組名稱。若要檢視部署群組名稱的清單，請呼叫 [list-deployment-groups](https://docs.aws.amazon.com/cli/latest/reference/deploy/list-deployment-groups.html) 命令。
   + `--revision`：要部署之修訂的相關資訊：

     對於存放在 Amazon S3 中的修訂：
     + `s3Location`：包含修訂的 Amazon S3 儲存貯體名稱。
     + `s3Location --> key`：上傳修訂的名稱。
     + `s3Location --> bundleType`：上傳修訂的檔案類型。
**注意**  
Windows Server 執行個體不支援 tar 和壓縮 tar 封存檔案格式 (.tar 和 .tar.gz)。
     + `s3Location --> version`：（選用） 修訂版的 Amazon S3 版本識別符。（如果未指定版本識別符，CodeDeploy 會使用最新版本。)
     + `s3Location --> eTag`：（選用） 修訂版的 ETag。（如果未指定 ETag，CodeDeploy 會略過物件驗證。)

     對於存儲在 GitHub 的修訂版：
     + `gitHubLocation --> repository`：指派給包含修訂的儲存庫的 GitHub 使用者或群組名稱，後面接著正斜線 (`/`)，後面接著儲存庫名稱。
     + `gitHubLocation --> commitId`：修訂的遞交 ID。
   + `--deployment-config-name`：（選用） 要使用的部署組態名稱。若要檢視部署組態清單，請呼叫 [list-deployment-configs](https://docs.aws.amazon.com/cli/latest/reference/deploy/list-deployment-configs.html) 命令。（如果未指定，CodeDeploy 會使用特定的預設部署組態。)
   + `--ignore-application-stop-failures | --no-ignore-application-stop-failures`：（選用） 如果部署`BeforeInstall`生命週期事件失敗，您是否希望執行個體的`ApplicationStop`部署繼續部署生命週期事件。
   + `--description`：（選用） 部署的描述。
   + `--file-exists-behavior`：（選用） 在部署程序中，CodeDeploy 代理程式會從每個執行個體移除最新部署安裝的所有檔案。選擇當不屬於先前部署的檔案出現在目標部署位置時會發生什麼情況。
   + `--target-instances`：對於藍/綠部署，有關藍/綠部署中屬於替代環境的執行個體的資訊，包括一或多個 Amazon EC2 Auto Scaling 群組的名稱，或用於識別 Amazon EC2 執行個體的標籤篩選條件索引鍵、類型和值。

**注意**  
使用此語法作為**create-deployment**呼叫的一部分，直接在命令列上指定 Amazon S3 中修訂的相關資訊。(​`version` 和 `eTag` 是選擇性使用的)。  

```
--s3-location bucket=string,key=string,bundleType=tar|tgz|zip,version=string,eTag=string
```
使用此語法作為 **create-deployment** 呼叫的一部分，直接在命令列上指定 GitHub 中的修訂版資訊。  

```
--github-location repository=string,commitId=string
```
若要取得已推送修訂的相關資訊，請呼叫 [list-application-revisions](https://docs.aws.amazon.com/cli/latest/reference/deploy/list-application-revisions.html) 命令。

如需追蹤部署的狀態，請參閱[檢視 CodeDeploy 部署詳細資訊](deployments-view-details.md)。

## create-deployment 命令參考
<a name="deployments-create-cli-reference"></a>

以下是命令的`create-deployment`命令結構和選項。如需詳細資訊，請參閱《 命令參考》中的 [create-deployment](https://docs.aws.amazon.com/cli/latest/reference/deploy/create-deployment.html) 參考。 *AWS CLI *

```
create-deployment
--application-name <value>
[--deployment-group-name <value>]
[--revision <value>]
[--deployment-config-name <value>]
[--description <value>]
[--ignore-application-stop-failures | --no-ignore-application-stop-failures]
[--target-instances <value>]
[--auto-rollback-configuration <value>]
[--update-outdated-instances-only | --no-update-outdated-instances-only]
[--file-exists-behavior <value>]
[--s3-location <value>]
[--github-location <value>]
[--cli-input-json <value>]
[--generate-cli-skeleton <value>]
```

# 將 CodeDeploy 應用程式連接至 GitHub 儲存庫
<a name="deployments-create-cli-github"></a>

首次使用 從 GitHub 儲存庫部署應用程式之前 AWS CLI，您必須先授予 CodeDeploy 許可，以代表 GitHub 帳戶與 GitHub 互動。每個應用程式都必須使用 CodeDeploy 主控台完成此步驟一次。

1. 登入 AWS 管理主控台 ，並在 https：//[https://console.aws.amazon.com/codedeploy](https://console.aws.amazon.com/codedeploy) 開啟 CodeDeploy 主控台。
**注意**  
使用您在 中設定的相同使用者登入[CodeDeploy 入門](getting-started-codedeploy.md)。

1. 選擇 **Applications (應用程式)**。

1. 從 **Application (應用程式)** 中，選擇您要連結到您 GitHub 使用者帳戶的應用程式，並選擇 **Deploy application (部署應用程式)**。
**注意**  
您不是在建立部署。這是目前授予 CodeDeploy 許可來代表 GitHub 使用者帳戶與 GitHub 互動的唯一方法。

1. 接著，在 **Repository type (儲存庫類型)** 旁，選擇 **My application revision is stored in GitHub (我的應用程式修訂版存放在 GitHub)**。

1. 選擇**連線到 GitHub**。
**注意**  
如果您查看 **連接到不同的 GitHub 帳戶** 連結：  
您可能已經授權 CodeDeploy 代表應用程式的不同 GitHub 帳戶與 GitHub 互動。  
您可能已撤銷 CodeDeploy 代表登入的 GitHub 帳戶與 GitHub 互動的授權，適用於 CodeDeploy 中連結至 的所有應用程式。 GitHub   
如需詳細資訊，請參閱[在 CodeDeploy 中使用應用程式進行 GitHub 身分驗證](integrations-partners-github.md#behaviors-authentication)。

1. 如果您尚未登入GitHub，請依照 **登入** 頁面指示操作。

1. 在 **授權應用程式** 頁面上，請選擇 **授權應用程式**。

1. 現在 CodeDeploy 具有許可，請選擇**取消**，然後繼續 中的步驟[建立 EC2/現場部署運算平台部署 (CLI)](deployments-create-cli.md)。