使用Cloud Toolkit实现端云互联（IntelliJ IDEA）

使用限制

Java应用限制

端云互联目前支持Java应用。不同Java微服务框架还有以下限制：

其他语言应用设置

非Java语言可使用容器模式，无特殊限制。

步骤一：安装Cloud Toolkit

1. 启动IntelliJ IDEA。
2. 在IntelliJ IDEA中安装插件。
   • macOS系统： 在顶部菜单栏选择IntelliJ IDEA > Preference...，在Preference配置页面左边导航栏单击Plugins，搜索Alibaba Cloud Toolkit，并单击Install安装。
   • Windows系统：在顶部菜单栏选择File > Settings，在Settings页面的左侧导航栏单击Plugins，搜索Alibaba Cloud Toolkit，并单击Install安装。
3. 在IntelliJ IDEA中插件安装成功后，重启IntelliJ IDEA，您可以在工具栏看到Alibaba Cloud Toolkit的图标（）。

步骤二：配置阿里云账号

在安装完Alibaba Cloud Toolkit后，您需使用AccessKey ID和AccessKey Secret来配置阿里云的账号。

1. 启动IntelliJ IDEA。

2. 在顶部菜单栏中选择Tools > Alibaba Cloud > Preferences...。

3. 在Settings对话框中选择Alibaba Cloud Toolkit > Accounts。

4. 在Accounts对话框中设置AccessKey ID和AccessKey Secret，然后单击OK。

   

   关于阿里云账号说明如下：

   • 如果您已经注册过阿里云账号，在Accounts对话框中单击Get existing AK/SK，进入阿里云登录页面。用已有账号登录后，跳转至安全信息管理页面，获取AccessKey ID和AccessKey Secret。

   • 如果您还没有阿里云账号，在Accounts对话框中单击Sign up，进入阿里云账号注册页面，注册账号。注册完成后按照上述方式获取AccessKey ID和AccessKey Secret。

步骤三：配置端云互联

1. 启动IntelliJ IDEA。

2. 在顶部菜单栏，选择Tools > Alibaba Cloud > Preferences...。

3. 在Settings对话框，选择Alibaba Cloud Toolkit > Microservice > Microservice。

4. 在Microservice对话框，配置端云互联相关参数。

   

   参数	描述
   配置粒度	本地工程需要使用端云互联功能的粒度，包含项目和模块。 （推荐）项目：当前工程使用统一的端云互联配置。适用于单模块工程或模块间无配置差异的多模块工程。 模块：当前工程包含多个模块，其中仅某个模块需要使用端云互联或不同模块的端云互联配置需求不同。如果需要为不同模块配置端云互联，选择具体模块，完成各自的端云互联配置。
   端云互联	选中端云互联，启用端云互联功能。 启用端云互联功能后，本地应用默认注册到云端注册中心并订阅云端注册中心的服务，本地应用中的服务可以和云端服务相互调用。 如果仅需要调用云端服务，不希望云端服务调用本地服务，可以选中只订阅云端服务，不注册本地服务。
   产品	选择企业级分布式应用服务（EDAS）。
   云端互联环境	设置需要调用的云端应用所在的地域和命名空间。除了默认命名空间外，其他命名空间下的应用需按照以下步骤手动打开允许远程调试开关。 登录EDAS控制台。 在左侧导航栏，选择资源管理 > 微服务空间，然后在顶部菜单栏选择地域。 在命名空间列表中目标命名空间的操作列，单击编辑按钮。 在编辑命名空间对话框，打开允许远程调试开关。
   本地服务归属应用	选择EDAS在本地所启动的微服务应用。
   本地SpringCloud服务端口	如果是Spring Cloud应用，则需在SpringCloud服务端口文本框内添加该应用的服务端口，其他类型应用无需填写。
   代理	选择代理机。关于代理配置的相关内容，请参见配置代理。
   初始化代理...	Kubernetes代理无需此操作。 SSH/SOCKS代理需进行此操作，配置SSH规则使得端云互联生效。 说明 如果代理列表中最后一级SSH代理非root账号，会提示您提供root权限来进行配置。配置完成后，即可正常使用。若您不希望插件帮您配置，也可手动配置代理。关于手动初始化代理的相关操作，请参见配置代理。
   加入全链路流控	选中加入全链路流控，选择本地服务归属灰度分组，控制请求链路流向。 说明 全链路流控是EDAS提供的对服务流量进行细粒度控制的核心能力。通过全链路流控，您可在同一套开发环境中进行多特性开发且相互间不受干扰。
   高级配置	选中自动关闭启动提示，可设置应用启动提示停留时间，单位毫秒。
   一键诊断	端云互联过程中，如果遇到问题，单击一键诊断，排查etrans通道启动异常和服务连接不通等问题。

5. 单击Apply，然后单击OK。

   重要

   如果使用EDAS专有云企业版，还需要执行以下步骤在Cloud Toolkit中配置Endpoint。Endpoint请联系EDAS技术支持获取。

   1. 在Preference（Filtered）对话框的左侧导航栏，选择Appearance & Behavior > Endpoint。

   2. 在Endpoint对话框设置Endpoint。配置完成后，单击Apply and Close。

步骤四：使用本地进程模式进行端云互联

启动本地应用。如果当前状态处于端云互联状态，会有如下提示。

在启动应用之后，会启动一个etrans的进程。

步骤五：停止端云互联

停止或重启应用时，需先停止原来的etrans进程。单击顶部的图标，将进程和etrans同时退出，如下所示。

更多信息

• 在使用Cloud Toolkit实现端云互联时，如果遇到相关问题，请参见端云互联问题。

• 您可以在EDAS上代理购买ECS，具体操作，请参见创建ECS实例。

• 如果您想使用IntelliJ IDEA插件快速在EDAS上部署应用，请参见使用IntelliJ IDEA部署应用到EDAS。

• 如果您想使用CloudToolkit 的其他功能，您也可以参见官方文档，以获取更多详细信息。