Início Rápido: Implantar o seu primeiro aplicativo no Azure Spring Apps

Observação

As primeiras 50 horas de vCPU e os primeiros 100 GB de memória são gratuitos todos os meses. Para obter mais informações, confira Redução de preços – os Aplicativos Spring do Azure fazem mais, custando menos no blog Apps on Azure.

Observação

Azure Spring Apps é o novo nome do serviço Azure Spring Cloud. Embora o serviço tenha um novo nome, você verá o nome antigo em alguns locais por um tempo enquanto trabalhamos para atualizar ativos como capturas de tela, vídeos e diagramas.

Este artigo se aplica a: ✔️ camada Básica/Standard ✔️ camada Enterprise

Este início rápido explica como implantar um pequeno aplicativo para ser executado no Azure Spring Apps.

O código do aplicativo usado neste tutorial é um aplicativo simples. Quando você concluir este exemplo, o aplicativo estará acessível online e poderá ser gerenciado por meio do portal do Azure.

Este guia de início rápido explica como:

• Gerar um projeto básico do Spring.
• Provisionar uma instância de serviço.
• Criar e implantar um aplicativo com um ponto de extremidade público.
• Limpar os recursos.

No final deste guia de início rápido, você terá um aplicativo Spring em execução nos Aplicativos Spring do Azure.

CLI do Azure

Pré-requisitos

• Uma assinatura do Azure. Caso não tenha uma assinatura, crie uma conta gratuita antes de começar.
• CLI do Azure. Instalar a extensão do Azure Spring Apps com o seguinte comando: az extension add --name spring
• Se você estiver implantando o nível Enterprise dos Aplicativos Spring do Azure pela primeira vez na assinatura alvo, confira a seção Pré-requisitos da oferta de Exibir o nível Enterprise dos Aplicativos Spring do Azure no Azure Marketplace.

Provisionar uma instância do Azure Spring Apps

Siga as seguintes etapas para provisionar uma instância de serviço.

1. Selecione Experimentar e entre em sua conta do Azure no Azure Cloud Shell.

   az account show
   

2. Os workspaces do Azure Cloud Shell são temporários. Na primeira inicialização, o shell solicita que você associe uma instância do Armazenamento do Azure à assinatura para persistir arquivos entre sessões.

   

3. Depois de entrar com êxito, use o comando a seguir para exibir uma lista de suas assinaturas.

   az account list --output table
   

4. Use o comando a seguir para escolher a assinatura e vincular-se a ela.

   az account set --subscription <subscription-id>
   

5. Use o comando a seguir para criar um grupo de recursos.

   az group create \
       --resource-group <name-of-resource-group> \
       --location eastus
   

6. Use o seguinte comando para criar uma instância de serviço dos Aplicativos Spring do Azure.

   az spring create \
       --resource-group <name-of-resource-group> \
       --name <service-instance-name>
   

7. Escolha Y para instalar a extensão do Aplicativos Spring do Azure e executá-la.

Criar o aplicativo em sua instância dos Aplicativos Spring do Azure

Use o comando a seguir para especificar o nome do aplicativo nos Aplicativos Spring do Azure como hellospring.

az spring app create \
    --resource-group <name-of-resource-group> \
    --service <service-instance-name> \
    --name hellospring \
    --assign-endpoint true

Clone e crie o projeto de exemplo Spring Boot

Use as etapas a seguir para clonar o projeto Spring Boot de exemplo.

1. Use o comando a seguir para clonar o projeto Spring Boot de exemplo do GitHub.

   git clone https://github.com/spring-guides/gs-spring-boot.git
   

2. Use o comando a seguir para acessar a pasta do projeto.

   cd gs-spring-boot/complete
   

3. Use o comando Maven a seguir para criar o projeto.

   mvn clean package -DskipTests
   

Implantar o aplicativo local nos Aplicativos Spring do Azure

Use o comando a seguir para implantar o arquivo .jar no aplicativo (target/spring-boot-complete-0.0.1-SNAPSHOT.jar no Windows).

az spring app deploy \
    --resource-group <name-of-resource-group> \
    --service <service-instance-name> \
    --name hellospring \
    --artifact-path target/spring-boot-complete-0.0.1-SNAPSHOT.jar

A implantação do aplicativo pode levar alguns minutos.

IntelliJ

Pré-requisitos

• Uma assinatura do Azure. Caso não tenha uma assinatura, crie uma conta gratuita antes de começar.
• IntelliJ IDEA.
• Kit de Ferramentas do Azure para IntelliJ.
• Se você estiver implantando o nível Enterprise dos Aplicativos Spring do Azure pela primeira vez na assinatura alvo, confira a seção Pré-requisitos da oferta de Exibir o nível Enterprise dos Aplicativos Spring do Azure no Azure Marketplace.

Gerar um projeto do Spring

Use as etapas a seguir para criar um projeto:

1. Comece com o Spring Initializr para gerar um projeto de exemplo com as dependências recomendadas para os Aplicativos Spring do Azure. A URL a seguir fornece as configurações padrão para você.

https://start.spring.io/#!type=maven-project&language=java&platformVersion=2.6.10&packaging=jar&jvmVersion=11&groupId=com.example&artifactId=hellospring&name=hellospring&description=Demo%20project%20for%20Spring%20Boot&packageName=com.example.hellospring&dependencies=web,cloud-eureka,actuator,cloud-config-client

A imagem a seguir mostra a configuração recomendada do Initializr para este projeto de exemplo hellospring.

Este exemplo usa o Java versão 11. Para usar uma versão java diferente, altere a configuração de versão do Java em Metadados do Project.

1. Quando todas as dependências estiverem definidas, selecione Gerar.

2. Baixe e descompacte o pacote e, depois, crie um controlador Web para um aplicativo Web simples adicionando o arquivo src/main/java/com/example/hellospring/HelloController.java com o seguinte conteúdo:

   package com.example.hellospring;
   
   import org.springframework.web.bind.annotation.RestController;
   import org.springframework.web.bind.annotation.RequestMapping;
   
   @RestController
   public class HelloController {
   
       @RequestMapping("/")
       public String index() {
           return "Greetings from Azure Spring Apps!";
       }
   
   }
   

Provisionar uma instância do Azure Spring Apps

Use as etapas a seguir para criar uma instância dos Aplicativos Spring do Azure com o portal do Azure.

1. Em uma nova guia, abra o portal do Azure.

2. Na caixa de pesquisa superior, pesquise por Azure Spring Apps.

3. Selecione Azure Spring Apps nos resultados.

   

4. Na página do Azure Spring Apps, clique em Criar.

   

5. Preencha o formulário na página Criar do Azure Spring Apps. Considere as seguintes diretrizes:

   • Assinatura: selecione a assinatura da qual você deseja que este recurso seja cobrado.
   • Grupo de recursos: a criação de grupos de recursos para novos recursos é uma melhor prática.
   • Nome do Serviço: especifica o nome da instância de serviço. Você usará esse nome mais adiante neste artigo quando o espaço reservado <service-instance-name> for exibido. O nome deve ter entre 4 e 32 caracteres e pode conter apenas letras minúsculas, números e hifens. O primeiro caractere do nome do serviço deve ser uma letra e o último caractere deve ser uma letra ou um número.
   • Região: selecione a região da instância de serviço.

   

6. Selecione Examinar e criar.

Importar o projeto

Use as etapas a seguir para importar o projeto.

1. Abra o IDEA do IntelliJ e selecione Abrir.

2. Na caixa de diálogo Abrir Arquivo ou Projeto, selecione a pasta hellospring.

   

Compilar e implantar seu aplicativo

Observação

Para executar o projeto localmente, adicione spring.config.import=optional:configserver: ao arquivo application.properties do projeto.

Siga as etapas para criar e implantar o aplicativo.

1. Se você ainda não instalou o Azure Toolkit for IntelliJ, siga as etapas em Instalar o Azure Toolkit for IntelliJ.

2. Clique com o botão direito do mouse em seu projeto na janela Projeto do IntelliJ e selecione Azure –>Implantar no Aplicativos Spring do Azure.

   

3. Aceite o nome do aplicativo no campo Nome. Nome refere-se à configuração, não ao nome do aplicativo. Geralmente isso não é alterado.

4. Na caixa de texto Artefato, selecione Maven:com.example:hellospring-0.0.1-SNAPSHOT.

5. Na caixa de texto Assinatura, verifique se a assinatura está correta.

6. Na caixa de texto Serviço, selecione a instância do Azure Spring Apps criada em Provisionar uma instância do Azure Spring Apps.

7. Na caixa de texto Aplicativo, selecione o sinal de mais (+) para criar um aplicativo.

   

8. Na caixa de texto Nome do aplicativo: em Informações Básicas do Aplicativo, insira hellospring e marque a caixa de seleção Mais configurações.

9. Selecione o botão Habilitar ao lado de Ponto de extremidade público. O botão será alterado para Desabilitar <para ser habilitado>.

10. Se você estiver usando o Java 11, selecione Java 11 para a opção Runtime.

11. Selecione OK.

    

12. Em Antes de iniciar, selecione Executar a meta do Maven 'hellospring:package' e depois selecione o ícone de lápis para editar a linha de comando.

    

13. Na caixa de texto Linha de comando, insira -DskipTests após pacote e selecione OK.

    

14. Para iniciar a implantação, selecione o botão Executar na parte inferior da caixa de diálogo Implantar aplicativo do serviço Aplicativos Spring do Azure. O plug-in executa o comando mvn package -DskipTests no aplicativo hellospring e implanta o arquivo .jar gerado com o comando package.

Visual Studio Code

Pré-requisitos

• Se você estiver implantando o nível Enterprise dos Aplicativos Spring do Azure pela primeira vez na assinatura alvo, confira a seção Pré-requisitos da oferta de Exibir o nível Enterprise dos Aplicativos Spring do Azure no Azure Marketplace.

Implantar um aplicativo Web Spring Boot nos Aplicativos Spring do Azure com o Visual Studio Code

Para implantar um aplicativo Web Spring Boot nos Aplicativos Spring do Azure, siga as etapas em Java nos Aplicativos Spring do Azure.

Depois que a implantação for concluída, acesse o aplicativo em https://<service instance name>-hellospring.azuremicroservices.io/.

Limpar os recursos

Se planejar continuar trabalhando com os tutoriais e inícios rápidos subsequentes, deixe esses recursos onde estão. Quando você não precisar mais dos recursos, exclua-os excluindo o grupo de recursos. Execute o seguinte comando para excluir o grupo de recursos:

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

Próximas etapas

Neste guia de início rápido, você aprendeu a gerar um projeto básico do Spring, provisionar uma instância de serviço, criar e implantar um aplicativo com um ponto de extremidade público e limpar os recursos.

Você também tem acesso a uma funcionalidade avançada de logs, métricas e rastreamento distribuído no portal do Azure. Para obter mais informações, confira Guia de início rápido: monitorar aplicativos dos Aplicativos Spring do Azure com logs, métricas e rastreamento.

Para saber como usar mais funcionalidades do Azure Spring, avance até a série de início rápido que implanta um aplicativo de exemplo para o Azure Spring Apps:

Introdução ao aplicativo de exemplo

Para obter um modelo de aplicativo empacotado com a infraestrutura dos Aplicativos Spring do Azure provisionada usando o Bicep, consulte Aplicativo de Microsserviços PetClinic do Spring Boot implantado nos Aplicativos Spring do Azure.

Mais exemplos estão disponíveis no GitHub: Exemplos do Azure Spring Apps.