You can use Alibaba Cloud Toolkit to implement interconnection between on-premises applications and cloud applications that are deployed on Serverless App Engine (SAE). This helps you efficiently develop applications. This topic describes how to use Alibaba Cloud Toolkit to implement interconnection between on-premises and cloud applications.
Prerequisites
The version of IntelliJ IDEA is 2018.3 or later.
The version of Alibaba Cloud Toolkit is 2020.9.1 or later. Alibaba Cloud Toolkit 2020.9.1 or later allows you to configure the interconnection between on-premises and cloud applications for on-premises projects at a specified configuration granularity. The configuration granularity can be project or module. If you want to configure the interconnection between on-premises and cloud applications for on-premises projects at a specified configuration granularity, you must upgrade Alibaba Cloud Toolkit to 2020.9.1 or later.
NoteIf the version of your Alibaba Cloud Toolkit is 2020.9.1 but the configuration granularity option is unavailable, uninstall and then reinstall Alibaba Cloud Toolkit.
An Elastic Compute Service (ECS) instance that can be accessed over Secure Shell (SSH) is created in the virtual private cloud (VPC) where your application resides to establish channels between on-premises and cloud applications. For more information, see Create and manage an ECS instance in the console (express version).
ImportantThe ECS instance and the application must reside in the same VPC.
The SSH channel requires password logon. Key pair logon is not supported.
If a proxy is configured for your operating system, the system may fail to establish a channel between on-premises and cloud applications. You must disable the proxy and then try again.
Limits
Java applications in the on-premises and cloud environments can be interconnected. The following table describes the limits on Java applications based on the microservices framework.
Microservices framework | Limits |
Spring Cloud | If you use a Nacos instance to manage application configurations, make sure that Spring Cloud Edgware or later is used. |
Dubbo |
|
HSF | None |
Step 1: Install Alibaba Cloud Toolkit
Start IntelliJ IDEA.
Install the latest version of Alibaba Cloud Toolkit in IntelliJ IDEA.
macOS: In the left-side navigation pane of the Preferences page, click Plugins. On the right side of the page, enter Alibaba Cloud Toolkit in the search box and click the search icon. Then, click Install.
Windows: In the left-side navigation pane of the Settings page, click Plugins. On the right side of the page, enter Alibaba Cloud Toolkit in the search box and click the search icon. Then, click Install.
After Alibaba Cloud Toolkit is installed in IntelliJ IDEA, restart IntelliJ IDEA. The Alibaba Cloud Toolkit icon
appears in the toolbar.
Step 2: Configure an Alibaba Cloud Toolkit account
After Alibaba Cloud Toolkit is installed, use your AccessKey ID and AccessKey secret to configure an Alibaba Cloud Toolkit account.
Start IntelliJ IDEA.
In the top navigation bar of IntelliJ IDEA, choose .
In the left-side navigation pane, choose Alibaba Cloud Toolkit > Accounts.
On the Accounts page, set the Access Key ID and Access Key Secret parameters and click OK.
If you use the AccessKey ID and the AccessKey secret of a Resource Access Management (RAM) user, make sure that the RAM user is authorized to deploy applications. For more information, see Grant permissions to a RAM user.
If you already have an Alibaba Cloud account, click Get existing AK/SK on the Accounts page. The logon page of Alibaba Cloud appears. After you log on to the system with your Alibaba Cloud account, you are navigated to the AccessKey Management page. On this page, obtain the AccessKey ID and the AccessKey secret of the account.
If you do not have an Alibaba Cloud account, click Sign up on the Accounts page. On the page that appears, create an Alibaba Cloud account. Then, obtain the AccessKey ID and the AccessKey secret of the account by using the preceding method.
Step 3: Configure interconnection between on-premises and cloud applications
In the top navigation bar, choose .
In the Settings dialog box, choose .
On the Microservice page, select Interconnection Between On-premises and Cloud Applications, configure the parameters, and then click Apply.
The following table describes the parameters.
Parameter
Description
Product
Select Serverless App Engine (SAE).
Environment for Interconnection Between On-premises and Cloud Applications
Specify the region and the namespace where the cloud applications that you want to call are deployed.
Spring Cloud Service Port
If you use a Spring Cloud application, you must enter the service port number of your application in the Spring Cloud Service Port field. You do not need to configure this parameter for other types of applications.
Jump Server Settings
Jump Server IP: the public IP address of the ECS instance.
Account: the username that is used to establish channels between on-premises and cloud applications.
Password: the password that is used to establish channels between on-premises and cloud applications.
NoteYou can enter the username and password of the ECS instance that is used to establish the channels between on-premises and cloud applications. Alternatively, you can enter a new username and password, and then click Initialize Account... to configure a proxy.
Initialize Account...
If you enter the root username and password of the ECS instance, the root account is used. After you configure the settings, a message indicating that the configurations are added appears.
If you use a new account or a non-root account, you must obtain the root permission to configure the proxy. In the Add SSH Rule dialog box, configure the Password parameter and click Add.
ImportantThe username and password of the ECS instance are used only to create a proxy.
We recommend that you use a new account or a non-root account. You can share the account with other team members who want to connect on-premises and cloud applications. This prevents data leakage from the root account information.
Step 4: Start the on-premises application for connecting to the cloud application
Start the on-premises application. If the application is interconnected with a cloud application, the following message appears.
An etrans process is started after the application starts:
If you encounter issues during the interconnection between on-premises and cloud applications, you can click Quick Diagnostics to troubleshoot the issues such as abnormal startup of the etrans channel and service disconnected.
References
If issues occur when you use Alibaba Cloud Toolkit to implement interconnection between on-premises and cloud applications, troubleshoot the issues by using the methods that are described in FAQ about on-premises and off-premises connection.
For information about how to use the IntelliJ IDEA plug-in to deploy applications to SAE with a few clicks, see Use the Alibaba Cloud Toolkit for IntelliJ IDEA plug-in to deploy an application.