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

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