# AWS Toolkit for JetBrains 的使用者界面參考
<a name="ui-reference"></a>

如需使用 AWS Toolkit for JetBrains 使用者介面方面的協助，請參閱下列主題。

**Topics**
+ [AWS Explorer](aws-explorer.md)
+ [建立函數對話方塊](create-function-dialog.md)
+ [「部署無伺服器應用程式」對話方塊](deploy-serverless-application-dialog.md)
+ [New Project (新增專案) 對話方塊](new-project-dialog.md)
+ [「執行/偵錯組態」對話方塊](run-debug-configurations-dialog.md)
+ [「更新程式碼」對話方塊](update-code-dialog.md)
+ [「更新組態」對話方塊](update-configuration-dialog.md)

# AWS Explorer
<a name="aws-explorer"></a>

AWS Explorer 可讓您在 AWS Toolkit for JetBrains 中便利地存取數種功能。這些功能包含管理工具組到 AWS 帳戶的連線、切換 AWS 區域、使用帳戶中的 AWS Lambda 函數和 AWS CloudFormation 堆疊等。

若要，使用安裝的 AWS Toolkit for JetBrains 透過執行中的 IntelliJ IDEA、PyCharm、WebStorm 或 JetBrains Rider 開啟 AWS Explorer，請執行以下其中一項操作：
+ 在工具視窗列上，選擇 **AWS Explorer**。  
![\[AWS Explorer 工具視窗按鈕。\]](http://docs.aws.amazon.com/zh_tw/toolkit-for-jetbrains/latest/userguide/images/aws-explorer-tool-window-button.png)
+ 在主選單上，選擇 **View (檢視)**、**Tool Windows (工具視窗)**、**AWS Explorer**。  
![\[從主選單開啟 AWS Explorer。\]](http://docs.aws.amazon.com/zh_tw/toolkit-for-jetbrains/latest/userguide/images/aws-explorer-main-menu.png)

在 **AWS Explorer** 中，選擇下列項目的設定圖示 (**顯示選項選單**)：

![\[AWS Explorer 顯示選項選單。\]](http://docs.aws.amazon.com/zh_tw/toolkit-for-jetbrains/latest/userguide/images/aws-explorer.png)


**AWS 連線設定**  
包含下列選項：  
+ **AWS 區域清單**：AWS Toolkit for JetBrains 使用特定的區域。如要讓工具組改用不同的區域，請選擇其他列出的區域。
+ **最近的憑證清單**：列出最近從 AWS Toolkit for JetBrains 建立的 AWS 帳戶連線。工具組會使用選取的連線。如要讓工具組改用不同的最近連線，請選擇連線名稱。
+ **所有憑證**：列出您可以從 AWS Toolkit for JetBrains 連線到 AWS 帳戶的所有可用連線。工具組會使用選取的連線。如要讓工具組改用不同的連線，請選擇連線名稱。若要執行其他連線工作，請選擇 **AWS 編輯憑證檔案**。
狀態欄中的 **AWS 連線設定**區域顯示 AWS Toolkit for JetBrains 目前正在使用的 AWS 帳戶連線和區域。  

![\[狀態列中的「AWS 連線設定」區域。\]](http://docs.aws.amazon.com/zh_tw/toolkit-for-jetbrains/latest/userguide/images/aws-connection-settings.png)

選擇此區域以檢視與**顯示選項選單**相同的 **AWS 連線設定**選項。

**檢視文件**  
前往《AWS Toolkit for JetBrains 使用者指南》[https://docs.aws.amazon.com/toolkit-for-jetbrains/latest/userguide/](https://docs.aws.amazon.com/toolkit-for-jetbrains/latest/userguide/) (本指南)。

**在 GitHub 上檢視來源**  
前往 GitHub 網站上的 [aws/aws-toolkit-jetbrains](https://github.com/aws/aws-toolkit-jetbrains) 儲存庫。

**檢視模式**  
調整 **AWS Explorer** 工具視窗，讓您可以在使用編輯器或其他工具視窗時快速地進行存取及節省空間。  
針對 IntelliJ IDEA 檢視模式，請參閱 IntelliJ IDEA 說明網站上的[工具視窗檢視模式](https://www.jetbrains.com/help/idea/viewing-modes.html)。  
針對 PyCharm 檢視模式，請參閱 PyCharm 說明網站上的[工具視窗檢視模式](https://www.jetbrains.com/help/pycharm/viewing-modes.html)。  
針對 WebStorm 檢視模式，請參閱 WebStorm 說明網站上的[工具視窗檢視模式](https://www.jetbrains.com/help/webstorm/viewing-modes.html)。  
針對 JetBrains Rider 檢視模式，請參閱 JetBrains Rider 說明網站上的[工具視窗檢視模式](https://www.jetbrains.com/help/rider/Viewing_Modes.html)。

**移動到**  
將 **AWS Explorer** 工具視窗移到 IntelliJ IDEA、PyCharm、WebStorm 或 JetBrains Rider 中的不同位置。

**調整大小**  
變更 **AWS Explorer** 工具視窗的大小。

**從側邊欄移除**  
從工具視窗列中移除 **AWS Explorer** 工具視窗。如要再次顯示，請在主選單列上，選擇 **View (檢視)**、**Tool Windows (工具視窗)**、**AWS Explorer**。

您也可以透過 AWS Explorer 使用 Lambda 函數，並搭配 AWS 帳戶中的 AWS CloudFormation 堆疊。

# 建立函數對話方塊
<a name="create-function-dialog"></a>

您建立獨立 AWS Lambda 函數時，AWS Toolkit for JetBrains 中會顯示**建立函數**對話方塊。

![\[「建立函數」對話方塊。\]](http://docs.aws.amazon.com/zh_tw/toolkit-for-jetbrains/latest/userguide/images/create-function-dialog.png)


**建立函數**對話方塊包含下列項目：

**名稱**  
(必要) 函數的名稱。只能包含大寫字母 `A` 到 `Z`、小寫字母 `a` 到 `z`、數字 `0` 到 `9`、連字號 (`-`) 和底線 (`_`)。名稱長度必須小於 64 個字元。

**描述**  
(選用) 任何與函數相關的有意義描述。

**處理常式**  
(必要) [Java](https://docs.aws.amazon.com/lambda/latest/dg/java-handler.html)、[Python](https://docs.aws.amazon.com/lambda/latest/dg/python-handler.html)、[Node.js](https://docs.aws.amazon.com/lambda/latest/dg/nodejs-handler.html) 或 [C\$1](https://docs.aws.amazon.com/lambda/latest/dg/csharp-handler.html) 對應函數處理常式 ID。

**執行期**  
(必要) 要使用的 [Lambda 執行期](https://docs.aws.amazon.com/lambda/latest/dg/lambda-runtimes.html) ID。

**逾時 (秒)**  
(必要) Lambda 在停止函數前允許函數執行的時間。指定最多 900 秒 (15 分鐘) 的長度。

**記憶體 (MB)**  
(必要) 可供函數在執行時使用的記憶體量。指定[介於 128 MB 和 3,008 MB](https://docs.aws.amazon.com/lambda/latest/dg/gettingstarted-limits.html) 間的數量 (以 64 MB 遞增)。

**環境變數**  
(選用) Lambda 函數要使用的任何[環境變數](https://docs.aws.amazon.com/lambda/latest/dg/configuration-envvars.html)，需透過鍵/值對指定。如要新增、變更或刪除環境變數，請選擇資料夾圖示，然後遵循畫面上的說明。

**IAM 角色**  
(必要) 選擇已連線的 AWS 帳戶中 Lambda 要用於函數的可用 [Lambda 執行角色](https://docs.aws.amazon.com/lambda/latest/dg/lambda-intro-execution-role.html)。如要在帳戶中建立執行角色並改讓 Lambda 使用該角色，請選擇**建立**，然後遵循畫面上的說明操作。

**啟用 AWS X-Ray**  
(選用) 如果選取此項，[Lambda 會啟用 AWS X-Ray](https://docs.aws.amazon.com/lambda/latest/dg/services-xray.html) 來偵測、分析和最佳化函數的效能問題。X-Ray 會向 Lambda 及任何構成函數的上下游服務收集中繼資料。X-Ray 會使用這些中繼資料產生詳細的服務圖表，呈現效能瓶頸、延遲高峰以及其他會影響函數效能的問題。

**來源儲存貯體**  
(必要) 選擇已連線 AWS 帳戶中的現有 Amazon Simple Storage Service (Amazon S3) 儲存貯體，讓 AWS Serverless Application Model (AWS SAM) 命令列介面 (CLI) 用於將函數部署到 Lambda。如要在帳戶中建立 Amazon S3 儲存貯體並讓 AWS SAM CLI 使用儲存貯體，請選擇**建立**，然後依照畫面上的說明操作。

# 「部署無伺服器應用程式」對話方塊
<a name="deploy-serverless-application-dialog"></a>

在您部署 AWS 無伺服器應用程式時，AWS Toolkit for JetBrains 中會顯示**部署無伺服器應用**對話方塊。

![\[「部署無伺服器應用程式」對話方塊。\]](http://docs.aws.amazon.com/zh_tw/toolkit-for-jetbrains/latest/userguide/images/sam-deploy.png)


**部署無伺服器應用程式**對話方塊包含下列項目：

**建立堆疊**  
(必要) 提供堆疊的名稱，讓 AWS Serverless Application Model (AWS SAM) 命令列界面 (CLI) 在 AWS CloudFormation 中為已連線的 AWS 帳戶建立。AWS SAM CLI 接著會使用此堆疊來部署 AWS 無伺服器應用程式。

**更新堆疊**  
(必要) 選擇已連線 AWS 帳戶中的現有 CloudFormation 堆疊名稱，讓 AWS SAM CLI 用於部署 AWS 無伺服器應用程式。

**注意**  
**建立堆疊**或**更新堆疊**其中一項為必要，但不能同時使用兩者。

**範本參數**  
(選用) 在對應專案 `template.yaml` 檔案中偵測到的任何 AWS Toolkit for JetBrains 參數。如要指定參數的值，請選擇參數旁邊的 **Value (值)** 欄、輸入值，然後按 **Enter**。如需更多詳細資訊，請參閱 [https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/parameters-section-structure.html](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/parameters-section-structure.html) 使用者指南*中的AWS CloudFormation參數*部分。

**S3 儲存貯體**  
(必要) 選擇已連線 AWS 帳戶中的現有 Amazon Simple Storage Service (Amazon S3) 儲存貯體，讓 AWS SAM CLI 用來部署 AWS 無伺服器應用程式。如要在帳戶中建立 Amazon S3 儲存貯體並讓 AWS SAM CLI 改用該儲存貯體，選擇**建立**，然後依照畫面上的說明操作。

**ECR 儲存庫**  
(僅對 `Image` 套件類型必要) 選擇已連線 AWS 帳戶中的現有 Amazon Elastic Container Registry (Amazon ECR) 儲存庫，讓 AWS SAM CLI 用來部署 AWS 無伺服器應用程式。如需 AWS Lambda 套件類型的詳細資訊，請參閱《AWS Lambda 開發人員指南》**中的[ Lambda 部署套件](https://docs.aws.amazon.com/lambda/latest/dg/gettingstarted-package.html)。

**部署前需要確認**  
(選用) 如果選取此項目，系統會指示 CloudFormation [在 CloudFormation 中執行堆疊目前的變更集](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-changesets-execute.html)，等待您完成建立或更新對應的堆疊。如果沒有執行此變更集，AWS 無伺服器應用程式便不會移至部署階段。

**在容器內建置函數**  
(選用) 如果選取此項目，AWS SAM CLI 會先在 Lambda 式的 Docker 容器內部於本機建置任何無伺服器應用程式的函數，再進行部署。這在函數依賴包含原生編譯相依性或程式的套件時相當實用。如需詳細資訊，請參閱 *AWS Serverless Application Model 開發人員指南*中的[建置應用程式](https://docs.aws.amazon.com/serverless-application-model/latest/developerguide/serverless-sam-cli-using-build.html)。

# New Project (新增專案) 對話方塊
<a name="new-project-dialog"></a>

當您建立 AWS 無伺服器應用程式時，AWS Toolkit for JetBrains 中會顯示**新增專案**對話方塊。

**Topics**
+ [新增專案對話方塊 (IntelliJ IDEA、PyCharm 和 WebStorm)](#new-project-dialog-intellij)
+ [「新增專案」對話方塊 (JetBrains Rider)](#new-project-dialog-rider)

## 新增專案對話方塊 (IntelliJ IDEA、PyCharm 和 WebStorm)
<a name="new-project-dialog-intellij"></a>



**注意**  
以下螢幕擷取畫面顯示 IntelliJ IDEA 的**新增專案**對話方塊，但欄位描述也適用於 PyCharm 和 WebStorm。

![\[IntelliJ IDEA 的「新增專案」對話方塊。\]](http://docs.aws.amazon.com/zh_tw/toolkit-for-jetbrains/latest/userguide/images/sam-create-images.png)


**新增專案**對話方塊包含下列項目：

**專案名稱**  
(必要) 專案的名稱。

**專案位置**  
(必要) IntelliJ IDEA 建立專案的位置。

**套件類型**  
(必要) AWS Lambda 函數的部署套件類型，可以是 `Zip` 或 `Image`。如需了解 `Zip` 和 `Image` 套件類型的差異，請參閱《AWS Lambda 開發人員指南》**中的 [Lambda 部署套件](https://docs.aws.amazon.com/lambda/latest/dg/gettingstarted-package.html)。

**執行期**  
(必要) 要使用的 [Lambda 執行期](https://docs.aws.amazon.com/lambda/latest/dg/lambda-runtimes.html) ID。

**SAM 範本**  
(必要) 要使用的 AWS Serverless Application Model (AWS SAM) 範本名稱。

**專案開發套件**  
(必要) 要使用的 Java 開發套件 (JDK)。如需詳細資訊，請參閱IntelliJ IDEA 說明網站上的 [Java Development Kit (JDK)](https://www.jetbrains.com/help/idea/sdk.html#jdk)。

## 「新增專案」對話方塊 (JetBrains Rider)
<a name="new-project-dialog-rider"></a>

**注意**  
在您建立新的解決方案時，此對話方塊的標題會是**新增解決方案**而非**新增專案**。但是，對話方塊的內容是相同的。

![\[JetBrains Rider 的「新增專案」對話方塊。\]](http://docs.aws.amazon.com/zh_tw/toolkit-for-jetbrains/latest/userguide/images/sam-create-images-rider.png)


**新增專案**對話方塊包含下列項目：

**解決方案名稱**  
(必要) 解決方案的名稱。

**專案名稱**  
(必要) 專案的名稱。

**解決方案目錄**  
(必要) 解決方案目錄的路徑。

**將解決方案和專案放在同一個目錄**  
(選用) 如果選取此選項，則會將解決方案的檔案放在與專案檔案相同的位置。

**建立儲存庫**  
(選用) 如果選取此選項，則會使用指定的提供者為專案建立遠端儲存庫。

**套件類型**  
(必要) Lambda 函數的套件類型，可以是 `Zip` 或 `Image`。如需了解 `Zip` 和 `Image` 套件類型的差異，請參閱《AWS Lambda 開發人員指南》**中的 [Lambda 部署套件](https://docs.aws.amazon.com/lambda/latest/dg/gettingstarted-package.html)。

**執行期**  
(必要) 要使用的 Lambda 執行期 ID。

**SAM 範本**  
(必要) 要使用的 AWS SAM 範本名稱。

**產生的專案結構**  
(不可編輯) 建立的專案目錄和檔案的路徑。

# 「執行/偵錯組態」對話方塊
<a name="run-debug-configurations-dialog"></a>

每當您要在本機、遠端或 Amazon Elastic Container Service (Amazon ECS) 叢集中變更執行/偵錯組態，AWS Toolkit for JetBrains 中都會顯示**執行/偵錯**對話方塊。

**Topics**
+ [「執行/偵錯組態」對話方塊 (本機函數設定)](run-debug-configurations-dialog-local.md)
+ [「執行/偵錯組態」對話方塊 (遠端函數設定)](run-debug-configurations-dialog-remote.md)
+ [「編輯組態」對話方塊 (Amazon ECS 叢集)](edit-configuration-dialog-ecs.md)

# 「執行/偵錯組態」對話方塊 (本機函數設定)
<a name="run-debug-configurations-dialog-local"></a>

每當您更新 AWS Lambda 函數的*本機*版本設定時，都會顯示此對話方塊。

**注意**  
如要變更相同函數 (函數的原始碼位於 AWS 帳戶的 Lambda 中) *遠端*版本的設定，請改為參閱：[「執行/偵錯組態」對話方塊 (遠端函數設定)](run-debug-configurations-dialog-remote.md)。

這個對話方塊包含三個索引標籤：**組態**、**SAM CLI** 和 **AWS 連線**。

![\[「執行/偵錯組態」對話方塊中「組態」索引標籤的本機函數設定。\]](http://docs.aws.amazon.com/zh_tw/toolkit-for-jetbrains/latest/userguide/images/sam-run-debug-config-zip.png)


**執行/偵錯組態**對話方塊中**組態**索引標籤的本機函數設定包含以下項目：

**名稱**  
(必要) 此組態的名稱。

**允許平行執行 **  
(選用) 如果選取此選項，則允許 IntelliJ IDEA、PyCharm、 WebStorm 或 JetBrains Rider 視需要啟動任意數量的組態執行個體並同時執行。1

**從處理常式/從範本**  
(必要) 根據您選擇的選項，必須進行其他設定。

**執行期**  
(必要) 要使用的 [Lambda 執行期](https://docs.aws.amazon.com/lambda/latest/dg/lambda-runtimes.html) ID。

**處理常式**  
(選擇**從處理常式**選項時必要) [Java](https://docs.aws.amazon.com/lambda/latest/dg/java-handler.html)、[Python](https://docs.aws.amazon.com/lambda/latest/dg/python-handler.html)、[Node.js](https://docs.aws.amazon.com/lambda/latest/dg/nodejs-handler.html) 或 [C\$1](https://docs.aws.amazon.com/lambda/latest/dg/csharp-handler.html) 對應函數處理常式的 ID。

**逾時 (秒)**  
(選擇**從處理常式**選項時必要) Lambda 在停止函數前允許函數執行的時間。指定最多 900 秒 (15 分鐘) 的長度。

**記憶體 (MB)**  
(選擇**從處理常式**選項時必要) 可供函數在執行時使用的記憶體量。指定[介於 128 MB 和 3,008 MB](https://docs.aws.amazon.com/lambda/latest/dg/gettingstarted-limits.html) 間的數量 (以 64 MB 遞增)。

**環境變數**  
(選擇**從處理常式**選項時選用) 任何供Lambda 函數使用的[環境變數](https://docs.aws.amazon.com/lambda/latest/dg/configuration-envvars.html)，以索引鍵值對指定。如要新增、變更或刪除環境變數，請選擇資料夾圖示，然後遵循畫面上的說明。

**Template**  
(選擇**從範本**選項時必要) 要用於此組態的 AWS Serverless Application Model (AWS SAM) 範本位置和檔案名稱 (例如 `template.yaml`)，以及範本中要和此組態建立關聯的資源。

**檔案**  
(必要)要傳遞到函數的事件資料位置和檔案名稱 (JSON 格式)。如需事件資料範例，請參閱《AWS Lambda 開發人員指南》*中的[調用 Lambda 函數](https://docs.aws.amazon.com/lambda/latest/dg/getting-started-create-function.html#get-started-invoke-manually)*和《AWS Serverless Application Model 開發人員指南》**中的[產生範例事件承載](https://docs.aws.amazon.com/serverless-application-model/latest/developerguide/serverless-sam-cli-using-generate-event.html)。

**文字**  
(必要) 要傳遞到函數的事件資料 (JSON 格式)。如需事件資料範例，請參閱《AWS Lambda 開發人員指南》*中的[調用 Lambda 函數](https://docs.aws.amazon.com/lambda/latest/dg/getting-started-create-function.html#get-started-invoke-manually)*和《AWS Serverless Application Model 開發人員指南》**中的[產生範例事件承載](https://docs.aws.amazon.com/serverless-application-model/latest/developerguide/serverless-sam-cli-using-generate-event.html)。  
**檔案**或**文字**必要 (但不能同時使用兩者)。

**「啟動前:」視窗**  
(選用) 列出任何在啟動此組態前必須執行的任務。2

***備註***  
1 如需詳細資訊，請參閱下列內容：  
+ 如果使用 IntelliJ IDEA，請參閱 IntelliJ IDEA 說明網站上的[常用選項](https://www.jetbrains.com/help/idea/run-debug-configurations-dialog.html#common)。
+ 如果使用 PyCharm，請參閱 PyCharm 說明網站上的[常用選項](https://www.jetbrains.com/help/pycharm/run-debug-configurations-dialog.html#common)。
+ 如果使用 WebStorm，請參閱 WebStorm 說明網站上的[常用選項](https://www.jetbrains.com/help/webstorm/run-debug-configuration-node-js.html#common)。
+ 如果使用 JetBrains Rider，請參閱 JetBrains Rider 說明網站上的[常用選項](https://www.jetbrains.com/help/rider/Run_Debug_Configurations_dialog.html#common)。
2 如需詳細資訊，請參閱下列內容：  
+ 如果使用 IntelliJ IDEA，請參閱 IntelliJ IDEA 說明網站上的[啟動前選項](https://www.jetbrains.com/help/idea/run-debug-configurations-dialog.html#before-launch-options)。
+ 如果使用 PyCharm，請參閱 PyCharm 說明網站上的[啟動前選項](https://www.jetbrains.com/help/pycharm/run-debug-configurations-dialog.html#before-launch-options)。
+ 如果使用 WebStorm，請參閱 WebStorm 說明網站上的[啟動前選項](https://www.jetbrains.com/help/webstorm/run-debug-configuration-node-js.html#before-launch-options)。
+ 如果使用 JetBrains Rider，請參閱 JetBrains Rider 說明網站上的[啟動前選項](https://www.jetbrains.com/help/rider/Run_Debug_Configurations_dialog.html#before-launch-options)。

![\[「執行/偵錯組態」對話方塊中 SAM CLI 索引標籤的本機函數設定。\]](http://docs.aws.amazon.com/zh_tw/toolkit-for-jetbrains/latest/userguide/images/sam-run-debug-cli.png)


**執行/偵錯組態**對話方塊中 **SAM CLI** 索引標籤的本機函數設定包含以下項目：

**名稱**  
(必要) 此組態的名稱。

**允許平行執行**  
(選用) 如果選取此選項，則允許 IntelliJ IDEA、PyCharm、 WebStorm 或 JetBrains Rider 視需要啟動任意數量的組態執行個體並同時執行。1

**在容器內建置函數**  
(選用) 如果選取此項目，AWS SAM CLI 會先在 Lambda 式的 Docker 容器內部於本機建置任何無伺服器應用程式的函數，再進行部署。這在函數依賴包含原生編譯相依性或程式的套件時相當實用。如需詳細資訊，請參閱 *AWS Serverless Application Model 開發人員指南*中的[建置應用程式](https://docs.aws.amazon.com/serverless-application-model/latest/developerguide/serverless-sam-cli-using-build.html)。

**跳過檢查較新的容器映像**  
(選用) 如果選取此項目，AWS SAM CLI 會略過為[執行期](https://docs.aws.amazon.com/lambda/latest/dg/lambda-runtimes.html)取得在**組態**索引標籤上指定的最新 Docker 映像檔。

**Docker 網路**  
(選用) Lambda Docker 容器應連線到的現有 Docker 網路名稱或 ID，以及預設橋接網路。如果沒有指定，則 Lambda 容器只會連線到預設的橋接 Docker 網路。

**「啟動前:」視窗**  
(選用) 列出任何在啟動此組態前必須執行的任務。2

***備註***  
1 如需詳細資訊，請參閱下列內容：  
+ 如果使用 IntelliJ IDEA，請參閱 IntelliJ IDEA 說明網站上的[常用選項](https://www.jetbrains.com/help/idea/run-debug-configurations-dialog.html#common)。
+ 如果使用 PyCharm，請參閱 PyCharm 說明網站上的[常用選項](https://www.jetbrains.com/help/pycharm/run-debug-configurations-dialog.html#common)。
+ 如果使用 WebStorm，請參閱 WebStorm 說明網站上的[常用選項](https://www.jetbrains.com/help/webstorm/run-debug-configuration-node-js.html#common)。
+ 如果使用 JetBrains Rider，請參閱 JetBrains Rider 說明網站上的[常用選項](https://www.jetbrains.com/help/rider/Run_Debug_Configurations_dialog.html#common)。
2 如需詳細資訊，請參閱下列內容：  
+ 如果使用 IntelliJ IDEA，請參閱 IntelliJ IDEA 說明網站上的[啟動前選項](https://www.jetbrains.com/help/idea/run-debug-configurations-dialog.html#before-launch-options)。
+ 如果使用 PyCharm，請參閱 PyCharm 說明網站上的[啟動前選項](https://www.jetbrains.com/help/pycharm/run-debug-configurations-dialog.html#before-launch-options)。
+ 如果使用 WebStorm，請參閱 WebStorm 說明網站上的[啟動前選項](https://www.jetbrains.com/help/webstorm/run-debug-configuration-node-js.html#before-launch-options)。
+ 如果使用 JetBrains Rider，請參閱 JetBrains Rider 說明網站上的[啟動前選項](https://www.jetbrains.com/help/rider/Run_Debug_Configurations_dialog.html#before-launch-options)。

![\[「執行/偵錯組態」對話方塊中「AWS 連線」索引標籤的本機函數設定。\]](http://docs.aws.amazon.com/zh_tw/toolkit-for-jetbrains/latest/userguide/images/sam-run-debug-aws-connection.png)


**執行/偵錯組態**對話方塊中**AWS 連線**索引標籤的本機函數設定包含以下項目：

**憑證**  
(必要) 要使用的現有 AWS 帳戶連線名稱。

**區域**  
(必要) 要用於連線帳戶的 AWS 區域名稱。

***備註***  
1 如需詳細資訊，請參閱下列內容：  
+ 如果使用 IntelliJ IDEA，請參閱 IntelliJ IDEA 說明網站上的[常用選項](https://www.jetbrains.com/help/idea/run-debug-configurations-dialog.html#common)。
+ 如果使用 PyCharm，請參閱 PyCharm 說明網站上的[常用選項](https://www.jetbrains.com/help/pycharm/run-debug-configurations-dialog.html#common)。
+ 如果使用 WebStorm，請參閱 WebStorm 說明網站上的[常用選項](https://www.jetbrains.com/help/webstorm/run-debug-configuration-node-js.html#common)。
+ 如果使用 JetBrains Rider，請參閱 JetBrains Rider 說明網站上的[常用選項](https://www.jetbrains.com/help/rider/Run_Debug_Configurations_dialog.html#common)。
2 如需詳細資訊，請參閱下列內容：  
+ 如果使用 IntelliJ IDEA，請參閱 IntelliJ IDEA 說明網站上的[啟動前選項](https://www.jetbrains.com/help/idea/run-debug-configurations-dialog.html#before-launch-options)。
+ 如果使用 PyCharm，請參閱 PyCharm 說明網站上的[啟動前選項](https://www.jetbrains.com/help/pycharm/run-debug-configurations-dialog.html#before-launch-options)。
+ 如果使用 WebStorm，請參閱 WebStorm 說明網站上的[啟動前選項](https://www.jetbrains.com/help/webstorm/run-debug-configuration-node-js.html#before-launch-options)。
+ 如果使用 JetBrains Rider，請參閱 JetBrains Rider 說明網站上的[啟動前選項](https://www.jetbrains.com/help/rider/Run_Debug_Configurations_dialog.html#before-launch-options)。

# 「執行/偵錯組態」對話方塊 (遠端函數設定)
<a name="run-debug-configurations-dialog-remote"></a>

每當您更新 AWS Lambda 函數 (函數的原始碼位於 AWS 帳戶的 Lambda 中) *遠端*版本的設定時，都會顯示此對話方塊。

**注意**  
若要更新相同函數的*本機*版本設定，請改為參閱：[「執行/偵錯組態」對話方塊 (本機函數設定)](run-debug-configurations-dialog-local.md)。  
雖然對話方塊的名稱是**執行/偵錯組態**，但您無法使用 AWS Toolkit for JetBrains 來偵錯 Lambda 函數的遠端版本。您只能執行函數。

![\[顯示遠端函數設定的「執行/偵錯組態」對話方塊。\]](http://docs.aws.amazon.com/zh_tw/toolkit-for-jetbrains/latest/userguide/images/run-debug-configurations-dialog-remote.png)


**執行/偵錯組態**對話方塊中的遠端函數設定包含下列項目：

**名稱**  
(必要) 此組態的名稱。

**共享/透過 VCS 共享**  
(選用) 如果選取此項目，會將此組態開放給其他團隊成員使用。1

**允許平行執行 **  
(選用) 如果選取此選項，則允許 IntelliJ IDEA、PyCharm、 WebStorm 或 JetBrains Rider 視需要啟動任意數量的組態執行個體並同時執行。1

**憑證**  
(必要) 要使用的現有 AWS 帳戶連線名稱。

**區域**  
(必要) 要用於連線帳戶的 AWS 區域名稱。

**函數**  
(必要) 要使用的 Lambda 函數名稱。

**檔案**  
(必要)要傳遞到函數的事件資料位置和檔案名稱 (JSON 格式)。如需事件資料範例，請參閱《AWS Lambda 開發人員指南》*中的[調用 Lambda 函數](https://docs.aws.amazon.com/lambda/latest/dg/getting-started-create-function.html#get-started-invoke-manually)*和《AWS Serverless Application Model 開發人員指南》**中的[產生範例事件承載](https://docs.aws.amazon.com/serverless-application-model/latest/developerguide/serverless-sam-cli-using-generate-event.html)。

**文字**  
(必要) 要傳遞到函數的事件資料 (JSON 格式)。如需事件資料範例，請參閱《AWS Lambda 開發人員指南》*中的[調用 Lambda 函數](https://docs.aws.amazon.com/lambda/latest/dg/getting-started-create-function.html#get-started-invoke-manually)*和《AWS Serverless Application Model 開發人員指南》**中的[產生範例事件承載](https://docs.aws.amazon.com/serverless-application-model/latest/developerguide/serverless-sam-cli-using-generate-event.html)。

**注意**  
**檔案**或**文字**必要 (但不能同時使用兩者)。

**啟動前：啟動工具視窗**  
(選用) 列出任何在啟動此組態前必須執行的任務。2

**顯示此頁面**  
(選用) 如果選取此選項，系統會在啟動此組態之前顯示這些組態設定。2

**啟動工具視窗**  
(選用) 如果選取此選項，則當您啟動此組態時，會開啟**執行**或**偵錯**工具視窗。2

***備註***  
1 如需詳細資訊，請參閱下列內容：  
+ 如果使用 IntelliJ IDEA，請參閱 IntelliJ IDEA 說明網站上的[常用選項](https://www.jetbrains.com/help/idea/run-debug-configurations-dialog.html#common)。
+ 如果使用 PyCharm，請參閱 PyCharm 說明網站上的[常用選項](https://www.jetbrains.com/help/pycharm/run-debug-configurations-dialog.html#common)。
+ 如果使用 WebStorm，請參閱 WebStorm 說明網站上的[常用選項](https://www.jetbrains.com/help/webstorm/run-debug-configuration-node-js.html#common)。
+ 如果使用 JetBrains Rider，請參閱 JetBrains Rider 說明網站上的[常用選項](https://www.jetbrains.com/help/rider/Run_Debug_Configurations_dialog.html#common)。
2 如需詳細資訊，請參閱下列內容：  
+ 如果使用 IntelliJ IDEA，請參閱 IntelliJ IDEA 說明網站上的[啟動前選項](https://www.jetbrains.com/help/idea/run-debug-configurations-dialog.html#before-launch-options)。
+ 如果使用 PyCharm，請參閱 PyCharm 說明網站上的[啟動前選項](https://www.jetbrains.com/help/pycharm/run-debug-configurations-dialog.html#before-launch-options)。
+ 如果使用 WebStorm，請參閱 WebStorm 說明網站上的[啟動前選項](https://www.jetbrains.com/help/webstorm/run-debug-configuration-node-js.html#before-launch-options)。
+ 如果使用 JetBrains Rider，請參閱 JetBrains Rider 說明網站上的[啟動前選項](https://www.jetbrains.com/help/rider/Run_Debug_Configurations_dialog.html#before-launch-options)。

# 「編輯組態」對話方塊 (Amazon ECS 叢集)
<a name="edit-configuration-dialog-ecs"></a>

**編輯組態**對話方塊包含兩個索引標籤：**組態**和 **AWSSAM CLI**。

![\[「編輯組態」對話方塊的「組態」索引標籤。\]](http://docs.aws.amazon.com/zh_tw/toolkit-for-jetbrains/latest/userguide/images/edit-configuration-dialog-ecs-configuration.png)


**編輯組態**對話方塊的**組態**索引標籤中包含下列項目：

**名稱**  
(必要) 此組態的名稱。

**共享/透過 VCS 共享**  
(選用) 如果選取此項目，會將此組態開放給其他團隊成員使用。1

**允許平行執行**  
(選用) 如果選取此選項，則允許 IntelliJ IDEA、PyCharm、 WebStorm 或 JetBrains Rider 視需要啟動任意數量的組態執行個體並同時執行。1

**叢集**  
(必要) 要偵錯的 Amazon Elastic Container Service (Amazon ECS) 叢集名稱。

**服務**  
(必要) 叢集中要偵錯的 Amazon ECS 服務名稱。

**新增容器**  
將容器新增到此組態。如果至少有一個標籤已經可見，則為「選用」。每個標籤代表不同的容器。  
下列項目是用於選取的容器：**Platform (平台)**、**Remote Debug Port (遠端偵錯連接埠)**、**Start Command (啟動命令)**、**Artifacts Mappings (成品映射)** 和 **Port Mappings (連接埠映射)**。

**平台**  
(必要) 要使用的偵錯平台。

**遠端偵錯連接埠**  
(選用) 要連接偵錯工具的連接埠。一般而言，除非您的服務會使用連接埠 20020-20030，否則請勿指定此項目。如果使用該範圍的連接埠，請在此處指定連接埠，以避免容器嘗試繫結可能在別處使用的連接埠。

**啟動命令**  
(必要) 啟動程式的命令，讓偵錯工具可以進行連線。針對 Java，其開頭應為 `java`，且不包含任何偵錯工具資訊 (例如 `-Xdebug`)。針對 Python，其開頭應為 `python`、`python2` 或 `python3`，且其後跟隨要執行檔案的路徑和名稱。

**成品映射**  
(必要) 您本機開發機器上的**本機路徑**，映射到容器內的**遠端路徑**。所有要執行的程式碼和成品都必須進行映射才能執行。如要指定本機和遠端路徑映射，請選擇 **Add (新增)** (**\$1** 圖示)。

**連接埠映射**  
(選用) 您本機開發機器上的**本機連接埠**，映射到容器內的**遠端連接埠**。這可讓本機連接埠直接與遠端資源上的連接埠進行通訊。例如，針對命令 `curl localhost:3422`，連接埠 `3422` 會映射到某些服務。如要指定本機和遠端連接埠映射，請選擇 **Add (新增)** (**\$1** 圖示)。

**啟動前：啟動工具視窗**  
(選用) 列出任何在啟動此組態前必須執行的任務。2

**顯示此頁面**  
(選用) 如果選取此選項，則會在啟動此組態前顯示這些組態設定。2

**啟動工具視窗**  
(選用) 如果選取此選項，則當您啟動此組態時，會開啟**執行**或**偵錯**工具視窗。2

***備註***  
1 如需詳細資訊，請參閱下列內容：  
+ 如果使用 IntelliJ IDEA，請參閱 IntelliJ IDEA 說明網站上的[常用選項](https://www.jetbrains.com/help/idea/run-debug-configurations-dialog.html#common)。
+ 如果使用 PyCharm，請參閱 PyCharm 說明網站上的[常用選項](https://www.jetbrains.com/help/pycharm/run-debug-configurations-dialog.html#common)。
+ 如果使用 WebStorm，請參閱 WebStorm 說明網站上的[常用選項](https://www.jetbrains.com/help/webstorm/run-debug-configuration-node-js.html#common)。
+ 如果使用 JetBrains Rider，請參閱 JetBrains Rider 說明網站上的[常用選項](https://www.jetbrains.com/help/rider/Run_Debug_Configurations_dialog.html#common)。
2 如需詳細資訊，請參閱下列內容：  
+ 如果使用 IntelliJ IDEA，請參閱 IntelliJ IDEA 說明網站上的[啟動前選項](https://www.jetbrains.com/help/idea/run-debug-configurations-dialog.html#before-launch-options)。
+ 如果使用 PyCharm，請參閱 PyCharm 說明網站上的[啟動前選項](https://www.jetbrains.com/help/pycharm/run-debug-configurations-dialog.html#before-launch-options)。
+ 如果使用 WebStorm，請參閱 WebStorm 說明網站上的[啟動前選項](https://www.jetbrains.com/help/webstorm/run-debug-configuration-node-js.html#before-launch-options)。
+ 如果使用 JetBrains Rider，請參閱 JetBrains Rider 說明網站上的[啟動前選項](https://www.jetbrains.com/help/rider/Run_Debug_Configurations_dialog.html#before-launch-options)。

![\[「編輯組態」對話方塊的「AWS 連線」索引標籤。\]](http://docs.aws.amazon.com/zh_tw/toolkit-for-jetbrains/latest/userguide/images/edit-configuration-dialog-ecs-aws-connection.png)


**編輯組態**對話方塊的 **AWS 連線**索引標籤中包含下列項目：

**名稱**  
(必要) 此組態的名稱。

**憑證**  
(必要) 要使用的現有 AWS 帳戶連線名稱。

**區域**  
(必要) 要用於連線帳戶的 AWS 區域名稱。

**共享/透過 VCS 共享**  
(選用) 如果選取此項目，會將此組態開放給其他團隊成員使用。1

**允許平行執行**  
(選用) 如果選取此選項，則允許 IntelliJ IDEA、PyCharm、 WebStorm 或 JetBrains Rider 視需要啟動任意數量的組態執行個體並同時執行。1

**啟動前：啟動工具視窗**  
(選用) 列出任何在啟動此組態前必須執行的任務。2

**顯示此頁面**  
(選用) 如果選取此選項，則會在啟動此組態前顯示這些組態設定。2

**啟動工具視窗**  
(選用) 如果選取此選項，則當您啟動此組態時，會開啟**執行**或**偵錯**工具視窗。2

***備註***  
1 如需詳細資訊，請參閱下列內容：  
+ 如果使用 IntelliJ IDEA，請參閱 IntelliJ IDEA 說明網站上的[常用選項](https://www.jetbrains.com/help/idea/run-debug-configurations-dialog.html#common)。
+ 如果使用 PyCharm，請參閱 PyCharm 說明網站上的[常用選項](https://www.jetbrains.com/help/pycharm/run-debug-configurations-dialog.html#common)。
+ 如果使用 WebStorm，請參閱 WebStorm 說明網站上的[常用選項](https://www.jetbrains.com/help/webstorm/run-debug-configuration-node-js.html#common)。
+ 如果使用 JetBrains Rider，請參閱 JetBrains Rider 說明網站上的[常用選項](https://www.jetbrains.com/help/rider/Run_Debug_Configurations_dialog.html#common)。
2 如需詳細資訊，請參閱下列內容：  
+ 如果使用 IntelliJ IDEA，請參閱 IntelliJ IDEA 說明網站上的[啟動前選項](https://www.jetbrains.com/help/idea/run-debug-configurations-dialog.html#before-launch-options)。
+ 如果使用 PyCharm，請參閱 PyCharm 說明網站上的[啟動前選項](https://www.jetbrains.com/help/pycharm/run-debug-configurations-dialog.html#before-launch-options)。
+ 如果使用 WebStorm，請參閱 WebStorm 說明網站上的[啟動前選項](https://www.jetbrains.com/help/webstorm/run-debug-configuration-node-js.html#before-launch-options)。
+ 如果使用 JetBrains Rider，請參閱 JetBrains Rider 說明網站上的[啟動前選項](https://www.jetbrains.com/help/rider/Run_Debug_Configurations_dialog.html#before-launch-options)。

# 「更新程式碼」對話方塊
<a name="update-code-dialog"></a>

每當您更新 AWS Lambda 函數時，AWS Toolkit for JetBrains 中的**更新程式碼**對話方塊都會顯示。

![\[「更新程式碼」對話方塊。\]](http://docs.aws.amazon.com/zh_tw/toolkit-for-jetbrains/latest/userguide/images/sam-update-code.png)


**更新程式碼**對話方塊包含下列項目：

**處理常式**  
(必要) [Java](https://docs.aws.amazon.com/lambda/latest/dg/java-handler.html)、[Python](https://docs.aws.amazon.com/lambda/latest/dg/python-handler.html)、[Node.js](https://docs.aws.amazon.com/lambda/latest/dg/nodejs-handler.html) 或 [C\$1](https://docs.aws.amazon.com/lambda/latest/dg/csharp-handler.html) 對應 Lambda 函數處理常式 ID。

**來源儲存貯體**  
(僅對 `Zip` 套件類型必要) 選擇已連線 AWS 帳戶中的現有 Amazon Simple Storage Service (Amazon S3) 儲存貯體，讓 AWS Serverless Application Model (AWS SAM) 命令列介面 (CLI) 用於將函數部署到 Lambda。如要在帳戶中建立 Amazon S3 儲存貯體並讓 AWS SAM CLI 改用該儲存貯體，選擇**建立**，然後依照畫面上的說明操作。如需 Lambda 套件類型的詳細資訊，請參閱《AWS Lambda 開發人員指南》**中的 [Lambda 部署套件](https://docs.aws.amazon.com/lambda/latest/dg/gettingstarted-package.html)。

**ECR 儲存庫**  
(僅對 `Image` 套件類型必要) 選擇已連線 AWS 帳戶中的現有 Amazon Elastic Container Registry (Amazon ECR) 儲存庫，讓 AWS SAM CLI 用來將函數部署到 Lambda。

# 「更新組態」對話方塊
<a name="update-configuration-dialog"></a>

每當您更新 AWS Lambda 函數的組態時，AWS Toolkit for JetBrains 中的**更新組態**對話方塊都會顯示。根據專案的 Lambda 函數是否為套件類型 `Zip` 或 `Image`，您提供的資訊會略有不同。

`Zip` 套件類型的**更新組態**對話方塊：

![\[Zip 應用程式的「更新組態」對話方塊。\]](http://docs.aws.amazon.com/zh_tw/toolkit-for-jetbrains/latest/userguide/images/sam-update-config-zip.png)


`Image` 套件類型的**更新組態**對話方塊：

![\[影像應用程式的「更新組態」對話方塊。\]](http://docs.aws.amazon.com/zh_tw/toolkit-for-jetbrains/latest/userguide/images/sam-update-config-image.png)


**更新組態**對話方塊包含下列項目：

**名稱**  
(必要) 函數的名稱。僅能包含大寫字母 `A` 到 `Z`、小寫字母 `a` 到 `z`、數字 `0` 到 `9`、連字號 (`-`) 和底線 (`_`)。名稱長度必須小於 64 個字元。

**描述**  
(選用) 任何與函數相關的有意義描述。

**套件類型**  
(必要) Lambda 函數的套件類型，可以是 `Zip` 或 `Image`。

**處理常式**  
(僅對 `Zip` 套件為必要) [Java](https://docs.aws.amazon.com/lambda/latest/dg/java-handler.html)、[Python](https://docs.aws.amazon.com/lambda/latest/dg/python-handler.html)、[Node.js](https://docs.aws.amazon.com/lambda/latest/dg/nodejs-handler.html) 或 [C＃](https://docs.aws.amazon.com/lambda/latest/dg/csharp-handler.html) 的對應 Lambda 函數處理常式 ID。

**執行期**  
(僅對 `Zip` 套件為必要) 要使用的 [Lambda 執行期](https://docs.aws.amazon.com/lambda/latest/dg/lambda-runtimes.html) ID。

**逾時 (秒)**  
(必要) Lambda 在停止函數前允許函數執行的時間。指定最多 900 秒 (15 分鐘) 的長度。

**記憶體 (MB)**  
(必要) 可供函數在執行時使用的記憶體量。指定[介於 128 MB 和 3,008 MB](https://docs.aws.amazon.com/lambda/latest/dg/gettingstarted-limits.html) 間的數量 (以 64 MB 遞增)。

**環境變數**  
(選用) Lambda 函數要使用的任何[環境變數](https://docs.aws.amazon.com/lambda/latest/dg/configuration-envvars.html)，需透過鍵/值對指定。如要新增、變更或刪除環境變數，請選擇資料夾圖示，然後遵循畫面上的說明。

**IAM 角色**  
(必要) 選擇已連線的 AWS 帳戶中 Lambda 要用於函數的可用 [Lambda 執行角色](https://docs.aws.amazon.com/lambda/latest/dg/lambda-intro-execution-role.html)。如要在帳戶中建立執行角色並改讓 Lambda 使用該角色，請選擇**建立**，然後遵循畫面上的說明操作。

**啟用 AWS X-Ray**  
(選用) 如果選取此項，[Lambda 會啟用 AWS X-Ray](https://docs.aws.amazon.com/lambda/latest/dg/services-xray.html) 來偵測、分析和最佳化函數的效能問題。X-Ray 會向 Lambda 及任何構成函數的上下游服務收集中繼資料。X-Ray 會使用這些中繼資料產生詳細的服務圖表，呈現效能瓶頸、延遲高峰以及其他會影響函數效能的問題。