Guia de início rápido: criar e implantar aplicativos no Azure Spring Apps

Artigo
10/01/2024

Nota

Os planos Basic, Standard e Enterprise serão preteridos a partir de meados de março de 2025, com um período de aposentadoria de 3 anos. Recomendamos a transição para os Aplicativos de Contêiner do Azure. Para obter mais informações, consulte o anúncio de aposentadoria do Azure Spring Apps.

O plano de consumo padrão e dedicado será preterido a partir de 30 de setembro de 2024, com um desligamento completo após seis meses. Recomendamos a transição para os Aplicativos de Contêiner do Azure. Para obter mais informações, consulte Migrar consumo padrão e plano dedicado do Azure Spring Apps para Aplicativos de Contêiner do Azure.

Este artigo aplica-se a: ✔️ Basic/Standard ❌ Enterprise

Este guia de início rápido explica como criar e implantar aplicativos Spring no Azure Spring Apps usando a CLI do Azure.

Pré-requisitos

Conclusão dos inícios rápidos anteriores desta série:
- Provisione uma instância de serviço do Azure Spring Apps.
- Configure o Azure Spring Apps Config Server.

Transferir a aplicação de exemplo

Use as etapas a seguir para baixar o aplicativo de exemplo. Se você estiver usando o Azure Cloud Shell, alterne para um prompt de comando local.

Crie uma nova pasta e clone o repositório de aplicativo de exemplo.

mkdir source-code

cd source-code

git clone https://github.com/Azure-Samples/azure-spring-apps-samples

Navegue até o diretório do repositório.
```
cd azure-spring-apps-samples
```

Implantar o PlanetWeatherProvider

Use as etapas a seguir para implantar o projeto PlanetWeatherProvider.

Crie um aplicativo para o projeto em sua instância do PlanetWeatherProvider Azure Spring Apps.
```
az spring app create --name planet-weather-provider --runtime-version NetCore_31
```
Para habilitar o registro automático de serviço, você deu ao aplicativo o mesmo nome que o valor de no arquivo de appsettings.json do spring.application.name projeto:
```
"spring": {
  "application": {
    "name": "planet-weather-provider"
  }
}
```
Este comando pode levar vários minutos para ser executado.
Altere o diretório para a pasta do PlanetWeatherProvider projeto.
```
cd steeltoe-sample/src/planet-weather-provider
```

Crie os binários e o arquivo .zip a ser implantado.

dotnet publish -c release -o ./publish

Gorjeta

O arquivo de projeto contém o seguinte XML para empacotar os binários em um arquivo .zip depois de gravá-los na pasta ./publishing :

<Target Name="Publish-Zip" AfterTargets="Publish">
  <ZipDirectory SourceDirectory="$(PublishDir)" DestinationFile="$(MSBuildProjectDirectory)/publish-deploy-planet.zip" Overwrite="true" />
</Target>

Implemente o projeto no Azure

Certifique-se de que o prompt de comando está na pasta do projeto antes de executar o seguinte comando.
```
az spring app deploy \
    --name planet-weather-provider \
    --runtime-version NetCore_31 \
    --main-entry Microsoft.Azure.SpringCloud.Sample.PlanetWeatherProvider.dll \
    --artifact-path ./publish-deploy-planet.zip
```
A --main-entry opção especifica o caminho relativo da pasta raiz do arquivo .zip para o arquivo .dll que contém o ponto de entrada do aplicativo. Depois que o serviço carrega o arquivo .zip, ele extrai todos os arquivos e pastas e, em seguida, tenta executar o ponto de entrada no arquivo .dll especificado.

Este comando pode levar vários minutos para ser executado.

Implantar o SolarSystemWeather

Use as etapas a seguir para implantar o projeto SolarSystemWeather.

Crie outro aplicativo em sua instância do Azure Spring Apps para o projeto.
```
az spring app create --name solar-system-weather --runtime-version NetCore_31
```
solar-system-weatheré o nome especificado no SolarSystemWeather arquivo appsettings.json do projeto.

Este comando pode levar vários minutos para ser executado.
Altere o diretório para o SolarSystemWeather projeto.
```
cd ../solar-system-weather
```
Crie os binários e .zip arquivo a ser implantado.
```
dotnet publish -c release -o ./publish
```

Implemente o projeto no Azure

az spring app deploy \
    --name solar-system-weather \
    --runtime-version NetCore_31 \
    --main-entry Microsoft.Azure.SpringCloud.Sample.SolarSystemWeather.dll \
    --artifact-path ./publish-deploy-solar.zip

Este comando pode levar vários minutos para ser executado.

Atribuir ponto de extremidade público

Antes de testar o aplicativo, obtenha um ponto de extremidade público para uma solicitação HTTP GET para o solar-system-weather aplicativo.

Execute o seguinte comando para atribuir o ponto de extremidade.

az spring app update --name solar-system-weather --assign-endpoint true

Execute o seguinte comando para obter a URL do ponto de extremidade.

Windows:

az spring app show --name solar-system-weather --output table

Linux:

az spring app show --name solar-system-weather | grep url

Testar a aplicação

Para testar o aplicativo, envie uma solicitação GET para o solar-system-weather aplicativo. Em um navegador, navegue até a URL pública anexada /weatherforecast a ela. Por exemplo: https://servicename-solar-system-weather.azuremicroservices.io/weatherforecast

A saída é JSON:

[{"Key":"Mercury","Value":"very warm"},{"Key":"Venus","Value":"quite unpleasant"},{"Key":"Mars","Value":"very cool"},{"Key":"Saturn","Value":"a little bit sandy"}]

Essa resposta mostra que ambos os aplicativos Spring estão funcionando. O SolarSystemWeather aplicativo retorna os dados recuperados do PlanetWeatherProvider aplicativo.

Este artigo explica como criar e implantar aplicativos Spring no Azure Spring Apps. Você pode usar a CLI do Azure, o plug-in Maven ou o Intellij. Este artigo descreve cada alternativa.

Pré-requisitos

Conclusão dos inícios rápidos anteriores desta série:
- Provisione uma instância de serviço do Azure Spring Apps.
- Configure o Azure Spring Apps Config Server.
JDK 17
Maven 3.0 ou superior
Uma subscrição do Azure. Se você não tiver uma assinatura, crie uma conta gratuita antes de começar.
Opcionalmente, a CLI do Azure versão 2.45.0 ou superior. Instale a extensão Azure Spring Apps com o seguinte comando: az extension add --name spring
Opcionalmente, o Kit de Ferramentas do Azure para IntelliJ.

Crie os aplicativos Spring localmente

Use os comandos a seguir para clonar o repositório de exemplo, navegue até a pasta de exemplo e crie o projeto.

git clone https://github.com/azure-samples/spring-petclinic-microservices
cd spring-petclinic-microservices
mvn clean package -DskipTests -Denv=cloud

A compilação do projeto leva de 5 a 10 minutos. Quando o projeto é compilado, você deve ter arquivos JAR individuais para cada serviço em suas respetivas pastas.

Criar e implantar aplicativos no Azure Spring Apps

Use as etapas a seguir para criar e implantar aplicativos no Azure Spring Apps usando a CLI.

Se você não executou os seguintes comandos nos inícios rápidos anteriores, execute-os agora para definir os padrões da CLI.
```
az configure --defaults group=<resource-group-name> spring=<service-name>
```

Crie os dois principais aplicativos Spring para PetClinic: api-gateway e customers-service.

az spring app create \
    --name api-gateway \
    --runtime-version Java_17 \
    --instance-count 1 \
    --memory 2Gi \
    --assign-endpoint
az spring app create \
    --name customers-service \
    --runtime-version Java_17 \
    --instance-count 1 \
    --memory 2Gi

Implante os arquivos JAR criados na etapa anterior.

az spring app deploy \
    --name api-gateway \
    --artifact-path spring-petclinic-api-gateway/target/api-gateway-3.0.1.jar \
    --jvm-options="-Xms2048m -Xmx2048m"
az spring app deploy \
    --name customers-service \
    --artifact-path spring-petclinic-customers-service/target/customers-service-3.0.1.jar \
    --jvm-options="-Xms2048m -Xmx2048m"

Consulte o status do aplicativo após implantações com o seguinte comando.

az spring app list --output table

Este comando produz uma saída semelhante ao exemplo a seguir:

Name               Location    ResourceGroup    Production Deployment    Public Url                                           Provisioning Status    CPU    Memory    Running Instance    Registered Instance    Persistent Storage
-----------------  ----------  ---------------  -----------------------  ---------------------------------------------------  ---------------------  -----  --------  ------------------  ---------------------  --------------------
api-gateway        eastus      xxxxxx-sp         default                  https://<service name>-api-gateway.azuremicroservices.io   Succeeded              1      2         1/1                 1/1                    -
customers-service  eastus      <service name>         default                                                                       Succeeded              1      2         1/1                 1/1                    -

Verificar os serviços

Acesso api-gateway e customers-service a partir de um navegador com o URL público mostrado anteriormente, no formato de https://<service name>-api-gateway.azuremicroservices.io.

Gorjeta

Para solucionar problemas de implantações, você pode usar o seguinte comando para obter o streaming de logs em tempo real sempre que o aplicativo estiver em execução az spring app logs --name <app name> --follow.

Implantar aplicativos extras

Para que o aplicativo PetClinic funcione com todos os recursos, como Admin Server, Visitas e Veterinários, implante os outros aplicativos com os seguintes comandos:

az spring app create \
    --name admin-server \
    --runtime-version Java_17 \
    --instance-count 1 \
    --memory 2Gi \
    --assign-endpoint
az spring app create \
    --name vets-service \
    --runtime-version Java_17 \
    --instance-count 1 \
    --memory 2Gi
az spring app create \
    --name visits-service \
    --runtime-version Java_17 \
    --instance-count 1 \
    --memory 2Gi
az spring app deploy \
    --name admin-server \
    --runtime-version Java_17 \
    --artifact-path spring-petclinic-admin-server/target/admin-server-3.0.1.jar \
    --jvm-options="-Xms1536m -Xmx1536m"
az spring app deploy \
    --name vets-service \
    --runtime-version Java_17 \
    --artifact-path spring-petclinic-vets-service/target/vets-service-3.0.1.jar \
    --jvm-options="-Xms1536m -Xmx1536m"
az spring app deploy \
    --name visits-service \
    --runtime-version Java_17 \
    --artifact-path spring-petclinic-visits-service/target/visits-service-3.0.1.jar \
    --jvm-options="-Xms1536m -Xmx1536m"

Crie os aplicativos Spring localmente

Use os comandos a seguir para clonar o repositório de exemplo, navegue até a pasta de exemplo e crie o projeto.

git clone https://github.com/azure-samples/spring-petclinic-microservices
cd spring-petclinic-microservices
mvn clean package -DskipTests -Denv=cloud

A compilação do projeto leva de 5 a 10 minutos. Quando o projeto é compilado, você deve ter arquivos JAR individuais para cada serviço em suas respetivas pastas.

Gerar configurações e implantar no Azure Spring Apps

As etapas a seguir mostram como gerar configurações e implantar no Azure Spring Apps:

Vá para a pasta spring-petclinic-customers-service . Gere configurações executando o seguinte comando. Se você já entrou com a CLI do Azure, o comando seleciona automaticamente as credenciais. Caso contrário, ele entra usando um prompt com instruções. Para obter mais informações, consulte Autenticação no wiki azure-maven-plugins .
```
mvn com.microsoft.azure:azure-spring-apps-maven-plugin:1.19.0:config -DappName=customers-service
```
É-lhe pedido que forneça os seguintes valores:
- Assinatura: a assinatura usada para criar uma instância do Azure Spring Apps.
- Instância de serviço: o nome da sua instância do Azure Spring Apps.
- Ponto de extremidade público: se um ponto de extremidade público deve ser atribuído ao aplicativo. Selecione Não.

Verifique se os appName elementos nos arquivos POM estão corretos:

<build>
    <plugins>
        <plugin>
            <groupId>com.microsoft.azure</groupId>
            <artifactId>azure-spring-apps-maven-plugin</artifactId>
            <version>1.19.0</version>
            <configuration>
                <subscriptionId>xxxxxxxxx-xxxx-xxxx-xxxxxxxxxxxx</subscriptionId>
                <clusterName>v-spr-cld</clusterName>
                <appName>customers-service</appName>

O POM agora contém as dependências e configurações do plugin.

Implante os aplicativos usando o seguinte comando:
```
mvn azure-spring-apps:deploy
```
Vá para a pasta spring-petclinic-api-gateway . Execute os seguintes comandos para gerar a configuração e implantar api-gatewayo . Selecione sim para Ponto de extremidade Público.
```
mvn com.microsoft.azure:azure-spring-apps-maven-plugin:1.19.0:config -DappName=api-gateway
mvn azure-spring-apps:deploy
```

Verificar os serviços

Um comando de implantação bem-sucedido retorna uma URL no formato: https://<service name>-spring-petclinic-api-gateway.azuremicroservices.io. Use-o para navegar até o serviço em execução.

Você também pode navegar no portal do Azure para encontrar a URL.

Navegue até o serviço.
Selecione Aplicações.
Selecione api-gateway.
Encontre o URL no api-gateway | Página de visão geral .

Implantar aplicativos extras

Para que o aplicativo PetClinic funcione com todas as seções, como Admin Server, Visitas e Veterinários, você pode implantar os outros aplicativos Spring. Execute novamente o comando de configuração e selecione os seguintes aplicativos.

admin-servidor
serviço veterinário
serviço de visitas

Corrija os nomes dos aplicativos em cada arquivo de pom.xml para esses módulos e execute o deploy comando novamente.

Importar projeto de exemplo no IntelliJ

Use as etapas a seguir para importar o projeto de exemplo no IntelliJ.

Baixe e descompacte o repositório de origem para este tutorial, ou clone-o usando o Git: git clone https://github.com/azure-samples/spring-petclinic-microservices
Abra a caixa de diálogo Bem-vindo do IntelliJ e selecione Importar projeto para abrir o assistente de importação.
Selecione a pasta spring-petclinic-microservices .

Implantar o aplicativo api-gateway no Azure Spring Apps

Para implantar no Azure, você deve entrar com sua conta do Azure com o Kit de Ferramentas do Azure para IntelliJ e escolher sua assinatura. Para obter detalhes de entrada, consulte Criar um aplicativo Web Hello World para o Serviço de Aplicativo do Azure usando o IntelliJ.

Clique com o botão direito do mouse em seu projeto no explorador de projetos IntelliJ e selecione Azure ->Deploy to Azure Spring Apps.
No campo Nome, acrescente :api-gateway ao Nome existente.
Na caixa de texto Artefato , selecione spring-petclinic-api-gateway-3.0.1.
Na caixa de texto Subscrição, verifique a sua subscrição.
Na caixa de texto Spring Apps, selecione a instância do Azure Spring Apps que você criou em Provisionar a instância do Azure Spring Apps.
Na caixa de texto Aplicativo: , selecione Criar aplicativo....
Digite api-gateway e selecione OK.
Defina Ponto de extremidade público como Habilitar.
Defina as opções Memória como 2.0Gi e JVM como -Xms2048m -Xmx2048m.
Na seção Antes de iniciar da caixa de diálogo, clique duas vezes em Executar meta do Maven.
Na caixa de texto Diretório de trabalho, navegue até a pasta spring-petclinic-microservices/spring-petclinic-api-gateway.
Na caixa de texto Linha de comando, digite package -DskipTests. Selecione OK.
Inicie a implantação selecionando o botão Executar na parte inferior da caixa de diálogo Implantar o aplicativo Azure Spring Apps . O plug-in executa o api-gateway comando mvn package no aplicativo e implanta o arquivo JAR gerado pelo package comando.

Implantar o atendimento ao cliente e outros aplicativos no Azure Spring Apps

Repita as etapas anteriores para implantar customers-service e outros aplicativos Pet Clinic no Azure Spring Apps:

Modifique o Nome e o Artefato para identificar o customers-service aplicativo.
Na caixa de texto Aplicativo: , selecione Criar aplicativo... para criar customers-service aplicativo.
Verifique se a opção Ponto de extremidade público está definida como Desabilitado.
Na seção Antes de iniciar da caixa de diálogo, alterne o diretório de trabalho para a pasta petclinic/customers-service.
Inicie a implantação selecionando o botão Executar na parte inferior da caixa de diálogo Implantar o aplicativo Azure Spring Apps .

Verificar os serviços

Navegue até o URL do formulário: https://<service name>-spring-petclinic-api-gateway.azuremicroservices.io

Você também pode navegar no portal do Azure para encontrar a URL.

Navegue até o serviço
Selecione Aplicações
Selecionar api-gateway
Encontre o URL no api-gateway | Página de visão geral

Implantar aplicativos extras

Outros aplicativos Spring incluídos neste exemplo podem ser implantados de forma semelhante.

admin-servidor
serviço veterinário
serviço de visitas

Clean up resources (Limpar recursos)

Se você planeja continuar trabalhando com guias de início rápido e tutoriais subsequentes, convém deixar esses recursos no lugar. Quando não for mais necessário, exclua o grupo de recursos, que exclui os recursos do grupo de recursos. Para excluir o grupo de recursos usando a CLI do Azure, use os seguintes comandos:

echo "Enter the Resource Group name:" &&
read resourceGroupName &&
az group delete --name $resourceGroupName &&
echo "Press [ENTER] to continue ..."

Próximos passos

Guia de início rápido: configurar um espaço de trabalho do Log Analytics

Partilhar via

Guia de início rápido: criar e implantar aplicativos no Azure Spring Apps

Pré-requisitos

Transferir a aplicação de exemplo

Implantar o PlanetWeatherProvider

Implantar o SolarSystemWeather

Atribuir ponto de extremidade público

Testar a aplicação

Pré-requisitos

Crie os aplicativos Spring localmente

Criar e implantar aplicativos no Azure Spring Apps

Verificar os serviços

Implantar aplicativos extras

Crie os aplicativos Spring localmente

Gerar configurações e implantar no Azure Spring Apps

Verificar os serviços

Implantar aplicativos extras

Importar projeto de exemplo no IntelliJ

Implantar o aplicativo api-gateway no Azure Spring Apps

Implantar o atendimento ao cliente e outros aplicativos no Azure Spring Apps

Verificar os serviços

Implantar aplicativos extras

Clean up resources (Limpar recursos)

Próximos passos

Comentários

Recursos adicionais