Usar o Tanzu Service Registry
Nota
Azure Spring Apps é o novo nome para o serviço Azure Spring Cloud. Embora o serviço tenha um novo nome, você verá o nome antigo em alguns lugares por um tempo enquanto trabalhamos para atualizar ativos, como capturas de tela, vídeos e diagramas.
Este artigo aplica-se a:❌ Basic/Standard ✔️ Enterprise
Este artigo mostra como usar o VMware Tanzu Service Registry com o plano Azure Spring Apps Enterprise.
O Tanzu Service Registry é um dos componentes comerciais do VMware Tanzu. Este componente ajuda você a aplicar o padrão de design de descoberta de serviço aos seus aplicativos.
A descoberta de serviços é uma das principais ideias da arquitetura de microsserviços. Sem a descoberta de serviços, você teria que configurar manualmente cada cliente de um serviço ou adotar alguma forma de convenção de acesso. Este processo pode ser difícil, e as configurações e convenções podem ser frágeis na produção. Em vez disso, você pode usar o Tanzu Service Registry para descobrir e invocar dinamicamente serviços registrados em seu aplicativo.
com o plano Azure Spring Apps Enterprise, você não precisa criar ou iniciar o Registro de Serviço por conta própria. Você pode usar o Registro de Serviço Tanzu selecionando-o ao criar sua instância do plano do Azure Spring Apps Enterprise.
Pré-requisitos
- Uma instância de plano do Azure Spring Apps Enterprise já provisionada com o Tanzu Service Registry habilitado. Para obter mais informações, consulte Guia de início rápido: criar e implantar aplicativos no Azure Spring Apps usando o plano Enterprise.
- A extensão do plano do Azure Spring Apps Enterprise. Use o comando a seguir para remover versões anteriores e instalar a extensão de plano Enterprise mais recente. Se você instalou
spring-clouda extensão anteriormente, desinstale-a para evitar incompatibilidades de configuração e versão.az extension add --upgrade --name spring az extension remove --name spring-cloud
Criar aplicativos que usam o Registro de Serviço
Neste artigo, você cria dois serviços e os registra no Registro de Serviço do Azure Spring Apps. Após o registro, um serviço poderá usar o Registro de Serviço para descobrir e invocar o outro serviço. O diagrama a seguir resume as etapas necessárias:
Essas etapas são descritas com mais detalhes nas seções a seguir.
- Criar Serviço A.
- Implante o Serviço A no Azure Spring Apps e registre-o no Registro de Serviço.
- Crie o Serviço B e implemente-o para chamar o Serviço A.
- Implante o Serviço B e registre-o no Registro de Serviço.
- Invoque o Serviço A através do Serviço B.
Criar variáveis de ambiente
Este artigo usa as seguintes variáveis de ambiente. Defina essas variáveis para os valores usados quando você criou sua instância do plano do Azure Spring Apps Enterprise.
| Variável | Description |
|---|---|
| $RESOURCE_GRUPO | Nome do grupo de recursos. |
| $AZURE_NOME_DA_APPS_PRIMAVERA | Nome da instância do Azure Spring Apps. |
Criar o serviço A com o Spring Boot
Navegue até Spring Initializr para criar o Serviço A de exemplo. Este link usa a seguinte URL para inicializar as configurações.
https://start.spring.io/#!type=maven-project&language=java&packaging=jar&groupId=com.example&artifactId=Sample%20Service%20A&name=Sample%20Service%20A&description=Demo%20project%20for%20Spring%20Boot&packageName=com.example.Sample%20Service%20A&dependencies=web,cloud-eureka
A captura de tela a seguir mostra o Spring Initializr com as configurações necessárias.
Em seguida, selecione GERAR para obter um projeto de exemplo para o Spring Boot com a seguinte estrutura de diretórios.
├── HELP.md
├── mvnw
├── mvnw.cmd
├── pom.xml
└── src
├── main
│ ├── java
│ │ └── com
│ │ └── example
│ │ └── Sample
│ │ └── Service
│ │ └── A
│ │ └── SampleServiceAApplication.java
│ └── resources
│ ├── application.properties
│ ├── static
│ └── templates
└── test
└── java
└── com
└── example
└── Sample
└── Service
└── A
└── SampleServiceAApplicationTests.java
Confirme a configuração de bibliotecas dependentes para o cliente do Service Registry (cliente Eureka)
Em seguida, confirme se o arquivo pom.xml para o projeto contém a seguinte dependência. Adicione a dependência se ela estiver faltando.
<dependency>
<groupId>org.springframework.cloud</groupId>
<artifactId>spring-cloud-starter-netflix-eureka-client</artifactId>
</dependency>
Implementar o cliente do Service Registry
Adicione uma @EnableEurekaClient anotação ao arquivo SampleServiceAApplication.java para configurá-lo como um cliente Eureka.
package com.example.Sample.Service.A;
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.cloud.netflix.eureka.EnableEurekaClient;
@SpringBootApplication
@EnableEurekaClient
public class SampleServiceAApplication {
public static void main(String[] args) {
SpringApplication.run(SampleServiceAApplication.class, args);
}
}
Criar um ponto de extremidade REST para teste
Agora você pode registrar o serviço no Registro de Serviço, mas não pode verificá-lo até implementar um ponto de extremidade de serviço. Para criar pontos de extremidade RESTful que serviços externos podem chamar, adicione um arquivo ServiceAEndpoint.java ao seu projeto com o código a seguir.
package com.example.Sample.Service.A;
import java.util.Map;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RestController;
@RestController
public class ServiceAEndpoint {
@GetMapping("/serviceA")
public String getServiceA(){
return "This is a result of Service A";
}
@GetMapping("/env")
public Map<String, String> getEnv(){
Map<String, String> env = System.getenv();
return env;
}
}
Criar uma aplicação do Spring Boot
Agora que você tem um serviço simples, compile e construa o código-fonte executando o seguinte comando:
mvn clean package
Implantar o Serviço A e registrar-se no Registro de Serviço
Esta seção explica como implantar o Serviço A em uma instância do plano do Azure Spring Apps Enterprise e registrá-lo no Registro de Serviço.
Criar um aplicativo do Azure Spring Apps
Primeiro, crie um aplicativo no Azure Spring Apps usando o seguinte comando:
az spring app create \
--resource-group $RESOURCE_GROUP \
--service $AZURE_SPRING_APPS_NAME \
--name serviceA \
--instance-count 1 \
--memory 2Gi \
--assign-endpoint
O --assign-endpoint argumento concede um IP público para validação e permite o acesso a partir da rede externa.
Conectar-se ao Registro de Serviço a partir do aplicativo
Depois de criar uma instância de serviço com o Spring Boot e criar um aplicativo no Azure Spring Apps, você implanta o aplicativo e confirma a operação. Antes disso, no entanto, você deve vincular seu aplicativo ao Registro de Serviço para que ele possa obter informações de conexão do Registro.
Normalmente, um cliente Eureka precisa escrever as seguintes configurações de informações de conexão no arquivo de configuração application.properties de um aplicativo Spring Boot para que você possa se conectar ao servidor:
eureka.client.service-url.defaultZone=http://eureka:8761/eureka/
No entanto, se você escrever essas configurações diretamente em seu aplicativo, precisará reeditar e reconstruir o projeto novamente sempre que o servidor do Registro de Serviço for alterado. Para evitar esse esforço, o Azure Spring Apps permite que seus aplicativos obtenham informações de conexão do registro de serviço vinculando-se a ele. Especificamente, depois de vincular o aplicativo ao Registro de Serviço, você pode obter as informações de conexão do Registro de serviço (eureka.client.service-url.defaultZone) da variável de ambiente Java. Dessa forma, você pode se conectar ao Registro de Serviço carregando o conteúdo das variáveis de ambiente quando o aplicativo é iniciado.
Na prática, as seguintes variáveis de ambiente são adicionadas à JAVA_TOOL_OPTIONS variável:
-Deureka.client.service-url.defaultZone=https://$AZURE_SPRING_APPS_NAME.svc.azuremicroservices.io/eureka/default/eureka
Vincular um serviço ao Registro de Serviço
Use o comando a seguir para vincular o serviço ao Registro de Serviço do Azure, permitindo que ele se conecte ao servidor.
az spring service-registry bind \
--resource-group $RESOURCE_GROUP \
--service $AZURE_SPRING_APPS_NAME \
--app serviceA
Você também pode configurar as associações de aplicativo no portal do Azure, conforme mostrado na captura de tela a seguir:
Nota
Essas alterações levarão alguns minutos para se propagar para todos os aplicativos quando o status do registro do serviço for alterado.
Se você alterar o status de vinculação/desvinculação, será necessário reiniciar ou reimplantar o aplicativo.
Agora você pode optar por vincular seu aplicativo ao Registro de Serviço diretamente ao criar um novo aplicativo usando os seguintes comandos:
az spring app create \
--resource-group <resource-group> \
--service <service-name> \
--name <app-name> \
--bind-service-registry
Você também pode vincular seu aplicativo ao Registro de Serviço no portal do Azure, conforme mostrado na captura de tela a seguir:
Implantar um aplicativo no Azure Spring Apps
Agora que você vinculou seu aplicativo, implante o arquivo de artefato Spring Boot Sample-Service-A-A-0.0.1-SNAPSHOT.jar no Azure Spring Apps. Para implantar, use o seguinte comando:
az spring app deploy \
--resource-group $RESOURCE_GROUP \
--service $AZURE_SPRING_APPS_NAME \
--name serviceA \
--artifact-path ./target/Sample-Service-A-0.0.1-SNAPSHOT.jar \
--jvm-options="-Xms1024m -Xmx1024m"
Use o comando a seguir para ver se sua implantação foi bem-sucedida.
az spring app list \
--resource-group $RESOURCE_GROUP \
--service $AZURE_SPRING_APPS_NAME \
--output table
Este comando produz uma saída semelhante ao exemplo a seguir.
Name Location ResourceGroup Public Url Production Deployment Provisioning State CPU Memory Running Instance Registered Instance Persistent Storage Bind Service Registry Bind Application Configuration Service
------------------------ ------------- ---------------------- ------------------------------------------------------------------- ----------------------- -------------------- ----- -------- ------------------ --------------------- -------------------- ----------------------- ----------------------------------------
servicea southeastasia $RESOURCE_GROUP https://$AZURE_SPRING_APPS_NAME-servicea.azuremicroservices.io default Succeeded 1 2Gi 1/1 N/A - default -
Confirme se o aplicativo Service A está em execução
A saída do comando anterior inclui a URL pública do serviço. Para acessar o ponto de extremidade RESTful, acrescente /serviceA à URL, conforme mostrado no comando a seguir:
curl https://$AZURE_SPRING_APPS_NAME-servicea.azuremicroservices.io/serviceA
Este comando produz a seguinte saída.
This is a result of Service A
O serviço A inclui um ponto de extremidade RESTful que exibe uma lista de variáveis de ambiente. Acesse o ponto de extremidade com /env para ver as variáveis de ambiente, conforme mostrado no comando a seguir:
curl https://$AZURE_SPRING_APPS_NAME-servicea.azuremicroservices.io/env
Este comando produz a seguinte saída.
"JAVA_TOOL_OPTIONS":"-Deureka.client.service-url.defaultZone=https://$AZURE_SPRING_APPS_NAME.svc.azuremicroservices.io/eureka/default/eureka
Como você pode ver, eureka.client.service-url.defaultZone é adicionado ao JAVA_TOOL_OPTIONS. Desta forma, a aplicação pode registar o serviço no Registo de Serviços e disponibilizá-lo a partir de outros serviços.
Agora você pode registrar o serviço no Registro de Serviço (Eureka Server) no Azure Spring Apps. Outros serviços agora podem acessar o serviço usando o registro de serviço.
Implementar um novo Serviço B que aceda ao Serviço A através do Registo de Serviços
Implementar o Serviço B com o Spring Boot
Navegue até Spring Initializr para criar um novo projeto para o Serviço B. Este link usa a seguinte URL para inicializar as configurações:
https://start.spring.io/#!type=maven-project&language=java&packaging=jar&groupId=com.example&artifactId=Sample%20Service%20B&name=Sample%20Service%20B&description=Demo%20project%20for%20Spring%20Boot&packageName=com.example.Sample%20Service%20B&dependencies=web,cloud-eureka
Em seguida, selecione GERAR para obter o novo projeto.
Implementar o Serviço B como um cliente de Registo de Serviços (cliente Eureka)
Como o Serviço A, adicione a @EnableEurekaClient anotação ao Serviço B para configurá-lo como um cliente Eureka.
package com.example.Sample.Service.B;
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.cloud.netflix.eureka.EnableEurekaClient;
@SpringBootApplication
@EnableEurekaClient
public class SampleServiceBApplication {
public static void main(String[] args) {
SpringApplication.run(SampleServiceBApplication.class, args);
}
}
Implementar pontos de extremidade de serviço no Serviço B
Em seguida, implemente um novo ponto de extremidade de serviço (/invoke-serviceA) que invoque o Serviço A. Adicione um arquivo ServiceBEndpoint.java ao seu projeto com o código a seguir.
package com.example.Sample.Service.B;
import java.util.List;
import java.util.stream.Collectors;
import com.netflix.discovery.EurekaClient;
import com.netflix.discovery.shared.Application;
import com.netflix.discovery.shared.Applications;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RestController;
import org.springframework.web.client.RestTemplate;
@RestController
public class ServiceBEndpoint {
@Autowired
private EurekaClient discoveryClient;
@GetMapping(value = "/invoke-serviceA")
public String invokeServiceA()
{
RestTemplate restTemplate = new RestTemplate();
String response = restTemplate.getForObject("http://servicea/serviceA",String.class);
return "INVOKE SERVICE A FROM SERVICE B: " + response;
}
@GetMapping(value = "/list-all")
public List<String> listsAllServices() {
Applications applications = discoveryClient.getApplications();
List<Application> registeredApplications = applications.getRegisteredApplications();
List<String> appNames = registeredApplications.stream().map(app -> app.getName()).collect(Collectors.toList());
return appNames;
}
}
Este exemplo usa RestTemplate para simplificar. O ponto de extremidade retorna a cadeia de caracteres de resposta com outra cadeia de caracteres (INVOKE SERVICE A FROM SERVICE B: ") para indicar que ela foi chamada pelo Serviço B.
Este exemplo também implementa outro ponto de extremidade (/list-all) para validação. Essa implementação garante que o serviço esteja se comunicando corretamente com o Registro de Serviço. Você pode chamar esse ponto de extremidade para obter a lista de aplicativos registrados no Registro de Serviço.
Este exemplo invoca o Serviço A como http://servicea. O nome do serviço é o nome que você especificou durante a criação do aplicativo Azure Spring Apps. (Por exemplo: az spring app create --name ServiceA.) O nome do aplicativo corresponde ao nome do serviço que você registrou no registro do serviço, facilitando o gerenciamento do nome do serviço.
Serviço de compilação B
Use o comando a seguir para criar seu projeto.
mvn clean package
Implantar o Serviço B no Azure Spring Apps
Use o comando a seguir para criar um aplicativo no Azure Spring Apps para implantar o Serviço B.
az spring app create \
--resource-group $RESOURCE_GROUP \
--service $AZURE_SPRING_APPS_NAME \
--name serviceB \
--instance-count 1 \
--memory 2Gi \
--assign-endpoint
Em seguida, use o seguinte comando para vincular o aplicativo ao Registro de Serviço.
az spring service-registry bind \
--resource-group $RESOURCE_GROUP \
--service $AZURE_SPRING_APPS_NAME \
--app serviceB
Em seguida, use o seguinte comando para implantar o serviço.
az spring app deploy \
--resource-group $RESOURCE_GROUP \
--service $AZURE_SPRING_APPS_NAME \
--name serviceB \
--artifact-path ./target/Sample-Service-B-0.0.1-SNAPSHOT.jar \
--jvm-options="-Xms1024m -Xmx1024m"
Em seguida, use o seguinte comando para verificar o status do aplicativo.
az spring app list \
--resource-group $RESOURCE_GROUP \
--service $AZURE_SPRING_APPS_NAME \
--output table
Se o Serviço A e o Serviço B forem implantados corretamente, esse comando produzirá uma saída semelhante ao exemplo a seguir.
Name Location ResourceGroup Public Url Production Deployment Provisioning State CPU Memory Running Instance Registered Instance Persistent Storage Bind Service Registry Bind Application Configuration Service
-------- ------------- ---------------------- --------------------------------------------------------------- ----------------------- -------------------- ----- -------- ------------------ --------------------- -------------------- ----------------------- ----------------------------------------
servicea southeastasia SpringCloud-Enterprise https://$AZURE_SPRING_APPS_NAME-servicea.azuremicroservices.io default Succeeded 1 2Gi 1/1 1/1 - default -
serviceb southeastasia SpringCloud-Enterprise https://$AZURE_SPRING_APPS_NAME-serviceb.azuremicroservices.io default Succeeded 1 2Gi 1/1 1/1 - default -
Invoque o Serviço A do Serviço B
A saída do comando anterior inclui a URL pública do serviço. Para acessar o ponto de extremidade RESTful, acrescente /invoke-serviceA à URL, conforme mostrado no comando a seguir:
curl https://$AZURE_SPRING_APPS_NAME-serviceb.azuremicroservices.io/invoke-serviceA
Este comando produz a seguinte saída:
INVOKE SERVICE A FROM SERVICE B: This is a result of Service A
Obter algumas informações do Registro de Serviço
Finalmente, acesse o /list-all ponto de extremidade e recupere algumas informações do Registro de Serviço. O comando a seguir recupera uma lista de serviços registrados no Registro de Serviço.
curl https://$AZURE_SPRING_APPS_NAME-serviceb.azuremicroservices.io/list-all
Este comando produz a seguinte saída.
["SERVICEA","EUREKA-SERVER","SERVICEB"]
Desta forma, você pode obter informações detalhadas do programa, conforme necessário.
Ativar/desativar o Registo de Serviço após a criação do serviço
Você pode habilitar e desabilitar o Registro de Serviço após a criação do serviço usando o portal do Azure ou a CLI do Azure. Antes de desativar o Registro de Serviço, é necessário desvincular todos os seus aplicativos dele.
Use as seguintes etapas para habilitar ou desabilitar o Registro de Serviço usando o portal do Azure:
- Navegue até o recurso de serviço e selecione Registro de Serviço.
- Selecione Gerir.
- Selecione ou desmarque a opção Ativar Registro de Serviço e selecione Salvar.
- Agora você pode exibir o estado do Registro de Serviço na página Registro de Serviço .