使用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同时退出，如下所示。

说明 如果原etrans进程未停止时重启应用，当前应用的端云互联将无法生效。启动应用时，弹出 端云互联已启用 对话框，表示当前应用的端云互联已生效。

更多信息

• 在使用Cloud Toolkit实现端云互联时，如果遇到相关问题，请参见 端云互联问题 。
• 您可以在EDAS上代理购买ECS，具体操作，请参见 创建ECS实例 。
• 如果您想使用IntelliJ IDEA插件快速在EDAS上部署应用，请参见 使用IntelliJ IDEA部署应用到EDAS 。