Preparación de una aplicación Java Spring para su implementación en Azure Spring Cloud

Azure Spring Cloud proporciona servicios sólidos para hospedar, supervisar, escalar y actualizar una aplicación de Steeltoe. En este artículo se muestra cómo preparar una aplicación Steeltoe existente para su implementación en Azure Spring Cloud.

En este artículo se explican las dependencias, la configuración y el código necesarios para ejecutar una aplicación Steeltoe de .NET Core en Azure Spring Cloud. Para obtener información sobre cómo implementar una aplicación en Azure Spring Cloud, consulte Implementación de la primera aplicación de Spring Boot en Azure Spring Cloud.

Versiones compatibles

Azure Spring Cloud es compatible con:

• .NET Core 3.1
• Steeltoe 2.4 y 3.0

Dependencias

Para Steeltoe 2.4, agregue el paquete Microsoft.Azure.SpringCloud.Client 1.x.x más reciente al archivo del proyecto:

<ItemGroup>
  <PackageReference Include="Microsoft.Azure.SpringCloud.Client" Version="1.0.0-preview.1" />
  <PackageReference Include="Steeltoe.Discovery.ClientCore" Version="2.4.4" />
  <PackageReference Include="Steeltoe.Extensions.Configuration.ConfigServerCore" Version="2.4.4" />
  <PackageReference Include="Steeltoe.Management.TracingCore" Version="2.4.4" />
  <PackageReference Include="Steeltoe.Management.ExporterCore" Version="2.4.4" />
</ItemGroup>

Para Steeltoe 3.0, agregue el paquete Microsoft.Azure.SpringCloud.Client 2.x.x más reciente al archivo del proyecto:

<ItemGroup>
  <PackageReference Include="Microsoft.Azure.SpringCloud.Client" Version="2.0.0-preview.1" />
  <PackageReference Include="Steeltoe.Discovery.ClientCore" Version="3.0.0" />
  <PackageReference Include="Steeltoe.Extensions.Configuration.ConfigServerCore" Version="3.0.0" />
  <PackageReference Include="Steeltoe.Management.TracingCore" Version="3.0.0" />
</ItemGroup>

Actualizar Program.cs

En el método Program.Main, llame al método UseAzureSpringCloudService.

Para Steeltoe 2.4.4, llame a UseAzureSpringCloudService después de ConfigureWebHostDefaults y de AddConfigServer, si se ha llamado:

public static IHostBuilder CreateHostBuilder(string[] args) =>
    Host.CreateDefaultBuilder(args)
        .ConfigureWebHostDefaults(webBuilder =>
        {
            webBuilder.UseStartup<Startup>();
        })
        .AddConfigServer()
        .UseAzureSpringCloudService();

Para Steeltoe 3.0.0, llame a UseAzureSpringCloudService antes de ConfigureWebHostDefaults y antes de cualquier código de configuración de Steeltoe:

public static IHostBuilder CreateHostBuilder(string[] args) =>
    Host.CreateDefaultBuilder(args)
        .UseAzureSpringCloudService()
        .ConfigureWebHostDefaults(webBuilder =>
        {
            webBuilder.UseStartup<Startup>();
        })
        .AddConfigServer();

Habilitación de la detección de servicios del servidor de Eureka

En el origen de configuración que se usará cuando la aplicación se ejecute en Azure Spring Cloud, establezca spring.application.name en el mismo nombre que la aplicación Azure Spring Cloud en la que se implementará el proyecto.

Por ejemplo, si implementa un proyecto .NET denominado EurekaDataProvider en una aplicación de Azure Spring Cloud denominada planet-weather-provider el archivo appSettings.json debe incluir el siguiente JSON:

"spring": {
  "application": {
    "name": "planet-weather-provider"
  }
}

Uso de la detección de servicios

Para llamar a un servicio mediante la detección de servicios del servidor de Eureka, realice solicitudes HTTP a http://<app_name>, donde app_name sea el valor de spring.application.name de la aplicación de destino. Por ejemplo, el código siguiente llama al servicio planet-weather-provider:

using (var client = new HttpClient(discoveryHandler, false))
{
    var responses = await Task.WhenAll(
        client.GetAsync("http://planet-weather-provider/weatherforecast/mercury"),
        client.GetAsync("http://planet-weather-provider/weatherforecast/saturn"));
    var weathers = await Task.WhenAll(from res in responses select res.Content.ReadAsStringAsync());
    return new[]
    {
        new KeyValuePair<string, string>("Mercury", weathers[0]),
        new KeyValuePair<string, string>("Saturn", weathers[1]),
    };
}

En este tema se muestra cómo preparar una aplicación Java Spring existente para su implementación en Azure Spring Cloud. Si se ha configurado correctamente, Azure Spring Cloud proporciona servicios sólidos para supervisar, escalar y actualizar cualquier aplicación Java Spring Cloud.

Antes de ejecutar este ejemplo, puede probar la guía de inicio rápido básica.

En otros ejemplos se explica cómo implementar una aplicación en Azure Spring Cloud cuando se configura el archivo POM.

• Inicio de la primera aplicación
• Compilación y ejecución de microservicios

En este artículo se explican las dependencias necesarias y cómo agregarlas al archivo POM.

Versión del entorno de ejecución de Java

Azure Spring Cloud es compatible con Java 8 y Java 11. En general, PaaS de Azure solo admite versiones LTS de Java y Azure Spring Cloud admitirá Java 17 LTS. El entorno de hospedaje contiene la versión más reciente de Azul Zulu OpenJDK para Azure. Para más información sobre Azul Zulu OpenJDK para Azure, consulte Instalación del JDK para Azure y Azure Stack.

Versiones de Spring Boot y Spring Cloud

Para preparar una aplicación de Spring Boot existente para la implementación en Azure Spring Cloud, incluya las dependencias de Spring Boot y Spring Cloud en el archivo POM de la aplicación, como se muestra en las siguientes secciones.

Azure Spring Cloud será compatible con la versión Spring Boot o Spring Cloud más reciente en un plazo de un mes después de su publicación. Puede obtener versiones compatibles en las páginas de versiones de Spring Boot y versiones de Spring Cloud, respectivamente.

En la tabla siguiente se enumeran las combinaciones admitidas de Spring Boot y Spring Cloud:

Versión de Spring Boot	Versión de Spring Cloud
2.3.x	Hoxton.SR8+
2.4.x, 2.5.x	2020.0 también llamado Ilford +

Dependencias de Spring Boot, versión 2.3

En Spring Boot 2.3, agregue las siguientes dependencias al archivo POM de la aplicación.

    <!-- Spring Boot dependencies -->
    <parent>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-parent</artifactId>
        <version>2.3.4.RELEASE</version>
    </parent>

    <!-- Spring Cloud dependencies -->
    <dependencyManagement>
        <dependencies>
            <dependency>
                <groupId>org.springframework.cloud</groupId>
                <artifactId>spring-cloud-dependencies</artifactId>
                <version>Hoxton.SR8</version>
                <type>pom</type>
                <scope>import</scope>
            </dependency>
        </dependencies>
    </dependencyManagement>

Dependencias de Spring Boot, versión 2.4/2.5

Para la versión 2.4/2.5 de Spring Boot, agregue las dependencias siguientes al archivo POM de la aplicación.

    <!-- Spring Boot dependencies -->
    <parent>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-parent</artifactId>
        <version>2.4.8</version>
    </parent>

    <!-- Spring Cloud dependencies -->
    <dependencyManagement>
        <dependencies>
            <dependency>
                <groupId>org.springframework.cloud</groupId>
                <artifactId>spring-cloud-dependencies</artifactId>
                <version>2020.0.2</version>
                <type>pom</type>
                <scope>import</scope>
            </dependency>
        </dependencies>
    </dependencyManagement>

Otras dependencias recomendadas para habilitar las características de Azure Spring Cloud

Para habilitar las características integradas de Azure Spring Cloud desde el registro de servicio a la traza distribuida, debe incluir también las dependencias siguientes en la aplicación. Puede quitar algunas de estas dependencias si no necesita las características correspondientes para las aplicaciones específicas.

Registro del servicio

Para usar el servicio Azure Service Registry administrado, incluya la dependencia spring-cloud-starter-netflix-eureka-client en el archivo pom.xml, como se muestra aquí:

    <dependency>
        <groupId>org.springframework.cloud</groupId>
        <artifactId>spring-cloud-starter-netflix-eureka-client</artifactId>
    </dependency>

El punto de conexión del servidor de Service Registry se inserta automáticamente como variables de entorno con la aplicación. Así, las aplicaciones se pueden registrar por sí solas en el servidor de Service Registry y detectar otros microservicios dependientes.

Anotación de EnableDiscoveryClient

Agregue la anotación siguiente al código fuente de la aplicación.

@EnableDiscoveryClient

Por ejemplo, vea la aplicación piggymetrics de ejemplos anteriores:

package com.piggymetrics.gateway;

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.cloud.client.discovery.EnableDiscoveryClient;
import org.springframework.cloud.netflix.zuul.EnableZuulProxy;

@SpringBootApplication
@EnableDiscoveryClient
@EnableZuulProxy

public class GatewayApplication {
    public static void main(String[] args) {
        SpringApplication.run(GatewayApplication.class, args);
    }
}

Configuración distribuida

Para habilitar la configuración distribuida, incluya la siguiente dependencia spring-cloud-config-client en la sección de dependencias del archivo pom.xml:

<dependency>
    <groupId>org.springframework.cloud</groupId>
    <artifactId>spring-cloud-config-client</artifactId>
</dependency>
<dependency>
    <groupId>org.springframework.cloud</groupId>
    <artifactId>spring-cloud-starter-bootstrap</artifactId>
</dependency>

Métricas

Incluya la dependencia spring-boot-starter-actuator en la sección de dependencias del archivo pom.xml, como se muestra aquí:

<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-actuator</artifactId>
</dependency>

Se extraen métricas periódicamente de los puntos de conexión JMX. Estas métricas se pueden visualizar mediante Azure Portal.

Consulte también

• Análisis de los registros y las métricas de la aplicación
• Configuración de un servidor de configuración
• Inicio rápido de Spring
• Documentación de Spring Boot

Pasos siguientes

En este tema ha aprendido a configurar una aplicación Java Spring para su implementación en Azure Spring Cloud. Para aprender a configurar una instancia de Config Server, consulte el artículo Configuración de una instancia de Config Server.

Hay más ejemplos disponibles en GitHub: Ejemplos de Azure Spring Cloud.