Help Center > > Developer Guide> Microservice Development Guide> Connecting Microservice Applications to CSE> Connecting Spring Cloud Applications to CSE

Connecting Spring Cloud Applications to CSE

Updated at: Apr 06, 2021 GMT+08:00

This section describes how to connect Spring Cloud applications to CSE and use the most common functions of CSE. For details about the development guide, see Using CSE Functions.

In the Spring Cloud Huawei Samples project, you can find the code corresponding to the development methods in this section.

Prerequisites

  • Version requirements: Spring Cloud Huawei 1.5.1-Hoxton or later.
  • This document assumes that you use Maven for dependency management and packaging in your project. You are familiar with the Maven dependency management mechanism and are able to modify the dependency management and dependency in the pom.xml file.

Procedure

  1. Add dependencies to the pom.xml file of the project.

    • If you develop microservices using Spring Cloud, introduce the following dependencies:
      <dependency>
        <groupId>com.huaweicloud</groupId>
        <artifactId>spring-cloud-starter-huawei-service-engine</artifactId>
      </dependency>
      
    • If you develop the gateway using Spring Cloud, introduce the following dependencies:
      <dependency>
        <groupId>com.huaweicloud</groupId>
        <artifactId>spring-cloud-starter-huawei-service-engine-gateway</artifactId>
      </dependency>

      You are advised to use Maven Dependency Management to manage the third-party software dependencies of a project. Introduce the following dependencies to the project:

       <dependencyManagement>
          <dependencies>
            <!-- configure user spring cloud / spring boot versions -->
            <dependency>
              <groupId>org.springframework.boot</groupId>
              <artifactId>spring-boot-dependencies</artifactId>
              <version>${spring-boot.version}</version>
              <type>pom</type>
              <scope>import</scope>
            </dependency>
            <dependency>
              <groupId>org.springframework.cloud</groupId>
              <artifactId>spring-cloud-dependencies</artifactId>
              <version>${spring-cloud.version}</version>
              <type>pom</type>
              <scope>import</scope>
            </dependency>
            <!-- configure spring cloud huawei version -->
            <dependency>
              <groupId>com.huaweicloud</groupId>
              <artifactId>spring-cloud-huawei-bom</artifactId>
              <version>${spring-cloud-huawei.version}</version>
              <type>pom</type>
              <scope>import</scope>
            </dependency>
          </dependencies>
        </dependencyManagement>

    Skip the operation if your project already contains the preceding dependencies.

    If other registry and discovery libraries, such as Eureka, are used in your project, you need to adjust the project as follows:

    • Delete the dependencies related to Eureka from the project. For example:
      <dependency>
        <groupId>org.springframework.cloud</groupId>
        <artifactId>spring-cloud-starter-netflix-eureka-server</artifactId>
      </dependency>
    • If @EnableEurekaServer is used in the code, delete it and replace it with @EnableDiscoveryClient.

  2. Configure microservice information.

    Add the microservice description to the bootstrap.yml file. If the bootstrap.yml file is not available in the project, create one.

    spring:
      application:
        name: basic-provider
      cloud:
        servicecomb:
          discovery:
            enabled: true
            address: http://127.0.0.1:30100
            appName: basic-application
            serviceName: ${spring.application.name}
            version: 0.0.1
            healthCheckInterval: 30
          config:
            serverAddr:  http://127.0.0.1:30113
            watch:
              delay: 10000

  3. (Optional) Configure the AK/SK.

    Perform this step only when you use the professional microservice engine.

    The AK/SK is configured in the bootstrap.yml file. The plaintext configuration is provided by default, allowing you to customize the encryption storage scheme.

    • Add the following configuration in plaintext to the bootstrap.yml file:
      spring: 
        cloud: 
          servicecomb: 
            credentials:
              enabled: true
              accessKey: AK
              secretKey: SK
              akskCustomCipher: default
              project: project name
    • Custom implementation
      1. Implement the com.huaweicloud.common.util.Cipher API using either of the following methods:
        • String name(), which is the name definition of servicecomb.credentials.akskCustomCipher and needs to be added to the configuration file.
        • char[] decode(char[] encrypted), which is the decryption API used to decrypt secretKey.
        public class CustomCipher implements Cipher

        To implement encryption and decryption, you need to use BootstrapConfiguration as the startup add-in. Add the following statement first:

        @Configuration
        public class MyAkSKCipherConfiguration {
          @Bean
          public Cipher customCipher() {
            return new CustomCipher();
          }
        }

        Add the META-INF/spring.factories file to define the configuration:

        org.springframework.cloud.bootstrap.BootstrapConfiguration=\
        com.huaweicloud.common.transport.MyAkSKCipherConfiguration
      2. After the custom configuration is complete, you can use the new decryption algorithm in the bootstrap.yaml file.
        spring:
          cloud:
            servicecomb:
              credentials:
                enabled: true
                accessKey: AK
                secretKey: SK
                akskCustomCipher: user-defined algorithm name
                project: project name

  4. (Optional) Configure RBAC.

    Perform this step only when you use the exclusive microservice engine and enable RBAC. In other scenarios, skip this step.

    After RBAC authentication is enabled for a microservice engine, all called APIs can be called only after a token is obtained. For details about the authentication process, see RBAC.

    To use RBAC, obtain the username and password from the microservice engine and then add the following configuration to the configuration file:

    spring:
      cloud:
        servicecomb:
          credentials:
            account:
              name: username
              password: password

    If you use the professional microservice engine, the watch function is not available. You need to disable the watch function in the configuration file. Otherwise, error logs will be periodically printed. Set watch to false for the service center.

    spring:
      cloud:
        servicecomb:
          discovery:
            watch: false

Did you find this page helpful?

Submit successfully!

Thank you for your feedback. Your feedback helps make our documentation better.

Failed to submit the feedback. Please try again later.

Which of the following issues have you encountered?







Please complete at least one feedback item.

Content most length 200 character

Content is empty.

OK Cancel