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

在使用 AWS Toolkit for JetBrains 用户界面时如需帮助，请参阅以下主题。

**Topics**
+ [AWS Explorer](aws-explorer.md)
+ [“Create Function (创建函数)”对话框](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 Explorer，在安装了 AWS Toolkit for JetBrains 并且 IntelliJ IDEA、PyCharm、WebStorm 或 JetBrains Rider 在运行的情况下，请执行下列操作之一：
+ 在工具窗口栏上，选择 **AWS Explorer**。  
![\[AWS Explorer 工具窗口按钮。\]](http://docs.aws.amazon.com/zh_cn/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_cn/toolkit-for-jetbrains/latest/userguide/images/aws-explorer-main-menu.png)

在 **AWS Explorer** 中，为以下选项选择设置图标（**显示选项菜单**）：

![\[AWS Explorer 显示选项菜单。\]](http://docs.aws.amazon.com/zh_cn/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_cn/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/)（本指南）。

**查看 GitHub 上的源**  
转至 GitHub 网站上的 [aws/aws-toolkit-jetbrains](https://github.com/aws/aws-toolkit-jetbrains) 存储库。

**查看模式**  
调整 **AWS Explorer** 工具窗口，以便在编辑器或其他工具窗口中工作时快速访问该窗口并节省空间。  
有关 IntelliJ IDEA 视图模式，请参阅 IntelliJ IDEA 帮助网站上的 [Tool window view modes](https://www.jetbrains.com/help/idea/viewing-modes.html)。  
有关 PyCharm 视图模式，请参阅 PyCharm 帮助网站上的 [Tool window view modes](https://www.jetbrains.com/help/pycharm/viewing-modes.html)。  
有关 WebStorm 视图模式，请参阅 WebStorm 帮助网站上的 [Tool window view modes](https://www.jetbrains.com/help/webstorm/viewing-modes.html)。  
有关 JetBrains Rider 视图模式，请参阅 JetBrains Rider 帮助网站上的 [Tool window view modes](https://www.jetbrains.com/help/rider/Viewing_Modes.html)。

**移至**  
在 IntelliJ IDEA、PyCharm、WebStorm 或 JetBrains Rider 中将 **AWS Explorer** 工具窗口移动至不同位置。

**调整大小**  
更改 **AWS Explorer** 工具窗口的大小。

**从侧边栏中删除**  
从工具窗口栏中删除 **AWS Explorer** 工具窗口。要重新显示它，请在主菜单栏上，依次选择 **View (视图)**、**Tool Windows (工具窗口)** 和 **AWS Explorer**。

您也可以通过 AWS Explorer 使用 Lambda 函数和 AWS 账户中的 AWS CloudFormation 堆栈。

# “Create Function (创建函数)”对话框
<a name="create-function-dialog"></a>

创建独立的 AWS Lambda 函数时，系统会显示 AWS Toolkit for JetBrains 中的**创建函数**对话框。

![\[“创建函数”对话框。\]](http://docs.aws.amazon.com/zh_cn/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 和 3008 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 执行角色](https://docs.aws.amazon.com/lambda/latest/dg/lambda-intro-execution-role.html)，供 Lambda 用于该函数。要在账户中创建执行角色并改为让 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_cn/toolkit-for-jetbrains/latest/userguide/images/sam-deploy.png)


**部署无服务器应用程序**对话框包含以下项：

**创建堆栈**  
（必需）为 AWS Serverless Application Model（AWS SAM）命令行界面提供要在 AWS CloudFormation 中为关联的 AWS 账户创建的堆栈的名称。然后，AWS SAM CLI 使用此堆栈部署 AWS 无服务器应用程序。

**更新堆栈**  
（必需）为 AWS CLI 选择关联的 AWS SAM 账户中的现有 CloudFormation 堆栈的名称，供其用于部署 AWS 无服务器应用程序。

**注意**  
**创建堆栈**或**更新堆栈**是必需的（而不是同时需要两者）。

**模板参数**  
（可选）AWS Toolkit for JetBrains 在相应项目的 `template.yaml` 文件中检测到的任何参数。要为参数指定值，请选择参数旁边的 **Value (值)** 列中的框，输入值，然后按 **Enter**。有关更多信息，请参阅《AWS CloudFormation 用户指南》**中的[参数](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/parameters-section-structure.html)。

**S3Bucket**  
（必需）为 AWS SAM CLI 选择关联的 AWS 账户中的现有 Amazon Simple Storage Service（Amazon S3）存储桶，供其用于部署 AWS 无服务器应用程序。要在账户中创建 Amazon S3 存储桶并让 AWS SAM CLI 改用该存储桶，请选择**创建**，然后按照屏幕上的说明进行操作。

**ECR 存储库**  
（仅 `Image` 包类型必需）为 AWS SAM CLI 在关联的 AWS 账户中选择现有 Amazon Elastic Container Registry（Amazon ECR）存储库 URI，供其用于部署到 AWS 无服务器应用程序。有关 AWS Lambda 包类型的更多信息，请参阅**《AWS Lambda 开发人员指南》中的 [Lambda 部署程序包](https://docs.aws.amazon.com/lambda/latest/dg/gettingstarted-package.html)。

**部署前需要确认**  
（可选）如果选中，则会[执行 CloudFormation 中设置的堆栈的当前更改](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-changesets-execute.html)，指示 CloudFormation 等您完成对应堆栈的创建或更新。如果不执行此更改集，则 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_cn/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 开发工具包（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_cn/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)。

此对话框包含 3 个选项卡：**配置**、**SAM CLI** 和 **AWS 连接**。

![\[本地函数设置的“运行/调试配置”对话框的“配置”选项卡。\]](http://docs.aws.amazon.com/zh_cn/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) 的相应函数处理程序的标识符。

**超时（秒）**  
（**来自处理程序**选项为必需）Lambda 在停止函数前允许其运行的时长。指定最多 900 秒（15 分钟）的时长。

**内存 (MB)**  
（**来自处理程序**选项为必需）函数运行时可用的内存量。指定[介于 128 MB 和 3008 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)，指定为键值对。要添加、更改或删除环境变量，请选择文件夹图标，然后按照屏幕上的说明执行操作。

**模板**  
（**来自模板**的选项为必需）用于此配置的 AWS Serverless Application Model（AWS SAM）模板（例如 `template.yaml`）的位置和文件名，以及该模板中与此配置关联的资源。

**文件**  
（必需）要传递给函数的事件数据的位置和文件名（JSON 格式）。有关事件数据示例，请参阅《AWS Lambda 开发人员指南》**中的 [Invoke the Lambda function](https://docs.aws.amazon.com/lambda/latest/dg/getting-started-create-function.html#get-started-invoke-manually) 和《AWS Serverless Application Model 开发人员指南》**中的 [Generating sample event payloads](https://docs.aws.amazon.com/serverless-application-model/latest/developerguide/serverless-sam-cli-using-generate-event.html)。

**文本**  
（必需）要传递给函数的事件数据（JSON 格式）。有关事件数据示例，请参阅《AWS Lambda 开发人员指南》**中的 [Invoke the Lambda function](https://docs.aws.amazon.com/lambda/latest/dg/getting-started-create-function.html#get-started-invoke-manually) 和《AWS Serverless Application Model 开发人员指南》**中的 [Generating sample event payloads](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 帮助网站上的 [Before Launch options](https://www.jetbrains.com/help/idea/run-debug-configurations-dialog.html#before-launch-options)。
+ 有关 PyCharm，请参阅 PyCharm 帮助网站上的 [Before Launch options](https://www.jetbrains.com/help/pycharm/run-debug-configurations-dialog.html#before-launch-options)。
+ 有关 WebStorm，请参阅 WebStorm 帮助网站上的 [Before Launch options](https://www.jetbrains.com/help/webstorm/run-debug-configuration-node-js.html#before-launch-options)。
+ 有关 JetBrains Rider，请参阅 JetBrains Rider 帮助网站上的 [Before Launch options](https://www.jetbrains.com/help/rider/Run_Debug_Configurations_dialog.html#before-launch-options)。

![\[本地函数设置的“运行/调试配置”对话框的 SAM CLI 选项卡。\]](http://docs.aws.amazon.com/zh_cn/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 帮助网站上的 [Before Launch options](https://www.jetbrains.com/help/idea/run-debug-configurations-dialog.html#before-launch-options)。
+ 有关 PyCharm，请参阅 PyCharm 帮助网站上的 [Before Launch options](https://www.jetbrains.com/help/pycharm/run-debug-configurations-dialog.html#before-launch-options)。
+ 有关 WebStorm，请参阅 WebStorm 帮助网站上的 [Before Launch options](https://www.jetbrains.com/help/webstorm/run-debug-configuration-node-js.html#before-launch-options)。
+ 有关 JetBrains Rider，请参阅 JetBrains Rider 帮助网站上的 [Before Launch options](https://www.jetbrains.com/help/rider/Run_Debug_Configurations_dialog.html#before-launch-options)。

![\[本地函数设置的“运行/调试配置”对话框的“AWS 连接”选项卡。\]](http://docs.aws.amazon.com/zh_cn/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 帮助网站上的 [Before Launch options](https://www.jetbrains.com/help/idea/run-debug-configurations-dialog.html#before-launch-options)。
+ 有关 PyCharm，请参阅 PyCharm 帮助网站上的 [Before Launch options](https://www.jetbrains.com/help/pycharm/run-debug-configurations-dialog.html#before-launch-options)。
+ 有关 WebStorm，请参阅 WebStorm 帮助网站上的 [Before Launch options](https://www.jetbrains.com/help/webstorm/run-debug-configuration-node-js.html#before-launch-options)。
+ 有关 JetBrains Rider，请参阅 JetBrains Rider 帮助网站上的 [Before Launch options](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_cn/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 开发人员指南》**中的 [Invoke the Lambda function](https://docs.aws.amazon.com/lambda/latest/dg/getting-started-create-function.html#get-started-invoke-manually) 和《AWS Serverless Application Model 开发人员指南》**中的 [Generating sample event payloads](https://docs.aws.amazon.com/serverless-application-model/latest/developerguide/serverless-sam-cli-using-generate-event.html)。

**文本**  
（必需）要传递给函数的事件数据（JSON 格式）。有关事件数据示例，请参阅《AWS Lambda 开发人员指南》**中的 [Invoke the Lambda function](https://docs.aws.amazon.com/lambda/latest/dg/getting-started-create-function.html#get-started-invoke-manually) 和《AWS Serverless Application Model 开发人员指南》**中的 [Generating sample event payloads](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 帮助网站上的 [Before Launch options](https://www.jetbrains.com/help/idea/run-debug-configurations-dialog.html#before-launch-options)。
+ 有关 PyCharm，请参阅 PyCharm 帮助网站上的 [Before Launch options](https://www.jetbrains.com/help/pycharm/run-debug-configurations-dialog.html#before-launch-options)。
+ 有关 WebStorm，请参阅 WebStorm 帮助网站上的 [Before Launch options](https://www.jetbrains.com/help/webstorm/run-debug-configuration-node-js.html#before-launch-options)。
+ 有关 JetBrains Rider，请参阅 JetBrains Rider 帮助网站上的 [Before Launch options](https://www.jetbrains.com/help/rider/Run_Debug_Configurations_dialog.html#before-launch-options)。

# “编辑配置”对话框（Amazon ECS 集群）
<a name="edit-configuration-dialog-ecs"></a>

**编辑配置**对话框包含两个选项卡：**配置**和 **AWS 连接**。

![\[“编辑配置”对话框的“配置”选项卡。\]](http://docs.aws.amazon.com/zh_cn/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 帮助网站上的 [Before Launch options](https://www.jetbrains.com/help/idea/run-debug-configurations-dialog.html#before-launch-options)。
+ 有关 PyCharm，请参阅 PyCharm 帮助网站上的 [Before Launch options](https://www.jetbrains.com/help/pycharm/run-debug-configurations-dialog.html#before-launch-options)。
+ 有关 WebStorm，请参阅 WebStorm 帮助网站上的 [Before Launch options](https://www.jetbrains.com/help/webstorm/run-debug-configuration-node-js.html#before-launch-options)。
+ 有关 JetBrains Rider，请参阅 JetBrains Rider 帮助网站上的 [Before Launch options](https://www.jetbrains.com/help/rider/Run_Debug_Configurations_dialog.html#before-launch-options)。

![\[“编辑配置”对话框的“AWS 连接”选项卡。\]](http://docs.aws.amazon.com/zh_cn/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 帮助网站上的 [Before Launch options](https://www.jetbrains.com/help/idea/run-debug-configurations-dialog.html#before-launch-options)。
+ 有关 PyCharm，请参阅 PyCharm 帮助网站上的 [Before Launch options](https://www.jetbrains.com/help/pycharm/run-debug-configurations-dialog.html#before-launch-options)。
+ 有关 WebStorm，请参阅 WebStorm 帮助网站上的 [Before Launch options](https://www.jetbrains.com/help/webstorm/run-debug-configuration-node-js.html#before-launch-options)。
+ 有关 JetBrains Rider，请参阅 JetBrains Rider 帮助网站上的 [Before Launch options](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_cn/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_cn/toolkit-for-jetbrains/latest/userguide/images/sam-update-config-zip.png)


`Image` 包类型的**更新配置**对话框：

![\[Image 应用程序的“更新配置”对话框。\]](http://docs.aws.amazon.com/zh_cn/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\$1](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 和 3008 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 执行角色](https://docs.aws.amazon.com/lambda/latest/dg/lambda-intro-execution-role.html)，供 Lambda 用于该函数。要在账户中创建执行角色并改为让 Lambda 使用该角色，请选择**创建**，然后按照屏幕上的说明进行操作。

**启用 AWS X-Ray**  
（可选）如果选择此项，[Lambda 会启用 AWS X-Ray](https://docs.aws.amazon.com/lambda/latest/dg/services-xray.html) 以检测、分析和优化函数的性能问题。X-Ray 会从 Lambda 和组成函数的所有上游或下游服务中收集元数据。X-Ray 会使用这些元数据生成详细的服务图形，用于展示性能瓶颈、延迟峰值，以及影响函数性能的其他问题。