Conectar-se a um Gateway gerenciado para o Spring no Aplicativos de Contêiner do Azure (versão prévia)

O Gateway para Spring oferece uma maneira eficiente e eficiente de rotear, gerenciar e lidar com solicitações de API como parte de uma arquitetura de microsserviços. Ele serve como um Gateway de API que roteia solicitações externas para diferentes serviços, adicionando vários recursos, como filtragem, balanceamento de carga e muito mais. Neste artigo, você aprenderá a criar um gateway que direciona solicitações para seus aplicativos de contêiner.

Neste tutorial, você aprenderá a:

Pré-requisitos

• Uma conta Azure com uma assinatura ativa. Caso ainda não tenha uma, você pode criar uma gratuitamente.
• CLI do Azure.

Considerações

Ao executar no Gateway para Spring no Aplicativos de Contêiner do Azure, lembre-se dos seguintes detalhes:

Instalação

Antes de começar a trabalhar com o Gateway para Spring, será necessário primeiro criar os recursos necessários.

Execute os seguintes comandos para criar seu grupo de recursos e o ambiente de Aplicativos de Contêiner.

1. Crie variáveis para dar suporte à configuração do aplicativo. Esses valores são fornecidos para você para os fins desta lição. Usamos o ponto de extremidade do atuador do administrador para o aplicativo de exemplo do Spring nesta lição.

   export LOCATION=eastus
   export RESOURCE_GROUP=my-spring-cloud-resource-group
   export ENVIRONMENT=my-spring-cloud-environment
   export JAVA_COMPONENT_NAME=mygateway
   export APP_NAME=myapp
   export IMAGE="mcr.microsoft.com/javacomponents/samples/sample-admin-for-spring-client:latest"
   

   Variável	Descrição
   LOCATION	A localização da região do Azure onde você cria seu aplicativo de containers e o componente Java.
   ENVIRONMENT	O nome do ambiente Aplicativos de Contêiner do Azure para seu aplicativo de demonstração.
   RESOURCE_GROUP	O nome do grupo de recursos do Azure para seu aplicativo de demonstração.
   JAVA_COMPONENT_NAME	O nome do componente Java criado para seu aplicativo de contêiner. Nesse caso, você criará um componente do Gateway para Spring Java.
   IMAGE	A imagem do contêiner usada no seu aplicativo de contêiner.

2. Entre no Azure com o CLI do Azure.

   az login
   

3. Crie um grupo de recursos.

   az group create --name $RESOURCE_GROUP --location $LOCATION
   

4. Crie seu ambiente de aplicativos de contêiner.

   az containerapp env create \
       --name $ENVIRONMENT \
       --resource-group $RESOURCE_GROUP \
       --location $LOCATION
   

   Esse ambiente é usado para hospedar o componente do Gateway para Spring e o aplicativo de contêiner.

Usar o componente Gateway para Spring Java

Agora que você tem um ambiente de Aplicativos de Contêiner, poderá criar seu aplicativo de contêiner e usar um gateway para os componentes do Spring Java para rotear a solicitação para eles.

1. Crie o componente Gateway para Spring Java.

   az containerapp env java-component gateway-for-spring create \
       --environment $ENVIRONMENT \
       --resource-group $RESOURCE_GROUP \
       --name $JAVA_COMPONENT_NAME \
   

2. Crie o aplicativo de contêiner que tenha o nome de domínio totalmente qualificado (FQDN).

   az containerapp create \
       --name $APP_NAME \
       --resource-group $RESOURCE_GROUP \
       --environment $ENVIRONMENT \
       --image $IMAGE \
       --ingress external \
       --target-port 8080 \
       --query properties.configuration.ingress.fqdn
   

   Esse comando retorna a URL do seu aplicativo de contêiner que consome dados de configuração. Copie a URL em um editor de texto para poder usá-lo em uma próxima etapa.

Atualizar as Rotas do Gateway para rotear solicitações

1. Crie um arquivo YAML com o seguinte conteúdo. Substitua <MYAPP_URL> pelo FQDN do aplicativo de contêiner da etapa anterior.

   springCloudGatewayRoutes:
   - id: "route1"
     uri: "<MYAPP_URL>"
     predicates:
       - "Path=/myapp/{path}"
     filters:
       - "SetPath=/actuator/{path}"
   

2. Execute o seguinte comando para atualizar o componente Gateway do Spring com a configuração da rota.

   az containerapp env java-component gateway-for-spring update \
       --environment $ENVIRONMENT \
       --resource-group $RESOURCE_GROUP \
       --name $JAVA_COMPONENT_NAME \ 
       --route-yaml <PTAH_TO_ROUTE_YAML_FILE> \
       --query properties.ingress.fqdn
   

   Esse comando atualiza a rota do gateway e retorna a URL do gateway que consome dados de configuração.

   O comando retorna a URL do gateway. Visitar esta URL com o caminho /myapp/health deve redirecionar a solicitação para o endpoint actuator/health da aplicação, retornando {"status":"UP","groups":["liveness","readiness"]}.

Limpar os recursos

Os recursos criados neste tutorial têm um efeito sobre sua fatura de Azure. Se você não usar esses serviços a longo prazo, execute o comando a seguir para remover tudo o que foi criado neste tutorial.

az group delete --resource-group $RESOURCE_GROUP

Formato de arquivo de rota

O componente do Gateway para Spring dá suporte à definição de rotas por meio de propriedades com ID, URI, predicados e filtros. Para obter mais informações, confira a documentação do Gateway do Spring Cloud. A seguir, um exemplo de arquivo YAML que demonstra como configurar essas propriedades.

  springCloudGatewayRoutes:
  - id: "route1"
    uri: "https://otherjavacomponent.myenvironment.test.net"
    predicates:
      - "Path=/v1/{path}"
      - "After=2024-01-01T00:00:00.000-00:00[America/Denver]"
    filters:
      - "SetPath=/{path}"
  - id: "route2"
    uri: "https://otherjavacomponent.myenvironment.test.net"
    predicates:
      - "Path=/v2/{path}"
      - "After=2024-01-01T00:00:00.000-00:00[America/Denver]"
    filters:
      - "SetPath=/{path}"

Lista de configurações permitidas para seu Gateway para Spring(#configurable-properties)

A tabela a seguir descreve as propriedades do componente de gateway que você pode configurar para o seu aplicativo. Para obter mais informações, confira Propriedades comuns do aplicativo de Gateway do Spring Cloud.

Configurações comuns

A lista a seguir descreve configurações comuns:

• Configurações relacionadas ao registro em log:
  • logging.level.*
  • logging.group.*
  • Quaisquer outras configurações no âmbito do namespace logging.* devem ser proibidas. Por exemplo, a gravação de arquivos de log usando logging.file deve ser proibida.