文档

使用Dubbo开发应用并部署到EDAS

更新时间:

您可以将Dubbo微服务应用托管到EDAS,使用EDAS提供的共享组件、企业级安全加固和完整的微服务解决方案,帮助您节省运维成本、提升安全性和开发效率。本文将介绍如何在本地通过XML配置的方式开发一个Dubbo微服务示例应用(包含一个服务提供者Provider和一个服务消费者Consumer)并部署到EDAS。

背景信息

您只需要关注Dubbo应用自身的逻辑,无需再关注注册中心、配置中心和元数据中心的搭建和维护,托管后还可以使用EDAS提供的弹性伸缩、限流降级、监控及微服务治理能力,而且整个托管过程对您来说是完全透明的,不会增加您的理解成本和开发成本。

如果已有Dubbo应用,可以直接部署到EDAS的ECS或K8s集群,更多信息,请参见应用创建和部署概述(ECS)创建和部署应用概述(K8s)

准备工作

在开始开发前,请确保您已经完成以下工作:

  • 下载Maven并设置环境变量。

  • 下载最新版本的Nacos Server

  • 按以下步骤启动Nacos Server。

    1. 解压下载的Nacos Server压缩包

    2. 进入nacos/bin目录,启动Nacos Server。

      • Linux/Unix/Mac系统:执行命令sh startup.sh -m standalone

      • Windows系统:双击执行startup.cmd文件。

说明

在本地开发应用时,可以使用Alibaba Cloud Toolkit插件实现本地应用和部署在EDAS中的应用的相互调用,即端云互联,而无需搭建VPN,帮助您提升开发效率。更多信息,请参见端云互联简介

版本说明

EDAS支持托管2.5.x,2.6.x,2.7.x版本的Dubbo。推荐使用2.7.x,可以获得更强大的服务治理能力。本文将会以2.7.3版本为例,介绍如何将Dubbo应用托管到EDAS

创建服务提供者

在本地创建一个提供者应用工程,添加依赖,配置服务注册与发现,并将注册中心指定为Nacos。

  1. 创建Maven项目并引入依赖。

    1. 使用IDE(如IntelliJ IDEA或Eclipse)创建一个Maven项目。

    2. pom.xml文件中添加dubbo、dubbo-registry-nacos和nacos-client依赖。

      <dependencies>
      
          <dependency>
              <groupId>org.apache.dubbo</groupId>
              <artifactId>dubbo</artifactId>
              <version>2.7.3</version>
          </dependency>
      
          <dependency>
              <groupId>org.apache.dubbo</groupId>
              <artifactId>dubbo-registry-nacos</artifactId>
              <version>2.7.3</version>
          </dependency>
      
          <dependency>
              <groupId>com.alibaba.nacos</groupId>
              <artifactId>nacos-client</artifactId>
              <version>1.1.1</version>
          </dependency>
      </dependencies>            
  2. 开发Dubbo服务提供者。

    Dubbo中服务都是以接口的形式提供的。

    1. src/main/java路径下创建一个packagecom.alibaba.edas

    2. com.alibaba.edas下创建一个接口(interface)IHelloService,里面包含一个SayHello方法。

        package com.alibaba.edas;
      
        public interface IHelloService {
            String sayHello(String str);
        }                                
    3. com.alibaba.edas下创建一个类IHelloServiceImpl,实现此接口。

        package com.alibaba.edas;
      
        public class IHelloServiceImpl implements IHelloService {
            public String sayHello(String str) {
                return "hello " + str;
            }
        }                          
  3. 配置Dubbo服务。

    1. src/main/resources路径下创建provider.xml文件并打开。

    2. provider.xml中,添加Spring相关的XML Namespace(xmlns)和XML Schema Instance(xmlns:xsi),以及Dubbo相关的Namespace(xmlns:dubbo)和Schema Instance(xsi:schemaLocation)。

      <beans xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
      xmlns:dubbo="http://dubbo.apache.org/schema/dubbo"
      xmlns="http://www.springframework.org/schema/beans"
      xsi:schemaLocation="http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans-4.3.xsd
      http://dubbo.apache.org/schema/dubbo http://dubbo.apache.org/schema/dubbo/dubbo.xsd">
                                      
    3. provider.xml中将接口和实现类暴露成Dubbo服务。

        <dubbo:application name="demo-provider"/>
      
        <dubbo:protocol name="dubbo" port="28082"/>
      
        <dubbo:service interface="com.alibaba.edas.IHelloService" ref="helloService"/>
      
        <bean id="helloService" class="com.alibaba.edas.IHelloServiceImpl"/>                                
    4. provider.xml中将注册中心指定为本地启动的Nacos Server。

      <dubbo:registry address="nacos://127.0.0.1:8848" />                                
      • 127.0.0.1为Nacos Server的地址。如果您的Nacos Server部署在另外一台机器,则需要修改成对应的IP地址。当将应用部署到EDAS后,无需做任何修改,注册中心会替换成EDAS上的注册中心的地址。

      • 8848为Nacos Server的端口号,不可修改。

  4. 启动服务。

    1. com.alibaba.edas中创建类Provider,并按下面的代码在Provider的main函数中加载Spring Context,将配置好的Dubbo服务暴露。

      package com.alibaba.edas;
      
      import org.springframework.context.support.ClassPathXmlApplicationContext;
      
      public class Provider {
          public static void main(String[] args) throws Exception {
              ClassPathXmlApplicationContext context = new ClassPathXmlApplicationContext(new String[] {"provider.xml"});
              context.start();
              System.in.read();
          }
      }                
    2. 执行Provider的main函数,启动服务。

  5. 登录Nacos控制台http://127.0.0.1:8848,在左侧导航栏中单击服务列表,查看提供者列表。可以看到服务提供者里已经包含了com.alibaba.edas.IHelloService,且可以查询该服务的服务分组提供者IP

创建服务消费者

在本地创建一个消费者应用工程,添加依赖,添加订阅服务的配置。

  1. 创建Maven项目并引入依赖。

    1. 使用IDE(如IntelliJ IDEA或Eclipse)创建一个Maven项目。

    2. pom.xml文件中添加dubbo、dubbo-registry-nacos和nacos-client依赖。

      <dependencies>
      
          <dependency>
              <groupId>org.apache.dubbo</groupId>
              <artifactId>dubbo</artifactId>
              <version>2.7.3</version>
          </dependency>
      
          <dependency>
              <groupId>org.apache.dubbo</groupId>
              <artifactId>dubbo-registry-nacos</artifactId>
              <version>2.7.3</version>
          </dependency>
      
          <dependency>
              <groupId>com.alibaba.nacos</groupId>
              <artifactId>nacos-client</artifactId>
              <version>1.1.1</version>
          </dependency>
      </dependencies>            
  2. 开发Dubbo服务提供者。

    Dubbo中服务都是以接口的形式提供的。

    1. src/main/java路径下创建Package,命名为com.alibaba.edas

    2. com.alibaba.edas下创建一个接口(interface)IHelloService,里面包含一个SayHello方法。

      说明

      通常是在一个单独的模块中定义接口,服务提供者和服务消费者都通过Maven依赖来引用此模块。本文档为了简便,服务提供者和服务消费者分别创建两个完全一模一样的接口,实际使用中不推荐这样使用。

        package com.alibaba.edas;
      
        public interface IHelloService {
            String sayHello(String str);
        }                                
  3. 配置Dubbo服务。

    1. src/main/resources路径下创建consumer.xml文件并打开。

    2. consumer.xml中,添加Spring相关的XML Namespace(xmlns)和XML Schema Instance(xmlns:xsi),以及Dubbo相关的Namespace(xmlns:dubbo)和Schema Instance(xsi:schemaLocation)。

      <beans xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
      xmlns:dubbo="http://dubbo.apache.org/schema/dubbo"
      xmlns="http://www.springframework.org/schema/beans"
      xsi:schemaLocation="http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans-4.3.xsd
      http://dubbo.apache.org/schema/dubbo http://dubbo.apache.org/schema/dubbo/dubbo.xsd">                              
    3. consumer.xml中添加如下配置,订阅Dubbo服务。

        <dubbo:application name="demo-consumer"/>
      
        <dubbo:registry address="nacos://127.0.0.1:8848"/>
      
        <dubbo:reference id="helloService" interface="com.alibaba.edas.IHelloService"/>
  4. 启动、验证服务。

    1. com.alibaba.edas下创建类Consumer,并按下面的代码在Consumer的main函数中加载Spring Context,订阅并消费Dubbo服务。

          package com.alibaba.edas;
      
          import org.springframework.context.support.ClassPathXmlApplicationContext;
      
          import java.util.concurrent.TimeUnit;
      
          public class Consumer {
              public static void main(String[] args) throws Exception {
                  ClassPathXmlApplicationContext context = new ClassPathXmlApplicationContext(new String[] {"consumer.xml"});
                  context.start();
                  while (true) {
                      try {
                          TimeUnit.SECONDS.sleep(5);
                          IHelloService demoService = (IHelloService)context.getBean("helloService");
                          String result = demoService.sayHello("world");
                          System.out.println(result);
                      } catch (Exception e) {
                          e.printStackTrace();
                      }
                  }
              }
          }               
    2. 执行Consumer的main函数,启动服务。

  5. 验证创建结果。

    启动后,可以看到控制台不断地输出hello world,表明服务消费成功。

    登录Nacos控制台http://127.0.0.1:8848,在左侧导航栏中单击服务列表,再在服务列表页面选择调用者列表

    可以看到包含了com.alibaba.edas.IHelloService,且可以查看该服务的服务分组调用者IP

部署到EDAS

应用可以直接部署到EDAS中,无需做任何修改,注册中心会被自动替换为EDAS上的注册中心。

您可以根据实际需求选择部署的集群类型(主要为ECS集群或容器服务Kubernetes集群)和部署途径(控制台或工具),更多信息,请参见在ECS集群中部署应用在K8s集群中使用镜像部署Java微服务应用

说明

EDAS集成的ACM即Nacos的正式商用版本。当您将应用部署到EDAS的时候,EDAS会自动替换您本地Nacos Server的地址和服务端口(127.0.0.1:8848),您无需修改。

如果您使用控制台部署,在部署前,需要在本地应用程序中完成以下操作:

  1. pom.xml文件中添加以下打包插件的配置。

    • Provider

      <build>
       <plugins>
             <plugin>
                 <groupId>org.springframework.boot</groupId>
                 <artifactId>spring-boot-maven-plugin</artifactId>
                 <executions>
                     <execution>
                         <goals>
                             <goal>repackage</goal>
                         </goals>
                         <configuration>
                             <classifier>spring-boot</classifier>
                             <mainClass>com.alibaba.edas.Provider</mainClass>
                         </configuration>
                     </execution>
                 </executions>
             </plugin>
       </plugins>
      </build>
                                  
    • Consumer

      <build>
       <plugins>
             <plugin>
                 <groupId>org.springframework.boot</groupId>
                 <artifactId>spring-boot-maven-plugin</artifactId>
                 <executions>
                     <execution>
                         <goals>
                             <goal>repackage</goal>
                         </goals>
                         <configuration>
                             <classifier>spring-boot</classifier>
                             <mainClass>com.alibaba.edas.Consumer</mainClass>
                         </configuration>
                     </execution>
                 </executions>
             </plugin>
       </plugins>
      </build>
                                  
  2. 执行mvn clean package将本地的程序打成JAR包。

在将Dubbo微服务应用部署到EDAS后,您可以使用EDAS进行微服务治理,更多信息,请参见服务治理概述

更多信息

  • 您还可以通过Spring Boot的方式开发Dubbo应用,更多信息,请参见使用Spring Boot开发Dubbo微服务应用

  • 如果您熟悉Dubbo,仅想体验如何托管到EDAS,可以使用Alibaba Cloud Toolkit创建一个Demo示例,然后部署到EDAS。更多信息,请参见使用Cloud Toolkit开发Dubbo微服务应用样例工程

  • 如果您使用了edas-dubbo-extension,由于edas-dubbo-extension的方式不能使用EDAS提供的相关功能,如Dubbo服务治理,所以不推荐使用,建议您迁移到Nacos。

  • 本页导读 (1)
文档反馈