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

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

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

將應用程式原始碼套件從初始化專案目錄部署至執行中的應用程式。

若已安裝 git，則 EB CLI 會根據最近的 `git archive` 命令的內容，使用 `.zip` 命令來建立 `git commit` 檔案。

然而，當 `.ebignore` 存在於您的專案目錄時，EB CLI 不會使用 git 命令和語義來建立您的原始碼套件。這表示 EB CLI 會忽略 `.ebignore` 指定的檔案，並納入所有其他檔案，尤其是未遞交的來源檔案。

**注意**  
您亦可設定 EB CLI 從建置程序部署組建成品，而非建立您專案資料夾的 ZIP 檔案。如需詳細資訊，請參閱 [部署成品而非專案資料夾](eb-cli3-configuration.md#eb-cli3-artifact)。

## 語法
<a name="eb3-deploysyntax"></a>

 **eb deploy** 

 **eb deploy {{environment-name}}** 

## 選項
<a name="eb3-deployoptions"></a>


****  

|  名稱  |  描述  | 
| --- | --- | 
| `-l` {{version\_label}}<br />或<br />`--label` {{version\_label}} | 指定用於 EB CLI 建立的版本的標籤。若已使用該標籤，EB CLI 會重新部署使用該標籤的之前版本。<br />類型：字串 | 
| --env-group-suffix {{groupname}} | 欲附加至環境名稱的群組名稱。僅能搭配 [編寫環境](ebcli-compose.md) 使用。 | 
| `-m` "{{version\_description}}"<br />或<br />`--message` "{{version\_description}}" | 應用程式版本的描述，以雙引號括住。<br />類型：字串 | 
| `--modules` {{component-a component-b}} | 欲更新元件的清單。僅能搭配 [編寫環境](ebcli-compose.md) 使用。 | 
| `-p`<br />或<br />`--process` | 預處理並驗證原始碼套件中的環境資訊清單和組態檔案。驗證組態檔案可在將應用程式版本部署至環境前辨識問題。 | 
| `--source codecommit/{{repository-name}}/{{branch-name}}` | CodeCommit 儲存庫和分支。 | 
| `--staged` | 部署暫存於 git 索引的檔案，而非 HEAD 遞交的檔案。 | 
| `--timeout` {{分鐘}} | 命令逾時前的分鐘數。 | 
| `--version` {{version\_label}} | 欲部署的現有應用程式版本。<br />類型：字串 | 
| [常用選項](eb3-cmd-options.md) |  | 

## Output
<a name="eb3-deployoutput"></a>

若成功，本命令會回傳 `deploy` 操作的狀態。

若您已在應用程式啟用 CodeBuild 支援，**eb deploy** 會在您建置程式碼時顯示 CodeBuild 的資訊。如需 Elastic Beanstalk 中 CodeBuild 支援的詳細資訊，請參閱[搭配 使用 EB CLI AWS CodeBuild](eb-cli-codebuild.md)。

## 範例
<a name="eb3-deployexample"></a>

下列範例會部署現行應用程式。

```
$ eb deploy
2018-07-11 21:05:22    INFO: Environment update is starting.
2018-07-11 21:05:27    INFO: Deploying new version to instance(s).
2018-07-11 21:05:53    INFO: New application version was deployed to running EC2 instances.
2018-07-11 21:05:53    INFO: Environment update completed successfully.
```