Serverless App Engine:Uso de Alibaba Cloud Toolkit para desplegar automáticamente una aplicación de microservices en SAE

Funcionamiento

La aplicación consta de dos servicios que se comunican a través de un servidor Nacos local que actúa como registro de servicios:

• Proveedor (nacos-service-provider): Expone GET /echo/{string} y se registra en Nacos al iniciarse.

• Consumidor (nacos-service-consumer): Detecta al proveedor mediante Nacos y lo invoca usando RestTemplate o FeignClient.

IntelliJ IDEA
    └── Alibaba Cloud Toolkit plug-in
            │
            ├── Deploy ──► SAE Application: nacos-service-provider (port 18081)
            │                   └── registers as "service-provider" in Nacos
            │
            └── Deploy ──► SAE Application: nacos-service-consumer (port 18082)
                                └── discovers "service-provider" via Nacos
                                └── exposes /echo-rest/{str} and /echo-feign/{str}

Durante el desarrollo, ambos servicios se ejecutan localmente contra un servidor Nacos on-premises. Tras la validación local, Alibaba Cloud Toolkit compila y despliega estos servicios como aplicaciones de SAE directamente desde IntelliJ IDEA.

Requisitos previos

Antes de empezar, asegúrese de contar con lo siguiente:

• Una cuenta de SAE activada. Consulte Activate SAE

• Maven instalado con las variables de entorno configuradas

• JDK 1.8 o posterior instalado

• IntelliJ IDEA 2018.3 o posterior instalado

• Alibaba Cloud Toolkit instalado y configurado en IntelliJ IDEA

El servidor de plugins de JetBrains está alojado fuera de China. Si la descarga es lenta, obtenga el paquete de instalación sin conexión desde el sitio web de JetBrains e instálelo manualmente. Para obtener ayuda, consulte Contact us .

Paso 1: Crear aplicaciones de marcador de posición en SAE

SAE admite el despliegue de aplicaciones desde paquetes JAR e imágenes de contenedor. Este tutorial utiliza paquetes JAR.

Cree una aplicación de proveedor y una aplicación de consumidor en SAE. Para obtener instrucciones paso a paso, consulte Deploy a microservices application by using a JAR package in the SAE console.

Publicará su código local en estas aplicaciones en el Paso 5.

Paso 2: Crear el proveedor

Cree un proyecto de Spring Boot que se registre en Nacos como proveedor de servicios.

1. Cree un proyecto Maven llamado nacos-service-provider.

2. Agregue las siguientes dependencias a pom.xml:

   Spring Cloud Edgware ha sido descontinuado. Utilice Greenwich o versiones posteriores para nuevos proyectos.

   Versión de Spring Cloud	Versión de Spring Cloud Alibaba
   Greenwich	2.1.1.RELEASE
   Finchley	2.0.1.RELEASE
   Edgware	1.5.1.RELEASE

   <parent>
       <groupId>org.springframework.boot</groupId>
       <artifactId>spring-boot-starter-parent</artifactId>
       <version>2.1.4.RELEASE</version>
       <relativePath/>
   </parent>
   
   <dependencies>
       <dependency>
           <groupId>com.alibaba.cloud</groupId>
           <artifactId>spring-cloud-starter-alibaba-nacos-discovery</artifactId>
           <version>2.1.1.RELEASE</version>
       </dependency>
       <dependency>
           <groupId>org.springframework.boot</groupId>
           <artifactId>spring-boot-starter-web</artifactId>
       </dependency>
   </dependencies>
   
   <dependencyManagement>
       <dependencies>
           <dependency>
               <groupId>org.springframework.cloud</groupId>
               <artifactId>spring-cloud-dependencies</artifactId>
               <version>Greenwich.SR1</version>
               <type>pom</type>
               <scope>import</scope>
           </dependency>
       </dependencies>
   </dependencyManagement>
   
   <build>
       <plugins>
           <plugin>
               <groupId>org.springframework.boot</groupId>
               <artifactId>spring-boot-maven-plugin</artifactId>
           </plugin>
       </plugins>
   </build>

   Este ejemplo usa Spring Cloud Greenwich.SR1 con Spring Cloud Alibaba 2.1.1.RELEASE. Si su proyecto apunta a una versión diferente de Spring Cloud, utilice la versión correspondiente de Spring Cloud Alibaba:

3. En src/main/java, cree un paquete llamado com.aliware.edas.

4. En com.aliware.edas, cree la clase de inicio ProviderApplication. La anotación @EnableDiscoveryClient habilita el registro y la detección de servicios:

   package com.aliware.edas;
   
   import org.springframework.boot.SpringApplication;
   import org.springframework.boot.autoconfigure.SpringBootApplication;
   import org.springframework.cloud.client.discovery.EnableDiscoveryClient;
   
   @SpringBootApplication
   @EnableDiscoveryClient
   public class ProviderApplication {
       public static void main(String[] args) {
           SpringApplication.run(ProviderApplication.class, args);
       }
   }

5. En com.aliware.edas, cree EchoController para exponer el endpoint del proveedor:

   package com.aliware.edas;
   
   import org.springframework.web.bind.annotation.PathVariable;
   import org.springframework.web.bind.annotation.RequestMapping;
   import org.springframework.web.bind.annotation.RequestMethod;
   import org.springframework.web.bind.annotation.RestController;
   
   @RestController
   public class EchoController {
       @RequestMapping(value = "/echo/{string}", method = RequestMethod.GET)
       public String echo(@PathVariable String string) {
           return string;
       }
   }

6. En src/main/resources, cree application.properties y establezca la dirección del servidor Nacos:

   Si su registro de servicios es un registro autogestionado, reemplace 127.0.0.1 por la dirección del registro de servicios autogestionado.

   spring.application.name=service-provider
   server.port=18081
   spring.cloud.nacos.discovery.server-addr=127.0.0.1:8848

7. Compruebe el registro del proveedor:

   1. Ejecute el método main de ProviderApplication para iniciar el proveedor.

   2. Abra la consola de Nacos en http://127.0.0.1:8848/nacos. El nombre de usuario y la contraseña predeterminados son ambos nacos.

   3. En el panel de navegación izquierdo, vaya a Service Management > Services. Confirme que service-provider aparece en la lista de servicios.

Paso 3: Crear el consumidor

Cree un proyecto de Spring Boot que detecte al proveedor mediante Nacos y lo invoque usando RestTemplate y FeignClient.

1. Cree un proyecto Maven llamado nacos-service-consumer.

2. Agregue las siguientes dependencias a pom.xml. El consumidor requiere el mismo padre y gestión de dependencias que el proveedor, además de spring-cloud-starter-openfeign:

   <parent>
       <groupId>org.springframework.boot</groupId>
       <artifactId>spring-boot-starter-parent</artifactId>
       <version>2.1.4.RELEASE</version>
       <relativePath/>
   </parent>
   
   <dependencies>
       <dependency>
           <groupId>com.alibaba.cloud</groupId>
           <artifactId>spring-cloud-starter-alibaba-nacos-discovery</artifactId>
           <version>2.1.1.RELEASE</version>
       </dependency>
       <dependency>
           <groupId>org.springframework.boot</groupId>
           <artifactId>spring-boot-starter-web</artifactId>
       </dependency>
       <dependency>
           <groupId>org.springframework.cloud</groupId>
           <artifactId>spring-cloud-starter-openfeign</artifactId>
       </dependency>
   </dependencies>
   
   <dependencyManagement>
       <dependencies>
           <dependency>
               <groupId>org.springframework.cloud</groupId>
               <artifactId>spring-cloud-dependencies</artifactId>
               <version>Greenwich.SR1</version>
               <type>pom</type>
               <scope>import</scope>
           </dependency>
       </dependencies>
   </dependencyManagement>
   
   <build>
       <plugins>
           <plugin>
               <groupId>org.springframework.boot</groupId>
               <artifactId>spring-boot-maven-plugin</artifactId>
           </plugin>
       </plugins>
   </build>

3. En src/main/java, cree un paquete llamado com.aliware.edas.

4. En com.aliware.edas, cree la interfaz FeignClient EchoService:

   package com.aliware.edas;
   
   import org.springframework.cloud.openfeign.FeignClient;
   import org.springframework.web.bind.annotation.PathVariable;
   import org.springframework.web.bind.annotation.RequestMapping;
   import org.springframework.web.bind.annotation.RequestMethod;
   
   // Binds this FeignClient to the "service-provider" service in Nacos
   @FeignClient(name = "service-provider")
   public interface EchoService {
       @RequestMapping(value = "/echo/{str}", method = RequestMethod.GET)
       String echo(@PathVariable("str") String str);
   }

5. En com.aliware.edas, cree la clase de inicio ConsumerApplication:

   • @EnableDiscoveryClient habilita el registro y la detección de servicios.

   • @EnableFeignClients habilita FeignClient.

   • @LoadBalanced integra RestTemplate con la detección de servicios para que pueda resolver service-provider por nombre.

   package com.aliware.edas;
   
   import org.springframework.boot.SpringApplication;
   import org.springframework.boot.autoconfigure.SpringBootApplication;
   import org.springframework.cloud.client.discovery.EnableDiscoveryClient;
   import org.springframework.cloud.client.loadbalancer.LoadBalanced;
   import org.springframework.cloud.openfeign.EnableFeignClients;
   import org.springframework.context.annotation.Bean;
   import org.springframework.web.client.RestTemplate;
   
   @SpringBootApplication
   @EnableDiscoveryClient
   @EnableFeignClients
   public class ConsumerApplication {
   
       @LoadBalanced
       @Bean
       public RestTemplate restTemplate() {
           return new RestTemplate();
       }
   
       public static void main(String[] args) {
           SpringApplication.run(ConsumerApplication.class, args);
       }
   }

6. En com.aliware.edas, cree TestController para exponer dos endpoints: uno que invoca al proveedor mediante RestTemplate y otro mediante FeignClient:

   package com.aliware.edas;
   
   import org.springframework.beans.factory.annotation.Autowired;
   import org.springframework.web.bind.annotation.PathVariable;
   import org.springframework.web.bind.annotation.RequestMapping;
   import org.springframework.web.bind.annotation.RequestMethod;
   import org.springframework.web.bind.annotation.RestController;
   import org.springframework.web.client.RestTemplate;
   
   @RestController
   public class TestController {
   
       @Autowired
       private RestTemplate restTemplate;
       @Autowired
       private EchoService echoService;
   
       // Calls service-provider via RestTemplate
       @RequestMapping(value = "/echo-rest/{str}", method = RequestMethod.GET)
       public String rest(@PathVariable String str) {
           return restTemplate.getForObject("http://service-provider/echo/" + str, String.class);
       }
   
       // Calls service-provider via FeignClient
       @RequestMapping(value = "/echo-feign/{str}", method = RequestMethod.GET)
       public String feign(@PathVariable String str) {
           return echoService.echo(str);
       }
   }

7. En src/main/resources, cree application.properties:

   Si su registro de servicios es un registro autogestionado, reemplace 127.0.0.1:8848 por la dirección del registro de servicios autogestionado.

   spring.application.name=service-consumer
   server.port=18082
   spring.cloud.nacos.discovery.server-addr=127.0.0.1:8848

8. Compruebe el registro del consumidor:

   1. Ejecute el método main de ConsumerApplication para iniciar el consumidor.

   2. Abra la consola de Nacos en http://127.0.0.1:8848/nacos.

   3. En el panel de navegación izquierdo, vaya a Service Management > Services. Confirme que service-consumer aparece en la lista de servicios.

Paso 4: Probar los servicios localmente

Con ambos servicios en ejecución, invoque al consumidor para confirmar que se comunica correctamente con el proveedor.

En Linux, Unix o macOS:

curl http://127.0.0.1:18082/echo-rest/rest-rest
curl http://127.0.0.1:18082/echo-feign/feign-rest

En Windows, abra un navegador y vaya a:

http://127.0.0.1:18082/echo-rest/rest-rest
http://127.0.0.1:18082/echo-feign/feign-rest

Cada solicitud devuelve la cadena que pasó en la ruta de la URL, lo cual confirma que el consumidor detecta e invoca al proveedor a través de Nacos.

Paso 5: Desplegar las aplicaciones en SAE

Configure Alibaba Cloud Toolkit en IntelliJ IDEA para compilar y desplegar ambas aplicaciones en las aplicaciones de SAE que creó en Step 1.

Pasos siguientes

• Deploy a Java application to SAE 1.0 — otros métodos de despliegue compatibles con SAE

• Bind an SLB instance to an application — exponga su aplicación al tráfico externo