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

# 使用 CodeDeploy 在 Amazon S3 中註冊應用程式修訂版
<a name="application-revisions-register"></a>

如果您已經呼叫 [push](https://docs.aws.amazon.com/cli/latest/reference/deploy/push.html) 命令，將應用程式修訂推送至 Amazon S3，則不需要註冊修訂。不過，如果您透過其他方式將修訂上傳至 Amazon S3，並希望修訂出現在 CodeDeploy 主控台中或透過 ， AWS CLI請依照下列步驟先註冊修訂。

如果您已將應用程式修訂版推送至 GitHub 儲存庫，並希望修訂版顯示在 CodeDeploy 主控台中或透過 顯示 AWS CLI，您也必須遵循下列步驟。

您只能使用 AWS CLI 或 CodeDeploy APIs 在 Amazon S3 或 GitHub 中註冊應用程式修訂版。

**Topics**
+ [在 Amazon S3 中向 CodeDeploy (CLI) 註冊修訂版](#application-revisions-register-s3)
+ [在 GitHub 中向 CodeDeploy (CLI) 註冊修訂](#application-revisions-register-github)

## 在 Amazon S3 中向 CodeDeploy (CLI) 註冊修訂版
<a name="application-revisions-register-s3"></a>

1. 將修訂版上傳至 Amazon S3。

1. 呼叫 [register-application-revision](https://docs.aws.amazon.com/cli/latest/reference/deploy/register-application-revision.html) 命令，指定：
   + 應用程式名稱。若要檢視應用程式名稱清單，請呼叫 [list-applications](https://docs.aws.amazon.com/cli/latest/reference/deploy/list-applications.html) 命令。
   + 要註冊之修訂的資訊：
     + 包含修訂的 Amazon S3 儲存貯體名稱。
     + 上傳的修訂名稱和檔案類型。對於 AWS Lambda 部署，修訂是以 JSON 或 YAML 撰寫的 AppSpec 檔案。對於 EC2/現場部署，修訂版包含 CodeDeploy 將部署到執行個體的來源檔案版本，或 CodeDeploy 將在執行個體上執行的指令碼。
**注意**  
Windows Server 執行個體不支援 tar 和壓縮 tar 封存檔案格式 (.tar 和 .tar.gz)。
     + （選用） 修訂版的 Amazon S3 版本識別符。（如果未指定版本識別符，CodeDeploy 將使用最新版本。)
     + (選用) 修訂的 ETag。（如果未指定 ETag，CodeDeploy 會略過物件驗證。)
   + 您希望將其與修訂建立關聯的任何描述。

可以在命令列上指定 Amazon S3 中修訂的相關資訊，使用此語法做為**register-application-revision**呼叫的一部分。(`version` 和 `eTag`是選用的。)

對於 EC2/現場部署的修訂檔案：

```
--s3-location bucket=string,key=string,bundleType=tar|tgz|zip,version=string,eTag=string
```

對於 AWS Lambda 部署的修訂檔案：

```
--s3-location bucket=string,key=string,bundleType=JSON|YAML,version=string,eTag=string
```

## 在 GitHub 中向 CodeDeploy (CLI) 註冊修訂
<a name="application-revisions-register-github"></a>

**注意**  
AWS Lambda 部署不適用於 GitHub。

1. 將修訂上傳至您的 GitHub 儲存庫。

1. 呼叫 [register-application-revision](https://docs.aws.amazon.com/cli/latest/reference/deploy/register-application-revision.html) 命令，指定：
   + 應用程式名稱。若要檢視應用程式名稱清單，請呼叫 [list-applications](https://docs.aws.amazon.com/cli/latest/reference/deploy/list-applications.html) 命令。
   + 要註冊之修訂的資訊：
     + 指派至包含修訂之儲存庫中的 GitHub 使用者或群組名稱，後面接著正斜線 (`/`) 和儲存庫名稱。
     + 遞交的 ID，此 ID 會參考儲存庫中的修訂。
   + 您希望將其與修訂建立關聯的任何描述。

可以在命令列上，使用此語法做為 **register-application-revision** 呼叫的一部分，來指定 GitHub 中修訂的資訊：

```
--github-location repository=string,commitId=string
```