Skip to main content
Version: v2.2

Eureka Registry

Eureka is an important registry implementation in the Seata component.

Prerequisites​

Before integrating Eureka into your Seata project, make sure that the Eureka Server service is already running in the background. If you are not familiar with the basic usage of Eureka, you can refer to the Eureka Quick Start for reference. It is recommended to use Eureka version 2.X or above.

Quick Start​

The steps to integrate Eureka registry into Seata are very simple, and can be roughly divided into "Adding Maven Dependencies" and "Configuring the Registry".

Adding Maven Dependencies​

First, you need to add the Maven dependency of spring-cloud-starter-netflix-eureka-client to your project's pom.xml file. It is recommended to use Seata 1.4.0+. For the version relationship between spring-cloud-starter-alibaba-seata and the corresponding microservice version, please refer to the Version Description.

<!-- seata dependency -->
<dependency>
    <groupId>io.seata</groupId>
    <artifactId>seata-spring-boot-starter</artifactId>
    <version>latest version</version>
</dependency>
<dependency>
    <groupId>com.alibaba.cloud</groupId>
    <artifactId>spring-cloud-starter-alibaba-seata</artifactId>
    <version>2.1.2.RELEASE and above</version>
    <exclusions>
        <exclusion>
            <groupId>io.seata</groupId>
            <artifactId>seata-spring-boot-starter</artifactId>
        </exclusion>
    </exclusions>
</dependency>

<!-- eureka client dependency -->
<dependency>
    <groupId>org.springframework.cloud</groupId>
    <artifactId>spring-cloud-starter-netflix-eureka-client</artifactId>
    <version>2.0.0.RELEASE and above</version>
</dependency>

Configuring the Registry on the Client Side​

Add the corresponding configuration to application.yml, and refer to the Configuration Reference for other configurations.

seata:
  tx-service-group: default_tx_group
  service:
    vgroup-mapping:
      default_tx_group: seata-server # Configure the corresponding value of registry.eureka.application on the Server side here
  registry:
    type: eureka
    eureka:
      service-url: http://localhost:8761/eureka

Server-side configuration of the registry center​

Add the corresponding configuration center in conf/application.yml, and refer to the configuration for the rest.

seata:
  registry:
    type: eureka
    eureka:
      service-url: http://localhost:8761/eureka
      application: seata-server 
      weight: 1

After that, when Seata-Server is started, the Server-side service will appear in the registry center list in the Eureka console. After configuring the Client, you can start the application to experience the Seata service.