AWS Toolkit for JetBrains - AWS Toolkit for JetBrains

本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。

AWS Toolkit for JetBrains

使用以下简要说明操作,使用适用于 JetBrains 的 AWS 工具包来完成关键任务。

安装 AWS Toolkit for JetBrains

设置您的 AWS 账户以使用 AWS Toolkit for JetBrains

  1. 创建 AWS 账户(如果您还没有账户)。

  2. 在 AWS Identity and Access Management (IAM) 中创建管理员用户和组在账户中,如果您尚未执行此操作。

    注意

    建议您在账户中为要使用的 AWS Toolkit(适用于 JetBrains 的 AWS Toolkit)创建或使用特定类型的用户和组,我们将它称作管理员IAM 用户和组。虽然你可以创建常规 IAM 用户和组在账户中,此方法可能不允许工具包拥有对该账户中所有 AWS 资源和 AWS 无服务器应用程序的完全访问权限。我们支持,但强烈劝阻,使用AWS 账户根用户使用 AWS Toolkit for JetBrains。

  3. 为用户创建访问密钥(如果您尚未为用户创建访问密钥)。

    注意

    访问密钥同时包含访问密钥 ID 值和秘密访问密钥 值。用于 JetBrains 的 AWS 工具包稍后,需要使用这两个值。请务必将它们存储在安全位置。如果您丢失了它们,则它们就永远消失并且无法进行检索。但是,您始终可以删除丢失的访问密钥,然后创建替换访问密钥。如果您曾经执行了此操作,则还需要更改工具包连接设置。我们支持,但强烈劝阻为 AWS 账户根用户创建访问密钥,以获取 AWS Toolkit for JetBrains 使用。

安装和配置适用于 JetBrains 的 AWS 工具包

  1. 确保AWS 工具包支持的 JetBrains IDE已安装并且正在运行。

  2. 打开 Settings (设置)/Preferences (首选项)

  3. 选择 Plugins (插件)

  4. 在存储库的Marketplace” 选项卡, 在在商城中搜索插件,开始输入AWS 工具包。何时Amazon Web Services AWS Toolkit of,请选择它。

    
        查找 AWS Toolkit
  5. 选择安装

    
        安装 AWS Toolkit for JetBrains
    注意

    要使用适用于 JetBrains 的 AWS 工具包将其可用功能用于 AWS CloudFormation、AWS Lambda、AWS 无服务器和亚马逊云服务器,您必须安装 1.8 版或更高版本的 AWS 工具包。

  6. 在显示 Third-party Plugins Privacy Note (第三方插件隐私说明) 时,选择 Accept (接受)

  7. 选择重新启动 IDE,并且系统提示时,选择Restart (重新启动)

  8. 在使用适用于 JetBrains 的 AWS 工具包开发、测试、分析和部署 AWS 无服务器应用程序或 Lambda 函数之前,请确保您已安装以下工具。按照以下顺序安装工具:

    1. AWS 命令行界面 (AWS CLI)

    2. Docker(在您开发、测试、分析或部署无服务器应用程序或函数时,Docker 必须始终运行)

    3. AWS 无服务器应用程序模型命令行界面 (AWS SAM CLI)

  9. 必须先完成其他步骤,然后才能使用适用于 JetBrains 的 AWS 工具包调试 Amazon ECS 集群中的代码。有关说明,请参阅先决条件

  10. 在安装适用于 JetBrains 的 AWS 工具包后(如果您使用 AWS 无服务器应用程序、Lambda 函数或 Amazon ECS 集群,则您已按顺序安装上述其他所需工具),首次连接到 AWS 账户

页首

更新 AWS Toolkit for JetBrains

在你之后安装 AWS Toolkit for JetBrains,您可以随时检查工具包的更新并安装这些更新。

要做到这一点,在 IntelliJ J 的 IDEA、PyCharm、网络风暴或 JetBrains 骑士已运行的情况下,执行以下操作:

  1. 打开 Settings (设置)/Preferences (首选项)

  2. 选择 Updates (更新)。(如果未显示任何更新,您可能需要选择 Check new updates (检查新更新)。)

    
        检 AWS Toolkit for JetBrains
  3. 按照任何屏幕上说明执行操作,完成 AWS Toolkit for JetBrains 更新。

  4. 重新启动 JetBrains IDE。

配置 AWS 工具包以使用 HTTP 代理

在你之后安装 AWS Toolkit for JetBrains,您可以配置它以使用 HTTP 代理。

在 IntelliJ J 的 IDEA、PyCharm、网络风暴或 JetBrains 骑士已运行的情况下,执行下列操作之一:

按照上述说明完成操作后,工具包将开始使用这些 HTTP 代理设置。

页首

使用 AWS 工具包中的 AWS AWS AWS 账户的连接

在你之后安装 AWS Toolkit for JetBrains中,使用此工具包对 AWS 账户执行以下操作:

页首

首次 Connect 到 AWS 账户

我们假设您已安装 AWS Toolkit for JetBrains。根据您的连接选项,您必须已完成以下先决条件:

  • AWS 安全凭证 — 创建了访问密钥(其中包含访问密钥 ID值和私有访问密钥值),或 AWS 账户根用户(我们强烈建议这样做)。如果您没有 IAM 中用户的访问密钥,请创建一个

  • AWS SSO — 通过启用 AWS SSO、管理您的身份源以及向 AWS 账户分配 SSO 访问来配置单点登录。有关此过程的更多信息,请参阅入门章节AWS Single Sign-On 用户指南

注意

我们建议将敏感凭据信息(如包含访问密钥的命名配置文件)存储在credentials文件。不太敏感的配置选项(如使用 AWS SSO 进行身份验证的命名配置文件)通常存储在config文件。

您可以将所有命名配置文件存储在一个文件中。如果您使用credentialsconfigfile,credentials默认情况下,在 IDE 中打开。

如果两个文件中都有共享相同名称的配置文件的凭证,则credentials文件优先。有关更多信息,请参阅 。配置和凭证文件设置中的AWS 命令行界面用户指南

  • 要打开凭证以进行编辑,请执行下列操作之一:

    • 在状态栏上,选择AWS:未选择凭证,然后选择编辑 AWS 凭证文件

      
            AWS 在状态栏上没有选择凭证
      
            从状态栏编辑 AWS 凭证
    • 打开 AWS Explorer(如果尚未打开)。选择配置 AWS 连接,然后选择编辑 AWS 凭证文件

      
            从 AWS Explorer 配置 AWS 连接
      
            从 AWS Explorer 编辑 AWS 凭证

打开证书文件后,您可以对其进行编辑,以便使用访问密钥或 AWS SSO 指定对 AWS 账户的访问权限。

Connect with access keys
  1. 在文件中的 [default] 下,对于 aws_access_key_id,将 [accessKey1] 替换为访问密钥 ID 值(例如 AKIAIOSFODNN7EXAMPLE)。

    如果出现提示,请选择无论如何,我想编辑这个文件,然后选择确定

  2. 对于 aws_secret_access_key,将 [secretKey1] 替换为秘密访问密钥值(例如 wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY)。

    最终结果应如此处所示,遵循指定的配置文件格式。

    ... Other file contents omitted for brevity ... [default] # ... Some comments ... aws_access_key_id = AKIAIOSFODNN7EXAMPLE # ... Some more comments ... # ... Some more comments ... # ... Some more comments ... # ... Some more comments ... aws_secret_access_key = wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY ... Other file contents omitted for brevity ...
    注意

    适用于 JetBrains 的 AWS 工具包当前支持以下配置变量:

    • aws_access_key_id

    • aws_secret_access_key

    • aws_session_token

    • credential_process

    • external_id

    • mfa_serial

    • role_arn

    • source_profile

    有关更多信息,请参阅 。AWS CLI 配置变量中的AWS CLI 命令参考

  3. 保存该文件,然后将其关闭。适用于 JetBrains 的 AWS 工具包尝试使用上一个访问密钥连接到账户。

    在连接后,您可以使用此工具包来使用该账户中的 AWS 资源,例如AWS 无服务器应用程序,AWS Lambda函数,以及AWS CloudFormation堆栈。

Connect with AWS SSO

使用 AWS SSO,您可以在credentialsfile 或config用于检索 AWS 账户的临时证书。配置文件定义指定 SSO用户门户以及与请求访问的用户关联的 AWS 账户和 IAM 角色。

适用于 JetBrains 的 AWS 工具包调用 AWS CLIlogin命令代表您。(您添加的命名配置文件将作为一个选项传递给login)。如果登录成功,则会启动您的默认浏览器并验证您的 AWS SSO 登录。然后,您可以开始访问您账户中可用的 AWS 资源。

  1. credentials/config文件,下[default]中,为命名配置文件添加模板。

    您可以使用类似下面的示例作为典型 AWS SSO 配置文件的模板。

    重要

    对于命名配置文件,credentials文件使用的命名格式与config文件。包含前缀词profile仅当配置命名配置文件时config文件。在 credentials 文件中创建条目时,请勿 使用单词 profile

    ... Named profile in credentials file ... [default] sso_start_url = https://my-sso-portal.awsapps.com/start sso_region = us-east-1 sso_account_id = 123456789011 sso_role_name = readOnly region = us-west-2 ... Named profile in config file ... [profile user1] sso_start_url = https://my-sso-portal.awsapps.com/start sso_region = us-east-1 sso_account_id = 123456789011 sso_role_name = readOnly region = us-west-2 ... Other file contents omitted for brevity ...
  2. 为特定于 SSO 配置的密钥分配值:

    • sso_start_url— 指定指向组织的 AWS SSO 用户门户的 URL。

    • sso_region— 指定包含 AWS SSO 门户主机的 AWS 区域。它与默认的 AWS 区域是分开的,并且可以是不同的 AWS 区域region参数。

    • sso_account_id— 指定 AWS 账户 ID,其中包含的 IAM 角色具有您希望授予关联的 AWS SSO 用户的权限。

    • sso_role_name— 指定 IAM 角色的友好名称,该名称在使用此配置文件通过 AWS SSO 获取凭证时定义用户的权限。

    • regionIAM 指定包含 AWS SSO 门户主机的 AWS 区域。它与默认的 AWS 区域是分开的,并且可以是不同的 AWS 区域region参数。

    注意

    您还可以包括任何其他密钥和值,这些密钥和值在.aws/credentials file之外的压缩算法(例如output或者S3。但是,您不能包含任何凭证相关值,例如role_arn或者aws_secret_access_key。如果您这样做,AWS CLI 会生成错误。

    有关更多信息,请参阅 。配置 AWS CLI 以使用 AWS Single Sign-On中的AWS 命令行界面用户指南

    在适用于 JetBrains 的 AWS 工具包调用 AWS SSO 之后login命令时,会启动一个浏览器窗口以确认 SSO 登录成功。

您还可以有多个可用的连接,以便能在它们之间切换

在您连接后,适用于 JetBrains 的 AWS 工具包会自动选择默认 AWS 区域。您可能需要切换连接以使用不同 AWS 资源

页首

添加多个连接

根据要添加的其他连接,您必须首先完成以下任务之一:

  • 创建额外访问密钥(其中包含访问密钥 ID值和私有访问密钥值)或 AWS 账户根用户(我们强烈建议)中的用户(我们强烈劝阻)。如果您没有中用户 IAM 的访问密钥,请使用创建一个

  • Enabled (已启用)AWS SSO 访问,以获取其他用户的 AWS 账户。

注意

我们建议将敏感凭据信息(如包含访问密钥的命名配置文件)存储在credentials文件。不太敏感的配置选项(如使用 AWS SSO 进行身份验证的命名配置文件)通常存储在config文件。

您可以将所有命名配置文件存储在一个文件中。如果您使用credentialsconfigfile,credentials默认情况下,在 IDE 中打开。

如果两个文件中都有共享相同名称的配置文件的凭证,则credentials文件优先。有关更多信息,请参阅 。配置和凭证文件设置中的AWS 命令行界面用户指南

  1. 首次连接(如果您尚未执行此操作)。

  2. 要开始编辑凭证文件,请执行下列操作之一:

    • 在状态栏上,选择AWS 连接设置,然后选择所有凭证编辑 AWS 凭证文件

      
            选择从状态栏编辑 AWS 证书
    • 打开 AWS Explorer(如果尚未打开),然后选择Show Options 菜单(设置图标)。选择AWS 连接设置所有凭证编辑 AWS 凭证文件

      
            选择从 AWS 资源管理器编辑 AWS 证书
  3. 在文件中,为每个附加连接添加一个命名的配置文件。配置文件名称只能包含大写字母 A通过Z,小写字母a通过z, 数字0通过9,连字符(-)和下划线字符(_)。配置文件名称的长度必须小于 64 个字符。

    Profile with access keys

    例如,对于名为 myuser 的命名配置文件,请使用以下格式。

    [myuser] aws_access_key_id = AKIAIOSFODNN7EXAMPLE aws_secret_access_key = wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY
    注意

    适用于 JetBrains 的 AWS 工具包当前支持仅包含以下字符的命名配置文件:A-Za-z0-9,下划线(_) 和连字符 (-)。

    目前,此工具包仅支持以下配置变量:

    • aws_access_key_id

    • aws_secret_access_key

    • aws_session_token

    • credential_process

    • mfa_serial

    • role_arn

    • source_profile

    有关更多信息,请参阅 。AWS CLI 配置变量中的AWS CLI 命令参考

    Profile with AWS SSO

    使用 AWS SSO,您可以通过添加定义如何使用单点登录验证特定账户的命名配置文件来启用多个连接。确保每个已命名的配置文件添加到credentials文件具有唯一的名称,并将特定于帐户的值分配给 SSO 密钥。如下例所示。

    ... Other file contents omitted for brevity ... [profile user2] sso_start_url = https://my-sso-portal.awsapps.com/start sso_region = us-east-1 sso_account_id = 123456789011 sso_role_name = readOnly region = us-west-2 ... Other file contents omitted for brevity ...

    有关 AWS SSO 键-值对的更多信息,请参阅defining named profiles for SSO

  4. 保存该文件,然后将其关闭。适用于 JetBrains 的 AWS 工具包将在AWS 连接设置菜单中的状态栏和AWS Explorer 使用

现在,您已有多个连接,可以在它们之间切换

在您连接后,可能需要交换机连接以使用

页首

在连接之间切换

  1. 添加多个连接(如果尚未执行此操作)。

  2. 请执行下列操作之一:

    • 在状态栏上,选择AWS 连接设置

    • 打开 AWS Explorer(如果尚未打开),然后选择AWS 连接设置

  3. 选择要用于新连接的命名配置文件。如果未列出,请选择所有凭证,然后选择命名配置文件要使用的。

    切换当前连接

    适用于 JetBrains 的 AWS Toolkit (AWS Toolkit) 切换到新的连接。此连接现在已在AWS 连接设置菜单中的状态栏和AWS Explorer 使用

在您连接后,可能需要切换以使用该账户中位于不同的 AWS 区域中的 AWS 资源

页首

更改连接设置

  1. 请执行下列操作之一:

    • 在状态栏上,选择AWS 连接设置所有凭证编辑 AWS 凭证文件

      
            选择“Edit AWS Credential files (编辑 AWS 凭证文件)”命令
    • 打开 AWS Explorer(如果尚未打开),然后选择Show Options 菜单(设置图标)。然后选择 。AWS 连接设置所有凭证编辑 AWS 凭证文件

      
            选择“Edit AWS Credential files (编辑 AWS 凭证文件)”命令
  2. 对此文件进行更改,然后保存并关闭此文件。

页首

删除连接

  1. 请执行下列操作之一:

    • 在状态栏上,选择AWS 连接设置所有凭证编辑 AWS 凭证文件

      
            选择“Edit AWS Credential files (编辑 AWS 凭证文件)”命令
    • 打开 AWS Explorer(如果尚未打开),然后选择Show Options 菜单(设置图标)。然后选择 。AWS 连接设置所有凭证编辑 AWS 凭证文件

      
            选择“Edit AWS Credential files (编辑 AWS 凭证文件)”命令
  2. 在文件中,完全删除命名配置文件(指定访问密钥或 AWS SSO 键值对),以便您要删除的连接。

  3. 保存该文件,然后将其关闭。适用于 JetBrains 的 AWS 工具包将删除的连接从AWS 连接设置菜单中的状态栏和AWS Explorer 使用

删除连接后,可能需要切换到其他连接或重新进行首次连接

页首

获取当前连接

要检查适用于 JetBrains 的 AWS 工具包当前正在使用的连接,请执行下列操作之一:

  • 在状态栏上,查看当前连接(在AWS 连接设置Arets 区域。

    
        状态栏中的当前连接
  • 打开 AWS Explorer(如果尚未打开),然后选择Show Options 菜单(设置图标)。选择AWS 连接设置。已选择当前连接。

    
        AWS Explorer 中的当前连接

您还可以有多个可用的连接,以便能在它们之间切换

页首

获取当前 AWS 区域

要检查适用于 JetBrains 的 AWS 工具包当前正在使用的 AWS 区域,请执行下列操作之一:

  • 在状态栏上,查看显示在AWS 连接设置Arets 区域。

    
        状态栏中的当前 AWS 区域
  • 打开 AWS Explorer(如果尚未打开),然后选择Show Options 菜单(设置图标)。选择AWS 连接设置。当前区域已选定。

    
        AWS 资源管理器中的当前 AWS 区域

您还可在其他实例切换到其他 AWS 区域

页首

在 AWS 区域之间切换

要切换 AWS 区域,请执行以下操作之一:

  • 在状态栏上,选择AWS 连接设置,然后选择要切换到的 AWS 区域。

    在状态栏中选择不同的 AWS 区域
  • 打开 AWS Explorer(如果尚未打开)。选择Show Options 菜单(设置图标),然后选择AWS 连接设置。如果列出了要切换到的 AWS 区域,请选择此 AWS 区域。否则,请选择 All Regions (所有区域),然后选择要切换到的区域。

    
        在 AWS Explorer 中选择不同的 AWS 区域

适用于 JetBrains 的 AWS 工具包切换为使用新区域。现在,该区域将在AWS 连接设置菜单中的状态栏和AWS Explorer 使用

页首

在 AWS Toolkit for JetBrains) 中打开 AWS Explorer

要完成此过程,您必须先安装 AWS Toolkit。然后,在 IntelliJ J 的 IDEA、PyCharm、网络风暴或 JetBrains 骑士已运行的情况下,执行下列操作之一:

  • 在工具窗口栏上,选择AWS Explorer 使用

    
            AWS Explorer 工具窗口按钮
  • 在存储库的查看菜单上,选择工具窗口AWS Explorer 使用

    
            从主菜单中打开 AWS Explorer

打开后AWS Explorer 使用首次使用它首次连接到 AWS 账户。之后,您可以使用AWS Explorer 使用使用AWS Lambda函数和AWS CloudFormation在帐户中的堆栈。

页首

使用 AWS 无服务器应用程序

在你之后安装 AWS Toolkit for JetBrains,然后用它来首次连接到 AWS 账户,您可以通过此工具包来使用账户中的 AWS 无服务器应用程序,如下所示:

页首

创建无服务器应用程序

要完成此过程,您必须先安装 AWS Toolkit for JetBrains,如果您还没有,首次连接到 AWS 账户

  1. 在 IntelliJ J 的 IDEA、PyCharm、网络风暴或 JetBrains 骑士已运行的情况下,执行下列操作之一:

    • 对于 IntelliJ J IDEA 或网络风暴,请选择File (文件)New项目

    • 对于 PyCharm,选择 PyCharmFile (文件)新项目

    • 对于 JetBrains 骑士,选择File (文件)New以获得新解决方案。或者,右键单击 Explorer 工具窗口中的现有解决方案,然后选择 Add (添加)New Project (新建项目)

  2. 对于 IntelliJ IDEA,选择AWSAWS 无服务器应用程序,然后选择下一步

    选择在 IntelliJ IDEA 中创建 AWS 无服务器应用程序

    对于 PyCharm,选择 PyCharmAWS 无服务器应用程序

    选择在 PyCharm 中创建 AWS 无服务器应用程序

    对于网络风暴,请选择AWS 无服务器应用程序

    选择在 WebStorm 中创建 AWS 无服务器应用程序

    对于 JetBrains 骑士,选择AWS 无服务器应用程序

    
        选择在 JetBrains 骑士中创建 AWS 无服务器应用程序
  3. 完成“新建项目” 对话框(或JetBrains Rider),然后选择Finish(用于 IntelliJ J 创意)或Create(适用于 PyCharm,网络风暴,或 JetBrains 骑士)。适用于 JetBrains 的 AWS 工具包创建项目并将无服务器应用程序的代码文件添加到新项目中。

  4. 如果您是在使用 IntelliJ J IDEA,则使用项目工具窗口已打开并显示包含无服务器应用程序文件的项目,请执行下列操作之一:

    • 对于基于 Maven 的项目,右键单击项目的 pom.xml 文件,然后选择 Add as Maven Project (添加为 Maven 项目)

      选择将 POM 文件添加为 Maven 项目
    • 对于基于 Gradle 的项目,右键单击项目的 build.gradle 文件,然后选择 Import Gradle project (导入 Gradle 项目)

      选择导入 Gradle 项目

      完成 Import Module from Gradle (从 Gradle 导入模块) 对话框中的操作,然后选择 OK (确定)

创建无服务器应用程序后,您可以运行(调用)或调试 AWS Lambda 函数的本地版本,包含在该应用程序中。

您还可以部署无服务器应用程序。部署完成后,您可以运行(调用)Lambda 函数的远程版本,这是该部署的应用程序的一部分。

页首

部署无服务器应用程序

在使用此过程部署 AWS 无服务器应用程序之前,您必须先创建 AWS 无服务器应用程序。然后,按照以下步骤执行操作。

注意

要部署包含 AWS Lambda 函数的无服务器应用程序,并将该函数与任何非默认或可选属性一起部署,您必须先在函数的相应 AWS Serverless Application Model (AWS SAM) 模板文件中(例如,在名为template.yaml在项目中)。有关可用属性的列表,请参阅AWS::Serverless::Function中的awslab/无服务器应用程序模型GitHub 上的存储库。

  1. 如果您需要了解的内容切换到其他 AWS 区域部署无服务器应用程序,请立即执行此操作。

  2. Project (项目) 工具窗口已打开并显示包含无服务器应用程序文件的项目的情况下,请右键单击项目的 template.yaml 文件。然后,选择 Deploy Serverless Application (部署无服务器应用程序)

    选择“Deploy Serverless Application (部署无服务器应用程序)”命令
  3. 完成 Deploy Serverless Application (部署无服务器应用程序) 对话框中的操作,然后选择 Deploy (部署)

    适用于 JetBrains 的 AWS 工具包为部署创建相应的 AWS CloudFormation 堆栈。它还会将堆栈的名称添加到CloudFormation中的列表AWS Explorer 使用。如果部署失败,您可以尝试通过查看堆栈的事件日志

部署完成后,您可以运行(调用)AWS Lambda 函数的远程版本,这是该部署的应用程序的一部分。

页首

更新无服务器应用程序的设置

必须先行,然后才能使用此过程更改无服务器应用程序的设置。部署 AWS 无服务器应用程序你想改变的。然后,按照以下步骤执行操作。

注意

要部署包含 AWS Lambda 函数的无服务器应用程序,并将该函数与任何非默认或可选属性一起部署,您必须先在函数的相应 AWS SAM 模板文件中(例如,在名为template.yaml在项目中)。有关可用属性的列表,请参阅AWS::Serverless::Function中的awslab/无服务器应用程序模型GitHub 上的存储库。

  1. Project (项目) 工具窗口已打开并显示包含无服务器应用程序文件的项目的情况下,请打开项目的 template.yaml 文件。更改文件的内容以反映新设置,然后保存并关闭文件。

  2. 如果您需要了解的内容切换到其他 AWS 区域将无服务器应用程序部署到,请立即执行此操作。

  3. 右键单击项目的 template.yaml 文件,然后选择 Deploy Serverless Application (部署无服务器应用程序)

    选择“Deploy Serverless Application (部署无服务器应用程序)”命令
  4. 完成 Deploy Serverless Application (部署无服务器应用程序) 对话框中的操作,然后选择 Deploy (部署)。适用于 JetBrains 的 AWS 工具包更新部署的相应 AWS CloudFormation 堆栈。

    如果部署失败,您可以尝试通过查看堆栈的事件日志

页首

删除无服务器应用程序

必须先通过此过程删除无服务器应用程序,然后才能删除无服务器应用程序。部署 AWS 无服务器应用程序您要删除的文档。然后,按照以下步骤执行操作。

  1. 打开 AWS Explorer(如果尚未打开)。如果您需要了解的内容切换到其他 AWS 区域,请立即执行此操作。

  2. 展开 CloudFormation

  3. 右键单击 AWS CloudFormation 堆栈(包含要删除的无服务器应用程序)的名称,然后选择删除 CloudFormation 堆栈

    
        选择从 AWS Explorer 启动的 AWS 无服务器应用程序删除 AWS CloudFormation 堆栈
  4. 输入堆栈的名称来确认删除,然后选择 OK (确定)。如果堆栈删除成功,适用于 JetBrains 的 AWS 工具包将从CloudFormation中的列表AWS Explorer 使用。如果堆栈删除失败,您可以尝试通过查看堆栈的事件日志

页首

使用 AWS Lambda 函数

在你之后安装 AWS Toolkit for JetBrains,然后使用工具包首次连接到 AWS 账户,您可以使用此工具包在账户中使用 Lambda 函数,如下所示。

页首

创建 函数

您可以使用 AWS Toolkit for JetBrains 创建 Lambda 函数,该函数为AWS 无服务器应用程序的一部分,或者您可以创建 Lambda 函数本身

创建包含 Lambda 函数的无服务器应用程序

请参阅本主题前面的说明创建 AWS 无服务器应用程序

页首

创建独立函数

要完成此过程,您必须先安装适用于 JetBrainins 的 AWS 工具包,如果您还没有,首次连接到 AWS 账户

然后,在 IntelliJ 的 IDEA、PyCharm、网络风暴或 JetBrains 骑士已运行的情况下,执行下列操作之一:

  • 打开 AWS Explorer(如果尚未打开)。如果您需要了解的内容切换到其他 AWS 区域在中创建函数,请立即执行此操作。然后单击右键Lambda,然后选择创建新 AWS Lambda

    
        通过从 AWS Explorer 启动来创建 AWS Lambda 函数

    完成 Create Function (创建函数) 对话框中的操作,然后选择 Create Function (创建函数)。适用于 JetBrains 的 AWS 工具包为部署创建相应的 AWS CloudFormation 堆栈,并将函数名称添加到Lambda中的列表AWS Explorer 使用。如果部署失败,您可以尝试通过查看堆栈的事件日志

  • 创建一个代码文件,该文件实施 JavaPythonNode.jsC# 的函数处理程序。

    如果您需要到切换到其他 AWS 区域来创建要运行(调用)的远程函数,现在就这样做。然后在代码文件中,选择Lambda图标,并选择函数处理程序旁边的边沟中的区域,然后选择创建新 AWS Lambda。完成 Create Function (创建函数) 对话框中的操作,然后选择 Create Function (创建函数)

    
        通过从代码文件中的现有函数处理程序启动来创建 AWS Lambda 函数
    注意

    如果Lambda图标不显示在函数处理程序旁边的天沟中,请尝试通过选择设置/Preferences工具AWSProject Settings显示所有潜在 AWS Lambda 处理程序的天沟图标。此外,如果已在相应的 AWS SAM 模板中定义函数处理程序,则创建新 AWS Lambda命令将不会显示。

    在您选择创建函数中,适用于 JetBrains 的 AWS 工具包会在 Lambda 服务中为连接的 AWS 账户创建相应的函数。如果操作成功,则在刷新AWS Explorer 使用Lambda列表会显示新函数的名称。

  • 如果您已有一个包含 AWS Lambda 函数的项目,并且您需要先切换到其他 AWS 区域在中创建函数,请立即执行此操作。然后在包含函数处理程序的代码文件中JavaPythonNode.js,或者C#中,选择Lambda图标在函数处理程序旁边的排水槽中。选择创建新 AWS Lambda下,完成创建函数对话框,然后选择创建函数

    
        通过从代码文件中的现有函数处理程序启动来创建 AWS Lambda 函数
    注意

    如果Lambda图标不显示在函数处理程序旁边的天沟中,请尝试通过选择设置/Preferences工具AWSProject Settings显示所有潜在 AWS Lambda 处理程序的天沟图标。另外,创建新 AWS Lambda如果已在相应的 AWS SAM 模板中定义函数处理程序,则不会显示此命令。

    在您选择创建函数中,适用于 JetBrains 的 AWS 工具包会在 Lambda 服务中为连接的 AWS 账户创建相应的函数。如果操作成功,则在刷新AWS Explorer 使用,则新函数的名称会出现在Lambda列出。

创建函数后,您可以运行(调用)或调试函数的本地版本运行(调用)远程版本

页首

运行(调用)或调试函数的本地版本

A本地版本的 AWS Lambda 函数是其源代码已存在于您的本地开发计算机上的函数。

要完成此过程,您必须先创建 AWS Lambda 函数(如果尚未创建它)或进行调试,则需要运行(调用)或进行调试。

注意

要运行(调用)或调试 Lambda 函数的本地版本,并使用任何非默认或可选属性本地运行(调用)或调试该函数,您必须先在函数的相应 AWS SAM 模板文件中(例如,在名为template.yaml在项目中)。有关可用属性的列表,请参阅AWS::Serverless::Function中的awslab/无服务器应用程序模型GitHub 上的存储库。

  1. 请执行下列操作之一:

    • 在包含函数处理程序的代码文件中JavaPythonNode.js,或者C#中,选择函数处理程序旁边的边沟中的 Lambda 图标。选择 Run '[Local]' (运行“[本地]”)Debug '[Local]' (调试“[本地]”)

      
            通过从代码文件中的函数处理程序启动来运行或调试 Lambda 函数的本地版本
    • Project (项目) 工具窗口已打开并显示包含函数的项目后,打开项目的 template.yaml 文件。选择函数的资源定义旁边的边沟中的 Run (运行) 图标,然后选择 Run '[Local]' (运行“[本地]”)Debug '[Local]' (调试“[本地]”)

      
            通过从 AWS SAM 模板文件中的函数定义开始来运行或调试 Lambda 函数的本地版本
  2. 完成编辑配置(本地功能设置)对话框(如果已显示)中编辑完配置后,选择运行或者Debug。结果将显示在 Run (运行)Debug (调试) 工具窗口中。

    • 如果编辑配置对话框未出现,并且您要更改现有配置,请先更改现有配置。更改其配置,然后从头开始重复此过程。

    • 如果缺少配置详细信息,请展开模板AWS Lambda,然后选择本地。选择确定,然后从头开始重复此过程。

页首

运行(调用)函数的远程版本

A远程版本的 AWS Lambda 函数是其源代码已存在于 AWS 账户的 Lambda 服务中的函数。

要完成此过程,您必须先安装 AWS Toolkit for JetBrains而且,如果你还没有,首次连接到 AWS 账户。然后与 IntelliJ J 想法,PyCharm,网络风暴,或 JetBrains 骑士运行,执行以下操作。

  1. 打开 AWS Explorer(如果尚未打开)。如果您需要了解的内容切换到其他 AWS 区域,请立即执行此操作。

  2. ExpandLambda,并确认已列出函数的名称。如果已列出函数名称,则跳到本过程的步骤 3。

    如果函数的名称未列出,则创建 Lambda 函数要运行(调用)。

    如果您将函数创建为AWS 无服务器应用程序的一部分,您还必须部署该应用程序

    如果您通过创建一个代码文件来创建函数,该文件实施JavaPythonNode.js,或者C#,然后在代码文件中,选择函数处理程序旁边的 Lambda 图标。然后选择 。创建新 AWS Lambda。完成 Create Function (创建函数) 对话框中的操作,然后选择 Create Function (创建函数)

  3. Lambda打开AWS Explorer 使用,右键单击函数的名称,然后选择运行 “[远程]”

    
        通过从 AWS Explorer 启动来运行 Lambda 函数的远程版本
  4. 完成编辑配置(远程功能设置)对话框(如果已显示)中编辑完配置后,选择运行或者Debug。结果将显示在 Run (运行)Debug (调试) 工具窗口中。

    • 如果编辑配置对话框未出现,并且您要更改现有配置,请先更改现有配置。更改其配置,然后从头开始重复此过程。

    • 如果缺少配置详细信息,请展开模板AWS Lambda,然后选择本地。选择确定,然后从头开始重复此过程。

页首

更新函数的配置

请执行下列操作之一:

  • 在包含适用于 JavaPythonNode.jsC# 的函数处理程序的代码文件打开后,在主菜单上,选择 Run (运行)Edit Configurations (编辑配置)。在 Run/Debug Configurations (运行/调试配置) 对话框中完成相应的操作,然后选择 OK (确定)

  • 打开 AWS Explorer(如果尚未打开)。如果您需要了解的内容切换到其他 AWS 区域,请立即执行此操作。ExpandLambda,选择要更改其配置的函数的名称,然后执行下列操作之一:

    • 更改超时、内存、环境变量和执行角色等设置 —右键单击函数的名称,然后选择更新函数配置

      选择“Update Function Configuration (更新函数配置)”命令

      完成 Update Configuration (更新配置) 对话框中的操作,然后选择 Update (更新)

    • 更改输入有效载荷等设置— 在主菜单上,选择运行编辑配置。在 Run/Debug Configurations (运行/调试配置) 对话框中完成相应的操作,然后选择 OK (确定)

      选择“Edit Configurations (编辑配置)”命令

      如果缺少配置详细信息,请先展开模板AWS Lambda,然后选择本地(对于函数的本地版本)或远程(对于相同函数的远程版本)。选择 OK (确定),然后从头开始重复此过程。

    • 更改函数处理程序名称或 Amazon Simple Storage Service (Amazon S3) 源存储桶等设置— 右键单击函数名称,然后选择更新函数代码

      选择“Update Function Code (更新函数代码)”命令

      完成 Update Code (更新代码) 对话框中的操作,然后选择 Update (更新)

    • 更改前面项目符号中未列出的其他可用属性设置— 更改函数的相应 AWS SAM 模板文件(例如,在名为template.yaml在项目中)。

      有关可用属性设置的列表,请参阅AWS::Serverless::Function中的awslab/无服务器应用程序模型存储 GitHub。

页首

删除函数

您可以使用 AWS Toolkit for JetBrains 删除 AWS Lambda 函数(该函数为AWS 无服务器应用程序的一部分。也可以删除独立 Lambda 函数

删除包含函数的无服务器应用程序

请参阅本主题前面的有关删除无服务器应用程序的说明。

页首

删除独立函数

  1. 打开 AWS Explorer(如果尚未打开)。如果您需要了解的内容切换到其他 AWS 区域,请立即执行此操作。

  2. ExpandLambda

  3. 右键单击要删除的函数的名称,然后选择 Delete Function (删除函数)

    选择“Delete Function (删除函数)”命令
  4. 输入函数的名称来确认删除,然后选择 OK (确定)。如果删除函数成功,则适用于 JetBrains 的 AWS 工具包会从Lambda列出。

页首

使用 AWS CloudFormation 堆栈

在你之后安装 AWS Toolkit for JetBrains,然后使用工具包首次连接到 AWS 账户,您可以通过此工具包来使用账户中的 AWS CloudFormation 堆栈,如下所示:

目前,您无法使用 AWS 工具包来直接使用 JetBrains创建堆栈更改堆栈设置。不过,您可以在使用 AWS 无服务器应用程序和 AWS Lambda 函数的过程中,间接执行这些任务,如下所示。

页首

创建堆栈

目前,您无法使用适用于 JetBrains 的 AWS 工具包直接创建 AWS CloudFormation 堆栈。但是,无论何时使用工具包部署 AWS 无服务器应用程序创建并部署 AWS Lambda 函数,此工具包通过以下方式做到这一点:先在 AWS CloudFormation 中创建相应的堆栈,然后使用该堆栈进行部署。

页首

更改堆栈设置

目前,您无法使用适用于 JetBrains 的 AWS 工具包直接更改 AWS CloudFormation 堆栈的设置。不过,您可以使用更新 AWS 无服务器应用程序的设置属于堆栈,或者更新 AWS Lambda 函数的配置属于堆栈。然后你部署无服务器应用程序或部署该函数,作为运行(调用)该函数的远程版本,再次。

页首

查看堆栈的事件日志

  1. 打开 AWS Explorer(如果尚未打开)。如果堆栈位于与当前 AWS 区域不同的 AWS 区域,请切换到其他 AWS 区域,其中包含它。

  2. 展开 CloudFormation

  3. 要查看堆栈的事件日志,请右键单击堆栈的名称。适用于 JetBrains 的 AWS 工具包将在CloudFormation工具窗口。

    要隐藏或显示 CloudFormation 工具窗口,请在主菜单上,依次选择 View (查看)Tool Windows (工具窗口)CloudFormation

    
        选择查看 AWS CloudFormation 堆栈的事件日志

页首

删除堆栈

  1. 打开 AWS Explorer(如果尚未打开)。如果您需要了解的内容切换到其他 AWS 区域,请立即执行此操作。

  2. 展开 CloudFormation

  3. 右键单击要删除的堆栈的名称,然后选择 Delete CloudFormation Stack (删除 CloudFormation 堆栈)

    
        选择删除从 AWS Explorer 启动的 AWS CloudFormation 堆栈
  4. 输入堆栈的名称来确认其删除,然后选择 OK (确定)。如果堆栈删除成功,适用于 JetBrains 的 AWS 工具包将从CloudFormation中的列表AWS Explorer 使用。如果堆栈删除失败,您可以通过查看堆栈的事件日志来进行故障排除。

页首

使用 Amazon CloudWatch Logs

在你之后安装 AWS Toolkit for JetBrains,然后使用工具包首次连接到 AWS 账户,您可以通过此工具包来使用账户中的 Amazon CloudWatch Logs,如下所示。

页首

使用亚马逊云服务器集群

在你之后安装 AWS Toolkit for JetBrains,然后使用工具包首次连接到 AWS 账户,您可以通过此工具包来使用账户中的 Amazon ECS 集群,如下所示。

调试集群中的代码

当您完成先决条件,请执行以下操作。

  1. 打开 AWS Explorer(如果尚未打开)。如果Amazon ECS 集群位于 AWS 区域与当前 AWS 区域不同的 AWS 区域,切换到其他 AWS 区域,其中包含它。

  2. 展开 ECS,然后展开 Clusters (集群)

  3. 展开您的 Amazon ECS 集群,右键单击您的服务,然后选择启用云调试。例如,在以下屏幕截图中,集群名为 java,服务名为 java-service

    
        在 AWS Explorer 中启用云调试
  4. 系统提示时,选择您的Amazon ECS 任务角色,然后选择确定

    状态栏显示消息 Configuring Cloud Debugging resource (配置云调试资源)。等待,直到构建输出” 选项卡构建工具窗口将显示一条成功的配置消息。(右下角也会显示相关弹出消息。) 这将需要花几分钟的时间。

    注意

    当您首次在 AWS 账户中启用代码调试时,适用于 JetBrains 的 AWS 工具包会在您的 AWS 账户中创建 Amazon S3 存储桶。此存储桶的名称遵循以下格式:do-not-delete-cloud-debug-Region-ID-account-ID。JetBrains 工具包将信息存储桶中存储桶中的信息以启用代码调试。请不要删除此存储桶或修改其内容。 如果您这样做的话,代码调试可能会停止工作或产生意外的结果。如果您意外删除或修改此存储桶,则 JetBrains 工具包将尝试重新创建该存储桶。您还可以强制 JetBrains 工具包重新创建存储桶,方法是选择启用云调试,或者通过选择禁用云调试如本过程后面部分所述。

  5. 在显示了要调试的代码后,在AWS Explorer 使用,展开ECS,展开集群,然后展开您的集群。此时将显示服务,旁边有一个调试图标。这表示现已启用服务以进行云调试。右键单击带调试图标的服务,然后选择 Debug (调试)

    
        在 AWS Explorer 中调试 Amazon ECS 服务
  6. Edit configuration (编辑配置) 对话框中编辑完配置,然后选择 Debug (调试)

    注意

    要稍后更改此配置,请在菜单栏上,选择 Run (运行)Edit Configurations (编辑配置)。然后展开Amazon ECS 服务云调试,然后选择服务的名称。

  7. 使用 IDE 的内置调试工具像往常一样调试代码。

  8. 如果您对代码进行更改,您可以重新开始调试。在AWS Explorer 使用,展开ECS,展开集群,然后展开您的集群。右键单击旁边带有调试图标的服务,然后选择 Debug (调试)

  9. 如果您更改关联的 Dockerfile,则必须重新构建并重新发布 Docker 映像,然后从头开始重复此过程。

  10. 要禁用调试,请在AWS Explorer 使用,展开ECS,展开集群,然后展开您的集群。右键单击旁边有调试图标的服务,然后选择 Disable Cloud Debugging (禁用云调试)。此时将显示一个弹出窗口,用于确认已禁用调试。

页首

使用 Amazon EventBridge 架构

请参阅 使用 Amazon EventBridge Schemas

页首

处理 Amazon S3 存储桶和对象

在你之后安装 AWS Toolkit for JetBrains,然后使用工具包首次连接到 AWS 账户,您可以通过此工具包来使用账户中的 Amazon S3 存储桶和对象,如下所示。

页首

使用 Amazon RDS

在你之后安装 AWS Toolkit for JetBrains,然后使用工具包首次连接到 AWS 账户,您可以通过此工具包来使用账户中的 Amazon RDS 数据库,如下所示。

页首

使用 Amazon Redshift

在你之后安装 AWS Toolkit for JetBrains,然后使用工具包首次连接到 AWS 账户,您可以通过此工具包来使用账户中的 Amazon Redshift 集群和数据库,如下所示。

页首