Definir configurações para o componente Eureka Server for Spring em Aplicativos de Contêiner do Azure (versão prévia)

O Eureka Server for Spring é um mecanismo para descoberta centralizada de serviços para microsserviços. Use as orientações a seguir para aprender como configurar e gerenciar seu componente Eureka Server for Spring.

Mostrar

Você pode visualizar os detalhes de um componente individual por nome usando o comando show.

Antes de executar o comando a seguir, substitua os espaços reservados entre <> pelos seus valores.

az containerapp env java-component eureka-server-for-spring show \
  --environment <ENVIRONMENT_NAME> \
  --resource-group <RESOURCE_GROUP> \
  --name <JAVA_COMPONENT_NAME>

Lista

Você pode listar todos os componentes Java registrados usando o comando list.

Antes de executar o comando a seguir, substitua os espaços reservados entre <> pelos seus valores.

az containerapp env java-component list \
  --environment <ENVIRONMENT_NAME> \
  --resource-group <RESOURCE_GROUP>

Desassociar

Para remover uma associação de um aplicativo de contêiner, use a opção --unbind .

Antes de executar o comando a seguir, substitua os espaços reservados entre <> pelos seus valores.

az containerapp update \
  --name <APP_NAME> \
  --unbind <JAVA_COMPONENT_NAME> \
  --resource-group <RESOURCE_GROUP>

Lista de configuração permitida para o Eureka Server for Spring

A lista a seguir detalha as configurações suportadas. Você pode encontrar mais detalhes em Spring Cloud Eureka Server.

Opções de configuração

O comando az containerapp update usa o parâmetro --configuration para controlar como o Eureka Server for Spring é configurado. Você pode usar vários parâmetros ao mesmo tempo, desde que estejam separados por um espaço. Você pode encontrar mais detalhes nos documentos do Spring Cloud Eureka Server.

As definições de configuração a seguir estão disponíveis na propriedade de configuração eureka.server.

Configurações comuns

• registrando configurações relacionadas
  • logging.level.*
  • logging.group.*
  • Quaisquer outras configurações no namespace logging.* devem ser proibidas, por exemplo, gravar arquivos de log usando logging.file deve ser proibido.

Chamada entre aplicativos

Este exemplo mostra como escrever código Java para fazer chamadas entre aplicativos registrados com o componente Eureka Server for Spring. Quando os aplicativos contêineres estão vinculados ao Eureka, eles se comunicam entre si por meio do servidor Eureka.

O exemplo cria dois aplicativos, um chamador e um receptor. Ambos os aplicativos se comunicam entre si usando o componente Eureka Server for Spring. O aplicativo chamado expõe um terminal que é chamado pelo aplicativo chamador.

1. Crie o aplicativo chamado. Habilite o cliente Eureka em seu aplicativo Spring Boot adicionando a anotação @EnableDiscoveryClient à sua classe principal.

   @SpringBootApplication
   @EnableDiscoveryClient
   public class CalleeApplication {
   	public static void main(String[] args) {
   		SpringApplication.run(CalleeApplication.class, args);
   	}
   }
   

2. Crie um terminal no aplicativo chamado que é chamado pelo aplicativo chamador.

   @RestController
   public class CalleeController {
   
       @GetMapping("/call")
       public String calledByCaller() {
           return "Hello from Application callee!";
       }
   }
   

3. Defina o nome do aplicativo chamado no arquivo de configuração do aplicativo. Por exemplo, application.yml.

   spring.application.name=callee
   

4. Crie o aplicativo chamador.

   Adicione a anotação @EnableDiscoveryClient para habilitar a funcionalidade do cliente Eureka. Além disso, crie um bean WebClient.Builder com a anotação @LoadBalanced para realizar chamadas com balanceamento de carga para outros serviços.

   @SpringBootApplication
   @EnableDiscoveryClient
   public class CallerApplication {
   	public static void main(String[] args) {
   		SpringApplication.run(CallerApplication.class, args);
   	}
   
   	@Bean
   	@LoadBalanced
   	public WebClient.Builder loadBalancedWebClientBuilder() {
   		return WebClient.builder();
   	}
   }
   

5. Crie um controlador no aplicativo chamador que use o WebClient.Builder para chamar o aplicativo chamado usando seu nome de aplicativo, chamado.

   @RestController
   public class CallerController { 
       @Autowired
       private WebClient.Builder webClientBuilder;
   
       @GetMapping("/call-callee")
       public Mono<String> callCallee() {
           return webClientBuilder.build()
               .get()
               .uri("http://callee/call")
               .retrieve()
               .bodyToMono(String.class);
       }
   }
   

Agora você tem um aplicativo chamador e um receptor que se comunicam entre si usando componentes Java do Eureka Server for Spring. Certifique-se de que ambos os aplicativos estejam em execução e vinculados ao servidor Eureka antes de testar o ponto de extremidade /call-callee no aplicativo chamador.

Limitações

• O componente Java do Eureka Server vem com uma configuração padrão, eureka.server.enable-self-preservation, definida como false. Essa configuração padrão ajuda a evitar momentos em que as instâncias não são excluídas depois que a autopreservação é habilitada. Se as instâncias forem excluídas muito cedo, algumas solicitações poderão ser direcionadas para instâncias inexistentes. Se desejar alterar essa configuração para true, você poderá substituí-la definindo suas próprias configurações no componente Java.

• O servidor Eureka possui apenas uma única réplica e não suporta escalonamento, tornando o recurso do servidor Eureka par indisponível.

• O painel Eureka não está disponível.

Próximas etapas