Conectar a um Eureka Server gerido para Spring nas Azure Container Apps

O Eureka Server for Spring é um registo de serviços que permite aos microsserviços registarem-se e descobrirem outros serviços. O Eureka Server for Spring está disponível como um componente do Azure Container Apps. Pode associar a sua aplicação de contentores ao Eureka Server for Spring para registo automático no servidor Eureka.

Neste tutorial, irá aprender a:

Pré-requisitos

• Uma conta no Azure com uma subscrição ativa. Se ainda não tiver um, pode criar um gratuitamente.
• CLI do Azure.

Considerações

Ao executar o Eureka Server for Spring em aplicativos de contêiner, esteja ciente dos seguintes detalhes:

Configuração

Antes de começar a trabalhar com o componente Eureka Server for Spring, primeiro você precisa criar os recursos necessários.

Criar o Eureka Server para o componente Spring Java

Vincule a sua aplicação container ao Eureka Server para o componente Spring Java

Retorne ao aplicativo de contêiner no portal. Copie o URL do seu aplicativo para um editor de texto para que você possa usá-lo em uma próxima etapa.

Vá para a /allRegistrationStatus rota para ver todas as aplicações registadas no servidor Eureka para o componente Spring.

A associação injeta várias configurações no aplicativo como variáveis de ambiente, principalmente a eureka.client.service-url.defaultZone propriedade. Esta propriedade indica o ponto final interno do componente Java do Eureka Server.

A ligação também injeta as seguintes propriedades:

"eureka.client.register-with-eureka":    "true"
"eureka.client.fetch-registry":          "true"
"eureka.instance.prefer-ip-address":     "true"

A eureka.client.register-with-eureka propriedade está configurada para true garantir o registo no servidor Eureka. Esse registro substitui a configuração local no application.properties, do servidor de configuração e assim por diante. Se quiser defini-lo como false, você pode substituí-lo definindo uma variável de ambiente em seu aplicativo de contêiner.

A eureka.instance.prefer-ip-address propriedade é definida como true devido à regra de resolução do sistema de nome de domínio específica no ambiente do aplicativo de contêiner. Não modifique esse valor para não quebrar a ligação.

Opcional: Desvincule a sua aplicação container do Eureka Server para um componente Spring Java

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

Visualize o aplicativo através de um painel

1. Crie uma definição de função personalizada.

   az role definition create --role-definition '{
       "Name": "<YOUR_ROLE_NAME>",
       "IsCustom": true,
       "Description": "Can access managed Java Component dashboards in managed environments",
       "Actions": [
           "Microsoft.App/managedEnvironments/write"
       ],
       "AssignableScopes": ["/subscriptions/<SUBSCRIPTION_ID>"]
   }'
   

   Certifique-se de substituir o espaço reservado <SUBSCRIPTION_ID> no valor AssignableScopes pelo seu ID de subscrição.

2. Atribua a função personalizada à sua conta em um recurso de ambiente gerenciado.

   Obtenha a ID do recurso do ambiente gerenciado:

   export ENVIRONMENT_ID=$(az containerapp env show \
       --name $ENVIRONMENT --resource-group $RESOURCE_GROUP \
       --query id \
       --output tsv)
   

3. Atribua a função à sua conta.

   Antes de executar este comando, substitua os espaços reservados - indicados pelos colchetes <> - pelo ID da sua entidade de usuário ou serviço e pelo nome da função.

   az role assignment create \
       --assignee <USER_OR_SERVICE_PRINCIPAL_ID> \
       --role "<ROLE_NAME>" \
       --scope $ENVIRONMENT_ID
   

   Nota

   O valor <USER_OR_SERVICE_PRINCIPAL_ID> normalmente deve ser a identidade que usa para aceder ao portal Azure. O <ROLE_NAME> valor é o nome que você atribuiu na etapa 1.

4. Obtenha o URL do painel do Eureka Server for Spring.

   az containerapp env java-component eureka-server-for-spring show \
       --environment $ENVIRONMENT \
       --resource-group $RESOURCE_GROUP \
       --name $EUREKA_COMPONENT_NAME \
       --query properties.ingress.fqdn \
       --output tsv
   

   Este comando devolve o URL que pode utilizar para aceder ao painel do Eureka Server for Spring. Com o painel, você também pode ver seu aplicativo de contêiner, conforme mostrado na captura de tela a seguir.

   

Opcional: Integrar o Eureka Server para o Spring e o Admin para os componentes do Spring Java

Se quiser integrar o Eureka Server para Spring e os componentes Admin para Java Spring, consulte Integre o Admin gerido para Spring com o Eureka Server para Spring.

Limpar recursos

Os recursos criados neste tutorial têm um impacto na sua fatura do Azure. Se você não vai usar esses serviços a longo prazo, execute o seguinte comando para remover tudo o que você criou neste tutorial.

az group delete --resource-group $RESOURCE_GROUP

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

As seções a seguir descrevem as configurações suportadas. Para obter mais informações, consulte Spring Cloud Eureka Server.

Opções de configuração

O az containerapp update comando usa o --configuration parâmetro para controlar como o Eureka Server for Spring está configurado. Você pode usar vários parâmetros ao mesmo tempo, desde que estejam separados por um espaço. Para obter mais informações, consulte Spring Cloud Eureka Server.

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

Configurações comuns

• Configurações relacionadas ao registo:
  • logging.level.*
  • logging.group.*
  • Quaisquer outras configurações sob o logging.* namespace devem ser proibidas - por exemplo, escrever arquivos de log usando logging.file deve ser proibido.

Chamada entre aplicativos

Este exemplo mostra-lhe como escrever código Java para chamar entre aplicações registadas no componente Eureka Server for Spring. Quando as aplicações de contentor estão ligadas ao Eureka, comunicam entre si através do servidor Eureka.

O exemplo cria dois aplicativos, um chamador e um destinatário. Ambos os aplicativos se comunicam entre si usando o componente Eureka Server for Spring. O aplicativo callee expõe um ponto de extremidade que é chamado pelo aplicativo chamador.

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

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

2. Crie um endpoint na aplicação do destinatário que é chamado pela aplicação chamadora.

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

3. Defina o nome do aplicativo destinatário no arquivo de configuração do aplicativo - por exemplo, no application.yml.

   spring.application.name=callee
   

4. Crie o aplicativo chamador.

   Adicione a anotação para ativar a @EnableDiscoveryClient funcionalidade do cliente Eureka. Além disso, crie um WebClient.Builder bean com a @LoadBalanced anotação para executar 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 na aplicação emissor que usa o WebClient.Builder para chamar a aplicação destinatária pelo seu nome, callee.

   @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 tem uma aplicação de chamada e uma de receção de chamada que comunicam entre si usando Eureka Server para componentes Spring Java. Certifique-se de que ambas as aplicações estão em execução e vinculadas ao servidor Eureka antes de testar o endpoint /call-callee na aplicação chamadora.

Limitações

• O componente Eureka Server Java vem com uma configuração predefinida, eureka.server.enable-self-preservation, definida para 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 é ativada. Se as instâncias forem excluídas muito cedo, algumas solicitações poderão ser direcionadas para instâncias inexistentes. Se quiseres alterar esta definição para true, podes sobrescrevê-la definindo as tuas próprias configurações no componente Java.
• O dashboard da Eureka não está disponível no Azure e é operado pela 21Vianet.

Próximos passos

Conteúdos relacionados

Integre o Admin gerenciado para o Spring com o Eureka Server for Spring