使用Cloud Toolkit实现端云互联(IntelliJ IDEA)

在开发应用时,您可以使用Alibaba Cloud Toolkit插件实现本地应用和部署在SAE中的应用的相互调用,即端云互联,帮助您提升开发效率。本文介绍使用Cloud Toolkit实现端云互联的前提条件及操作步骤。

前提条件

  • 确保IntelliJ IDEA为2018.3及以上版本。
  • 2020.9.1及以上版本的Cloud Toolkit能够基于本地工程的项目(Project)和模块(Module)粒度配置端云互联,如果想使用配置粒度功能,请将Cloud Toolkit升级到2020.9.1及以上版本。
    说明 如果Cloud Toolkit已经是2020.9.1版本,但没有配置粒度选项,请您卸载再重新安装Cloud Toolkit插件。
  • 在应用所在VPC内创建一台可使用SSH登录的ECS,用于建立端云互联通道。更多信息,请参见通过控制台使用ECS实例(快捷版)
    重要
    • ECS与应用必须处于同一VPC内。
    • SSH通道需要使用密码方式登录,暂不支持使用密钥对登录。
    • 如果操作系统配置代理,可能会导致连接端云互联通道失败。请关闭代理后重试。

使用限制

端云互联支持Java应用,而且不同Java微服务框架还有以下限制。
微服务框架使用限制
Spring Cloud如果使用Nacos进行配置管理,请确保Spring Cloud为Spring Cloud Edgware及以上版本。
Dubbo
  • Dubbo 2.7.2及以上版本
  • 依赖的服务注册及发现组件版本:
    • dubbo-nacos-registry 2.7.2及以上版本
    • edas-dubbo-extension 2.0.2及以上版本
HSF

步骤一:安装Cloud Toolkit

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

步骤二:配置Cloud Toolkit账号

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

  1. 启动IntelliJ IDEA。
  2. 在顶部菜单栏中选择Tools > Alibaba Cloud > Preferences...
  3. Settings对话框中选择Alibaba Cloud Toolkit > Accounts
  4. Accounts界面中设置AccessKey IDAccessKey Secret,然后单击OK
    如果您使用子账号的AccessKey ID和AccessKey Secret,请确认该子账号至少拥有部署应用的权限,具体操作,请参见为RAM用户授权Accounts

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

    • 如果您已经注册过阿里云账号,在Accounts界面中单击Get existing AK/SK,进入阿里云登录页面。用已有账号登录后,跳转至安全信息管理页面,获取AccessKey IDAccessKey Secret
    • 如果您还没有阿里云账号,在Accounts界面中单击Sign up,进入阿里云账号注册页面,注册账号。注册完成后按照上述方式获取AccessKey IDAccessKey Secret

步骤三:端云互联配置

  1. 在顶部菜单栏中选择Tools > Alibaba Cloud > Preferences...
  2. Settings对话框中选择Alibaba Cloud Toolkit > Microservice
  3. Microservice界面中选中端云互联,配置端云互联相关参数,然后单击Apply
    配置端云互联参数

    参数说明如下:

    参数描述
    产品选择Serverless 应用引擎(SAE)
    云端互联环境设置端云互联应用所在的地域和命名空间。
    SpringCloud服务端口如果是Spring Cloud应用,您需要在SpringCloud服务端口区域内添加该应用的服务端口,其他类型应用则不需要填写。
    跳板机配置
    • 跳板机IP:输入您创建的ECS实例的公网IP地址。
    • 跳板机账号:输入用于建立端云互联通道的用户名。
    • 跳板机密码:输入用于建立端云互联通道的密码。
    说明 您可以直接输入您用于建立端云互联通道的ECS实例的用户名和密码,也可以在这里输入新的用户名和密码,然后通过单击初始化账号...增加新用户及密码。
    初始化账号...
    • 如果您输入的是ECS实例的root用户名和密码,则会使用此root账号进行配置。如果成功则会出现配置已添加成功的提示弹窗。
    • 如果使用新账号或其他非root账号进行互联,那么需要root权限对此账号进行代理配置,在Add SSH Rule对话框中输入Password,然后单击Add即可。
      重要
      • 此处使用ECS实例的密码只是用来创建一个网络代理,不会将ECS实例的用户名和密码用于其他用途。
      • 推荐您使用新账号或其他非root账号进行互联,后续可将此新账号或非root账号直接共享给其他需要端云互联的团队成员使用,避免泄漏root信息。

步骤四:启动本地应用进行端云互联

启动本地应用,如果当前状态处于端云互联状态,那么会有如下提示:

启动本地应用进行端云互联

并且,在启动应用之后会启动一个etrans的进程:

启动etrans的进程
说明

端云互联过程中,如果遇到问题,可以单击一键诊断,排查etrans通道启动异常服务连接不通等问题。

更多信息