All Products
Search

This Product

    Enterprise Distributed Application Service:Set up local development with on-premises-to-cloud interconnection

    Document Center

    Enterprise Distributed Application Service:Set up local development with on-premises-to-cloud interconnection

    Last Updated:Mar 11, 2026

    Alibaba Cloud Toolkit lets you run a local service registry or join a custom registry directly from IntelliJ IDEA. With this setup, your on-premises microservice applications can discover and call cloud-deployed applications on Enterprise Distributed Application Service (EDAS), and vice versa, without manually editing configuration files or binding hosts. This helps you improve development efficiency.

    Before you begin

    Supported frameworks and port requirements

    Alibaba Cloud Toolkit supports three microservice frameworks: High-speed Service Framework (HSF), Spring Cloud, and Apache Dubbo.

    Port requirements

    The ports that must be available depend on your framework:

    FrameworkRequired portsDetails
    HSF (lightweight configuration center)8080, 8848, 9600All three ports must be free
    Spring Cloud or Apache Dubbo (open-source Nacos)8080, 8848Both ports must be free

    Each port serves a specific purpose:

    PortPurpose
    8848Nacos service registration and configuration management
    9600HSF or Apache Dubbo service registration and subscription
    8080Alibaba Naming Service (ANS) service registration and Application Configuration Management (ACM) configuration management

    Workflow overview

    1. Download and open the sample projects in IntelliJ IDEA.

    2. Configure the registry in Alibaba Cloud Toolkit for each project.

    3. Run both projects and verify that the services communicate.

    Step 1: Download and open the sample projects

    1. Download the following sample projects:

    2. Extract both ZIP files and open each project in IntelliJ IDEA.

    3. Complete Step 2 for each project.

    Step 2: Configure the registry

    1. In IntelliJ IDEA, choose File > Settings.

    2. In the left pane, go to Alibaba Cloud Toolkit > Microservice.

    3. Select a registry option:

      Note This guide uses Use Local Registry to demonstrate the setup.
      OptionDescription
      No RegistryNo registry is used.
      Use Local RegistryStarts the local lightweight configuration center. Requires ports 8848, 9600, and 8080 to be free. After you select this option, click Start to launch the registry or Stop to shut it down. Access the registry console at http://localhost:<Specified port>.
      Join Custom RegistryConnects to a registry at a domain name or IP address that you specify. When your applications run in your on-premises environment, EDAS uses -D JVM parameters to configure the registry for your applications and registers the applications in the registry.
      Interconnection Between On-premises and Cloud ApplicationsEnables mutual calling and testing between on-premises and cloud-deployed applications.

    4. Click Apply, then click OK.

    Step 3: Run the projects and verify the result

    1. Start both the nacos-service-provider and nacos-service-consumer projects in IntelliJ IDEA.

    2. Open a browser and go to https://127.0.0.1:18082/echo-feign/helloworld. Port 18082 is the consumer project's port.

    3. If the page returns the string helloworld, the provider and consumer are communicating through the local registry, and on-premises-to-cloud interconnection is working as expected.