This document provides a full-process demonstration of integrating a Spring Cloud application with the PolarisMesh governance center hosted by the Microservices Engine through a demo, helping you quickly learn how to use PolarisMesh.
Download the Github demo source code to your local machine and extract it.
The local build environment has the Java JDK and Maven installed and can access the Maven Central Repository.
Based on your own business, resources for business deployment have been prepared. You can choose one of the methods: virtual machine deployment or containerized deployment.
2. Select Polaris (Polaris) in the left sidebar, go to the PolarisMesh service instance engine list page, then click the target instance to go to the instance information page.
3. On the Engine Management - Instance Information page, view the access IP address. Spring Cloud applications access using the gRPC port (8091):
4. Modify the registry center IP address in the demo.
4.1 In the downloaded local demo source code directory, locate the following two files:
spring-cloud-tencent-examples/polaris-discovery-example/discovery-callee-service/src/main/resources/bootstrap.yml and spring-cloud-tencent-examples/polaris-discovery-example/discovery-caller-service/src/main/resources/bootstrap.yml.
4.2 Add the Microservices Engine PolarisMesh grid IP address to the project configuration file (taking spring-cloud-tencent-examples/polaris-discovery-example/discovery-callee-service/src/main/resources/bootstrap.yml as an example).
server:
port: 0
spring:
application:
name: DiscoveryCallerService
cloud:
polaris:
enabled: true
address: grpc://{Polaris engine private network IP address}:8091
5. Package the demo source code into a Jar file.
5.1 Under the root directory of the polaris-discovery-example source code, open a command prompt and execute the command `mvn clean package` to package and compile the project.
5.2 After successful compilation, two Jar packages are generated as shown in the following table.
6. Deploy the provider and consumer microservices applications. Choose one deployment method based on your actual business needs from VM deployment, containerized deployment, and TEM deployment.
6.1 VM deployment
Upload the Jar package to the Cloud Virtual Machine (CVM) instance.
7.1 Go to the PolarisMesh service instance page mentioned earlier.
Choose Service Management > Service List to view the number of instances for the DiscoveryCallerService and DiscoveryCalleeService microservices:
If the number of instances is not zero, it indicates that the microservices engine has been successfully connected.
If the number of instances is zero, or if the service names DiscoveryCallerService and DiscoveryCalleeService are not found, it indicates that the microservice application failed to connect to the microservice engine.
7.2 Invoke the HTTP interface of the consumer. Execute the HTTP call, where ${app.port} is replaced with the listening port of the consumer, and ${add.address} is replaced with the exposed IP address of the consumer:
curl -L -X GET 'http://${add.address}:${app.port}/echo?value="hello-world'
