在 IntelliJ IDEA 中使用 Cloud Toolkit 快速部署应用至 ECS 集群

步骤一：安装 Cloud Toolkit

1. 启动 IntelliJ IDEA。
2. 在 IntelliJ IDEA 中安装最新版本的插件。

   如果您之前已安装过旧版安装包，请升级至最新版本。

   • Mac 系统：进入 Preference 配置页面，选择左边的 Plugins，在右边的搜索框里输入 Alibaba Cloud Toolkit ，并单击Install 安装。
   • Windows 系统：进入 Plugins 选项，搜索 Alibaba Cloud Toolkit，并单击 Install 安装。
3. 在 IntelliJ IDEA 中插件安装成功后，重启 IntelliJ IDEA，您可以在工具栏看到 Alibaba Cloud Toolkit 的图标（）。

步骤二：配置 Access Key ID 和 Access Key Secret

在安装完 Alibaba Cloud Toolkit 后，您需使用 Access Key ID 和 Access Key Secret 来配置 Cloud Toolkit 的账号。

1. 启动 IntelliJ IDEA。
2. 单击 Alibaba Cloud Toolkit 的图标（），在下拉列表中单击 Preference…，进入设置页面，在左侧导航栏选择Alibaba Cloud Toolkit > Accounts 。
3. 在 Accounts 界面中设置 Access Key ID和 Access Key Secret，然后单击 OK。

   注意

   1. 如果您使用子账号的 Access Key ID 和 Access Key Secret，请确认该子账号至少拥有部署应用的权限，具体操作方法请参见常见问题：应用列表获取不到应用。
   2. 如果您是 EDAS 专有云企业版用户，还需配置 Endpoint 才能正常使用 Cloud Toolkit 功能。
   
   • 如果您已经注册过阿里云账号，在 Accounts 界面中单击 Get existing AK/SK，进入阿里云登录页面。用已有账号登录后，跳转至安全信息管理页面，获取 Access Key ID 和 Access Key Secret。
   • 如果您还没有阿里云账号，在 Accounts 界面中单击 Sign up，进入阿里云账号注册页面，注册账号。注册完成后按照上述方式获取 Access Key ID 和 Access Key Secret。

步骤三：部署应用到 ECS 集群或 Swarm 集群

1. 在 IntelliJ IDEA 上单击 Cloud Toolkit 的图标（），在下拉列表中选择Deploy to EDAS > EDAS for ECS Application 。

   或在 IntelliJ IDEA 上打开 Run/Debug configurations 对话框，展开 Templates选项，选择EDAS on Alibaba Cloud > EDAS configuration factory 。

2. 在 Deploy to EDAS 对话框配置应用部署参数。

   说明 如果您还没有在 EDAS 上创建应用，在对话框右上角单击 Create application on EDAS console…，跳转到 EDAS 控制台创建应用。

   
   1. 在配置页面中根据您的实际需求选择应用的 Region、Namespace、Application 和 Group。
      • Region：应用所在地域。
      • Namespace：应用所在命名空间。
      • Application：应用名称。
      • Group：应用分组。

      注意 如果在应用列表中获取不到应用，请参见常见问题：应用列表获取不到应用进行操作排查。

   2. 设置构建方式。
      • Maven Build：选择 Maven Build 方式来构建应用时，系统会默认添加一个 Maven 任务来构建部署包。
      • Upload File：选择 Upload File 方式来构建应用时，选择上传您的 WAR 包或者 JAR 包，然后进行部署。
   3. 设置应用的版本描述信息和分批部署信息。
      • Version：部署版本。
      • Description：部署信息描述。
      • Batch：分批数。如果您的应用有多个分组，并且在部署时选择部署全部分组，那么将会自动按照分组粒度来分批，Batch 值不用设置。
      • BatchWaitTime：分批部署等待时间，单位为分钟。

      注意 如果您的插件界面没有分批部署设置模块，请将您的插件升级至最新版本。

3. 单击 Run 执行上面步骤的运行配置，IntelliJ IDEA 的 Console 区域会打印部署日志。您可以根据日志信息检查部署结果。

步骤四：管理 Maven 构建任务

在 IntelliJ IDEA 中安装的 Cloud Toolkit 内可以部署 Maven 的构建任务。您也可以在 Deploy to EDAS 的配置页面的 Before launch 区域来添加、删除、修改和移动 Maven 构建任务。

在添加 Maven 构建任务编辑框中，您可以单击右侧的文件夹按钮选择当前工程的所有可用模块，并在 Command line 中编辑构建命令。

部署多模块工程

实际工作中碰到的大部分 Maven 工程都是多模块的，各个项目模块可以独立开发，其中某些模块又可能会使用到其他的一些模块的功能，这样的项目工程就是多模块工程。

如果您的工程项目为 Maven 多模块工程并且想部署工程中的某子模块，那么需要保证 EDAS Deployment Configurations 页面中的 Before launch 中的 Maven 构建任务中最后一个任务为该子模块的构建任务。管理 Maven 构建任务的具体操作请参见步骤四：管理 Maven 构建任务。

例如一个 CarShop 工程存在以下示例的子模块：

• itemcenter-api
• itemcenter
• detail

其中 itemcenter 和 detail 为子模块，且都依赖于 itemcenter-api 模块，现在想部署 itemcenter 模块，只需要在配置页面中的 Before launch 中增加如下两个 Maven 任务。

• 增加一个在父工程 carshop 中执行 mvn clean install 的 Maven 任务。
• 增加一个在子模块 itemcenter 中执行 mvn clean package Maven 任务。

专有云支持

此插件可以在专有云曙光 V3.8.0 或更新版本使用，在使用前需要按照以下步骤在插件中配置 EDAS EndPoint。Endpoint 请联系 EDAS 技术支持获取。

1. 在 Preference (Filtered) 对话框的左侧导航栏中选择 Appearance & BehaviorEndpoint。
2. 在 Endpoint 界面中设置 Endpoint，配置完成后，单击 Apply and Close。

常见问题：应用列表获取不到应用

通常出现这种情况为使用子账号来部署应用，且子账号没有同步到 EDAS 系统或者没有进行正确授权，从而导致在应用列表下拉框中看不到应用。您可以通过 RAM 授权或 EDAS 子账号授权来确保子账号已经同步到 EDAS 并且得到授权。

RAM 授权

该授权方式可使子账号访问 EDAS 的所有资源。

1. 在 RAM 控制台左侧导航栏中选择人员管理 > 用户。
2. 在用户页面上找到需要授权的子用户，单击操作列中的添加权限。
3. 在添加权限面板的选择权限区域中，搜索 AliyunEDASFullAccess 权限，单击权限策略将其添加至右侧的已选择列表中，然后单击确定。
4. 在添加权限的授权结果页面上，查看授权信息摘要，并单击完成。
5. 使用主账号登录 EDAS 控制台，在左侧导航栏选择系统管理 > 子账号 ，单击子账号页面右上角的同步子账号。

EDAS 子账号授权

该授权方式可使子账号细粒度授权访问 EDAS 的资源。

1. 使用主账号登录 EDAS 控制台。
2. 在左侧导航栏选择系统管理 > 角色 ，单击角色页面右上角的创建角色。
3. 输入一个角色名称，在可选权限区域框中，选择应用管理 > 应用列表 > 基本信息 > 部署应用 ，单击添加将部署应用角色添加到已选权限，然后单击确定。
4. 在左侧导航栏选择系统管理 > 子账号 ，单击子账号页面右上角的同步子账号。
5. 选择需进行授权的子账号，在操作列单击管理角色，在左侧穿梭框中搜索并选择上面创建的角色，将该角色添加到右侧已选角色列表中，然后单击确定。
6. 选择需进行授权的子账号，在操作列单击授权应用，选择应用添加到右侧列表进行授权，然后单击确定。

问题反馈

如果您在使用工具部署应用的过程中有任何疑问，欢迎您扫描下面的二维码加入钉钉群进行反馈。