Guia de início rápido: implantar seu primeiro aplicativo no Azure Spring Apps

• Uma subscrição do Azure. Se não tiver uma subscrição do Azure, crie uma conta gratuita do Azure antes de começar.

• Uma subscrição do Azure. Se não tiver uma subscrição do Azure, crie uma conta gratuita do Azure antes de começar.
• Git.
• Java Development Kit (JDK), versão 17.

• Uma subscrição do Azure. Se não tiver uma subscrição do Azure, crie uma conta gratuita do Azure antes de começar.
• Git.
• Java Development Kit (JDK), versão 17.
• Azure Developer CLI (AZD), versão 1.2.0 ou superior.

• Uma subscrição do Azure. Se não tiver uma subscrição do Azure, crie uma conta gratuita do Azure antes de começar.
• Se você estiver implantando uma instância do plano do Azure Spring Apps Enterprise pela primeira vez na assinatura de destino, consulte a seção Requisitos do plano Enterprise no Azure Marketplace.

• Uma subscrição do Azure. Se não tiver uma subscrição do Azure, crie uma conta gratuita do Azure antes de começar.
• Se você estiver implantando uma instância do plano do Azure Spring Apps Enterprise pela primeira vez na assinatura de destino, consulte a seção Requisitos do plano Enterprise no Azure Marketplace.
• Git.
• Java Development Kit (JDK), versão 17.

• Uma subscrição do Azure. Se não tiver uma subscrição do Azure, crie uma conta gratuita do Azure antes de começar.
• Se você estiver implantando uma instância do plano do Azure Spring Apps Enterprise pela primeira vez na assinatura de destino, consulte a seção Requisitos do plano Enterprise no Azure Marketplace.
• Git.
• Java Development Kit (JDK), versão 17.
• Azure CLI versão 2.45.0 ou superior.

• Uma subscrição do Azure. Se não tiver uma subscrição do Azure, crie uma conta gratuita do Azure antes de começar.
• Se você estiver implantando uma instância do plano do Azure Spring Apps Enterprise pela primeira vez na assinatura de destino, consulte a seção Requisitos do plano Enterprise no Azure Marketplace.
• Java Development Kit (JDK), versão 17.
• IntelliJ IDEA.
• Kit de Ferramentas do Azure para IntelliJ.

• Uma subscrição do Azure. Se não tiver uma subscrição do Azure, crie uma conta gratuita do Azure antes de começar.
• Se você estiver implantando uma instância do plano do Azure Spring Apps Enterprise pela primeira vez na assinatura de destino, consulte a seção Requisitos do plano Enterprise no Azure Marketplace.
• Java Development Kit (JDK), versão 17.
• Visual Studio Code.

O botão Implantar no Azure na próxima seção inicia uma experiência de portal do Azure que baixa um pacote JAR da página de lançamentos spring-cloud-azure-tools no GitHub. Não são necessárias etapas de preparação locais.

Use as seguintes etapas para preparar o projeto:

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

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

2. Use o seguinte comando para mover para a pasta do projeto:

   cd gs-spring-boot-for-azure/complete
   

3. Use o seguinte comando Maven para criar o projeto:

   ./mvnw clean package
   

4. Execute o projeto de exemplo localmente usando o seguinte comando:

   ./mvnw spring-boot:run
   

Use as seguintes etapas para inicializar o aplicativo a partir dos modelos da CLI do Desenvolvedor do Azure:

1. Abra um terminal, crie uma pasta vazia e, em seguida, altere o diretório para ele.

2. Use o seguinte comando para inicializar o projeto:

   azd init --template spring-guides/gs-spring-boot-for-azure
   

   A lista a seguir descreve as interações de comando:

   • Login OAuth2: você precisa autorizar o logon no Azure com base no protocolo OAuth2.
   • Insira um novo nome de ambiente: forneça um nome de ambiente, que é usado como um sufixo para o grupo de recursos criado para armazenar todos os recursos do Azure. Esse nome deve ser exclusivo em sua assinatura do Azure.

   O console emite mensagens semelhantes ao exemplo a seguir:

   Initializing a new project (azd init)
   
   (✓) Done: Initialized git repository
   (✓) Done: Downloading template code to: <your-local-path>
   Enter a new environment name: <your-env-name>
   SUCCESS: New project initialized!
   You can view the template code in your directory: <your-local-path>
   Learn more about running 3rd party code on our DevHub: https://aka.ms/azd-third-party-code-notice
   

Esta seção usa um botão Implantar no Azure para iniciar uma experiência de implantação no portal do Azure. Essa experiência usa um modelo ARM para criar recursos do Azure.

3.1. Inicie sessão no portal do Azure

Vá para o portal do Azure e insira suas credenciais para entrar no portal. A vista predefinida é o dashboard de serviço.

3.2. Criar recursos do Azure

Use as seguintes etapas para criar todos os recursos do Azure dos quais o aplicativo depende:

1. Selecione o seguinte botão Implantar no Azure para iniciar a experiência de implantação no portal do Azure:

   

2. Preencha o formulário na guia Noções básicas . Use a tabela a seguir como um guia para preencher o formulário:

   Definição	Valor sugerido	Description
   Subscrição	O nome da subscrição.	A subscrição do Azure que quer utilizar para o servidor. Se tiver várias subscrições, escolha a subscrição na qual pretende ser cobrado pelo recurso.
   Grupo de recursos	myresourcegroup	Um nome de grupo de recursos novo ou um já existente na sua subscrição.
   Região	A região mais próxima dos seus utilizadores.	A região é usada para criar o grupo de recursos.

3. Selecione Rever e Criar para rever as suas seleções. Em seguida, selecione Criar para implantar o aplicativo no Azure Spring Apps.

4. Na barra de ferramentas, selecione o ícone Notificações (um sino) para monitorizar o processo de implementação. Após a conclusão da implantação, você pode selecionar Fixar no painel, que cria um bloco para esse serviço no painel do portal do Azure como um atalho para a página Visão geral do serviço. Selecione Ir para recurso para abrir a página Visão geral do serviço.

   

3.1. Inicie sessão no portal do Azure

Vá para o portal do Azure e insira suas credenciais para entrar no portal. A vista predefinida é o dashboard de serviço.

3.2. Criar uma instância do Azure Spring Apps

Use as seguintes etapas para criar uma instância de serviço do Azure Spring Apps:

1. Selecione Criar um recurso no canto do portal do Azure.

2. Selecione Compute>Azure Spring Apps.

3. Preencha o formulário Noções básicas com as seguintes informações.

   Use a tabela a seguir como um guia para preencher o formulário. O plano recomendado é Standard consumption & dedicated (preview).

   Definição	Valor sugerido	Description
   Subscrição	o nome da subscrição	A subscrição do Azure que quer utilizar para o servidor. Se tiver várias subscrições, escolha a subscrição na qual pretende ser cobrado pelo recurso.
   Grupo de recursos	myresourcegroup	Um nome de grupo de recursos novo ou um já existente na sua subscrição.
   Nome	Miasa	Um nome exclusivo que identifica seu serviço Azure Spring Apps. O nome deve ter entre 4 e 32 caracteres e pode conter apenas letras minúsculas, números e hífenes. O primeiro caractere do nome do serviço deve ser uma letra e o último caractere deve ser uma letra ou um número.
   Planear	Consumo padrão e dedicado (pré-visualização)	O plano de preços determina o recurso e o custo associados à sua instância.
   País/Região	A região mais próxima dos seus utilizadores	A localização que esteja mais próxima dos seus utilizadores.
   Ambiente de aplicativos de contêiner	Myacaenv	O ambiente é um limite seguro em torno de um ou mais aplicativos de contêiner que podem se comunicar entre si e compartilhar uma rede virtual, registro em log e configuração de Dapr.

4. (Opcional) Crie um ambiente de aplicativos de contêiner.

   • Carga de trabalho de consumo
   • Carga de trabalho dedicada

   1. Preencha a guia Noções básicas com as seguintes informações:

      • Nome do ambiente: myacaenv
      • Plano: Consumo
      • Redundância de zona: Desativado

   2. Selecione Criar para criar o Ambiente de Aplicativos de Contêiner.

5. Selecione Rever e Criar para rever as suas seleções. Selecione Criar para provisionar a instância do Azure Spring Apps.

6. Na barra de ferramentas, selecione o ícone Notificações (um sino) para monitorizar o processo de implementação. Depois que a implantação for concluída, você poderá selecionar Fixar no painel, que cria um bloco para esse serviço no painel do portal do Azure como um atalho para a página Visão geral do serviço.

   

7. Selecione Ir para o recurso para ir para a página Visão Geral do Azure Spring Apps.

Use as seguintes etapas para criar os recursos necessários:

1. Use o comando a seguir para entrar no Azure com OAuth2. Ignore este passo se já tiver iniciado sessão.

   azd auth login
   

   O console emite mensagens semelhantes ao exemplo a seguir:

   Logged in to Azure.
   

2. Use o seguinte comando para provisionar a infraestrutura do modelo no Azure:

   azd provision
   

   A lista a seguir descreve as interações de comando:

   • Selecione uma Assinatura do Azure para usar: use as setas para mover, digite para filtrar e pressione Enter.
   • Selecione um local do Azure para usar: use as setas para mover, digite para filtrar e pressione Enter.

   O console emite mensagens semelhantes ao exemplo a seguir:

   SUCCESS: Your application was provisioned in Azure in xx minutes xx seconds.
   You can view the resources created under the resource group rg-<your-environment-name>-<random-string>> in Azure Portal:
   https://portal.azure.com/#@/resource/subscriptions/<your-subscription-id>/resourceGroups/rg-<your-environment-name>/overview
   

   Nota

   Isso pode demorar um pouco para ser concluído. Você verá um indicador de progresso à medida que provisiona recursos do Azure.

O botão Implantar no Azure na seção anterior inicia uma experiência de portal do Azure que inclui a implantação de aplicativos, portanto, nada mais é necessário.

Use as seguintes etapas para implantar usando o plug-in Maven para Azure Spring Apps:

1. Navegue até o diretório completo e execute o seguinte comando para configurar o aplicativo no Azure Spring Apps:

   ./mvnw com.microsoft.azure:azure-spring-apps-maven-plugin:1.19.0:config
   

   A lista a seguir descreve as interações de comando:

   • Login OAuth2: você precisa autorizar o logon no Azure com base no protocolo OAuth2.
   • Selecionar assinatura: selecione o número da lista de assinaturas da instância do Azure Spring Apps que você criou, que assume como padrão a primeira assinatura na lista. Se você usar o número padrão, pressione Enter diretamente.
   • Usar aplicativos Azure Spring existentes no Azure: pressione y para usar a instância existente do Azure Spring Apps.
   • Selecione Azure Spring Apps para implantação: selecione o número da lista da instância do Azure Spring Apps que você criou. Se você usar o número padrão, pressione Enter diretamente.
   • Usar aplicativo existente no Azure Spring Apps <your-instance-name>: pressione n para criar um novo aplicativo.
   • Insira o nome do aplicativo (demonstração): forneça um nome de aplicativo. Se você usar a ID de artefato de projeto padrão, pressione Enter diretamente.
   • Exponha o acesso público para este aplicativo (boot-for-azure): pressione y.
   • Confirme para salvar todas as configurações acima: Pressione y. Se você pressionar n, a configuração não será salva nos arquivos POM.

2. Use o seguinte comando para implantar o aplicativo:

   ./mvnw azure-spring-apps:deploy
   

   A lista a seguir descreve a interação de comando:

   • Login OAuth2: você precisa autorizar o logon no Azure com base no protocolo OAuth2.

   Depois que o comando for executado, você poderá ver nas seguintes mensagens de log que a implantação foi bem-sucedida:

   [INFO] Deployment(default) is successfully created
   [INFO] Starting Spring App after deploying artifacts...
   [INFO] Deployment Status: Running
   [INFO]   InstanceName:demo--default-xxxxxxx-xxxxxxxxx-xxxxx  Status:Running Reason:null       DiscoverStatus:NONE
   [INFO] Getting public url of app(demo)...
   [INFO] Application url: https://demo.<unique-identifier>.<region-name>.azurecontainerapps.io
   

Use as etapas a seguir para empacotar o aplicativo, provisionar os recursos do Azure exigidos pelo aplicativo Web e implantar no Azure Spring Apps:

1. Use o seguinte comando para empacotar uma cópia implantável do seu aplicativo:

   azd package
   

   O console emite mensagens semelhantes ao exemplo a seguir:

   SUCCESS: Your application was packaged for Azure in xx seconds.
   

2. Use o seguinte comando para implantar o código do aplicativo nesses recursos recém-provisionados:

   azd deploy
   

   O console emite mensagens semelhantes ao exemplo a seguir:

   Deploying services (azd deploy)
   
   (✓) Done: Deploying service demo
   - Endpoint: https://demo.xxx.<your-azure-location>.azurecontainerapps.io
   
   
   SUCCESS: Your application was deployed to Azure in xx minutes xx seconds.
   You can view the resources created under the resource group rg-<your-environment-name> in Azure Portal:
   https://portal.azure.com/#@/resource/subscriptions/<your-subscription-id>/resourceGroups/rg-<your-environment-name>/overview
   

O botão Implantar no Azure na próxima seção inicia uma experiência de portal do Azure que baixa um pacote JAR da página de lançamentos spring-cloud-azure-tools no GitHub. Não são necessárias etapas de preparação locais.

Use as seguintes etapas para preparar o projeto:

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

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

2. Use o seguinte comando para mover para a pasta do projeto:

   cd gs-spring-boot-for-azure/complete
   

3. Use o seguinte comando Maven para criar o projeto:

   ./mvnw clean package
   

4. Execute o projeto de exemplo localmente usando o seguinte comando:

   ./mvnw spring-boot:run
   

Use as etapas a seguir para inicializar o aplicativo a partir dos modelos da CLI do Desenvolvedor do Azure.

1. Abra um terminal, crie uma pasta vazia e altere o diretório para ela.

2. Use o seguinte comando para inicializar o projeto:

   azd init --template spring-guides/gs-spring-boot-for-azure
   

   A lista a seguir descreve as interações de comando:

   • Login OAuth2: você precisa autorizar o logon no Azure com base no protocolo OAuth2.
   • Insira um novo nome de ambiente: forneça um nome de ambiente, que é usado como um sufixo para o grupo de recursos criado para armazenar todos os recursos do Azure. Esse nome deve ser exclusivo em sua assinatura do Azure.

   O console emite mensagens semelhantes ao exemplo a seguir:

   Initializing a new project (azd init)
   
   (✓) Done: Initialized git repository
   (✓) Done: Downloading template code to: <your-local-path>
   Enter a new environment name: <your-env-name>
   SUCCESS: New project initialized!
   You can view the template code in your directory: <your-local-path>
   Learn more about running 3rd party code on our DevHub: https://aka.ms/azd-third-party-code-notice
   

Esta seção usa um botão Implantar no Azure para iniciar uma experiência de implantação no portal do Azure. Essa experiência usa um modelo ARM para criar recursos do Azure.

3.1. Inicie sessão no portal do Azure

Vá para o portal do Azure e insira suas credenciais para entrar no portal. A vista predefinida é o dashboard de serviço.

3.2. Criar recursos do Azure

Use as seguintes etapas para criar todos os recursos do Azure dos quais o aplicativo depende:

1. Selecione o seguinte botão Implantar no Azure para iniciar a experiência de implantação no portal do Azure:

   

2. Preencha o formulário na guia Noções básicas . Use a tabela a seguir como um guia para preencher o formulário:

   Definição	Valor sugerido	Description
   Subscrição	O nome da subscrição.	A subscrição do Azure que quer utilizar para o servidor. Se tiver várias subscrições, escolha a subscrição na qual pretende ser cobrado pelo recurso.
   Grupo de recursos	myresourcegroup	Um nome de grupo de recursos novo ou um já existente na sua subscrição.
   Região	A região mais próxima dos seus utilizadores.	A região é usada para criar o grupo de recursos.

3. Selecione Rever e Criar para rever as suas seleções. Em seguida, selecione Criar para implantar o aplicativo no Azure Spring Apps.

4. Na barra de ferramentas, selecione o ícone Notificações (um sino) para monitorizar o processo de implementação. Após a conclusão da implantação, você pode selecionar Fixar no painel, que cria um bloco para esse serviço no painel do portal do Azure como um atalho para a página Visão geral do serviço. Selecione Ir para recurso para abrir a página Visão geral do serviço.

   

3.1. Inicie sessão no portal do Azure

Abra seu navegador da Web e vá para o portal do Azure. Introduza as suas credenciais para iniciar sessão no portal. A vista predefinida é o dashboard de serviço.

3.2. Criar uma instância do Azure Spring Apps

Use as seguintes etapas para criar uma instância de serviço:

1. Selecione Criar um recurso no canto do portal do Azure.

2. Selecione Compute>Azure Spring Apps.

3. Preencha o formulário Básico com as seguintes informações:

   Definição	Valor sugerido	Description
   Subscrição	o nome da subscrição	A subscrição do Azure que quer utilizar para o servidor. Se tiver várias subscrições, escolha a subscrição na qual pretende ser cobrado pelo recurso.
   Grupo de recursos	myresourcegroup	Um nome de grupo de recursos novo ou um já existente na sua subscrição.
   Nome	Miasa	Um nome exclusivo que identifica seu serviço Azure Spring Apps. O nome deve ter entre 4 e 32 caracteres e pode conter apenas letras minúsculas, números e hífenes. O primeiro caractere do nome do serviço deve ser uma letra e o último caractere deve ser uma letra ou um número.
   Planear	Standard	O plano de preços que determina o recurso e o custo associados à sua instância.
   País/Região	A região mais próxima dos seus utilizadores	A localização que esteja mais próxima dos seus utilizadores.
   Redundância de Zona	não selecionado	Indica se o serviço Azure Spring Apps deve ser criado em uma zona de disponibilidade do Azure. Atualmente, esse recurso não é suportado em todas as regiões.

4. Selecione Rever e Criar para rever as suas seleções. Selecione Criar para provisionar a instância do Azure Spring Apps.

5. Na barra de ferramentas, selecione o ícone Notificações (um sino) para monitorizar o processo de implementação. Depois que a implantação for concluída, você poderá selecionar Fixar no painel, que cria um bloco para esse serviço no painel do portal do Azure como um atalho para a página Visão geral do serviço.

   

6. Selecione Ir para o recurso para ir para a página Visão Geral do Azure Spring Apps.

Use as seguintes etapas para criar os recursos necessários:

1. Use o comando a seguir para entrar no Azure com OAuth2. Ignore este passo se já tiver iniciado sessão.

   azd auth login
   

   O console emite mensagens semelhantes ao exemplo a seguir:

   Logged in to Azure.
   

2. Use o seguinte comando para definir o modelo usando o plano Padrão:

   azd env set PLAN standard
   

3. Use o seguinte comando para empacotar uma cópia implantável do seu aplicativo, provisionar a infraestrutura do modelo no Azure e implantar o código do aplicativo nesses recursos recém-provisionados:

   azd provision
   

   A lista a seguir descreve as interações de comando:

   • Selecione uma Assinatura do Azure para usar: use as setas para mover, digite para filtrar e pressione Enter.
   • Selecione um local do Azure para usar: use as setas para mover, digite para filtrar e pressione Enter.

   O console emite mensagens semelhantes às do exemplo a seguir:

   SUCCESS: Your application was provisioned in Azure in xx minutes xx seconds.
   You can view the resources created under the resource group rg-<your-environment-name>-<random-string>> in Azure Portal:
   https://portal.azure.com/#@/resource/subscriptions/<your-subscription-id>/resourceGroups/rg-<your-environment-name>/overview
   

   Nota

   Isso pode demorar um pouco para ser concluído. Você vê um indicador de progresso à medida que provisiona recursos do Azure.

O botão Implantar no Azure na seção anterior inicia uma experiência de portal do Azure que inclui a implantação de aplicativos, portanto, nada mais é necessário.

Use as seguintes etapas para implantar usando o plug-in Maven para Azure Spring Apps:

1. Navegue até o diretório completo e execute o seguinte comando para configurar o aplicativo no Azure Spring Apps:

   ./mvnw com.microsoft.azure:azure-spring-apps-maven-plugin:1.19.0:config
   

   A lista a seguir descreve as interações de comando:

   • Login OAuth2: você precisa autorizar o logon no Azure com base no protocolo OAuth2.
   • Selecionar assinatura: selecione o número da lista de assinaturas da instância do Azure Spring Apps que você criou, que assume como padrão a primeira assinatura na lista. Se você usar o número padrão, pressione Enter diretamente.
   • Usar aplicativos Azure Spring existentes no Azure: pressione y para usar a instância existente do Azure Spring Apps.
   • Selecione Azure Spring Apps para implantação: selecione o número da lista da instância do Azure Spring Apps que você criou. Se você usar o número padrão, pressione Enter diretamente.
   • Usar aplicativo existente no Azure Spring Apps <your-instance-name>: pressione n para criar um novo aplicativo.
   • Insira o nome do aplicativo (demonstração): forneça um nome de aplicativo. Se você usar a ID de artefato de projeto padrão, pressione Enter diretamente.
   • Exponha o acesso público para este aplicativo (boot-for-azure): pressione y.
   • Confirme para salvar todas as configurações acima: Pressione y. Se você pressionar n, a configuração não será salva nos arquivos POM.

2. Use o seguinte comando para implantar o aplicativo:

   ./mvnw azure-spring-apps:deploy
   

   A lista a seguir descreve a interação de comando:

   • Login OAuth2: você precisa autorizar o logon no Azure com base no protocolo OAuth2.

   Depois que o comando for executado, você poderá ver nas seguintes mensagens de log que a implantação foi bem-sucedida:

   [INFO] Deployment(default) is successfully created
   [INFO] Starting Spring App after deploying artifacts...
   [INFO] Deployment Status: Running
   [INFO]   InstanceName:demo-default-x-xxxxxxxxxx-xxxxx  Status:Running Reason:null       DiscoverStatus:UNREGISTERED
   [INFO]   InstanceName:demo-default-x-xxxxxxxxx-xxxxx  Status:Terminating Reason:null       DiscoverStatus:UNREGISTERED
   [INFO] Getting public url of app(demo)...
   [INFO] Application url: https://<your-Azure-Spring-Apps-instance-name>-demo.azuremicroservices.io
   

Use as etapas a seguir para empacotar o aplicativo, provisionar os recursos do Azure exigidos pelo aplicativo Web e implantar no Azure Spring Apps:

1. Use o seguinte comando para empacotar uma cópia implantável do seu aplicativo:

   azd package
   

   O console emite mensagens semelhantes ao exemplo a seguir:

   SUCCESS: Your application was packaged for Azure in xx seconds.
   

2. Use o seguinte comando para implantar o código do aplicativo nesses recursos recém-provisionados:

   azd deploy
   

   O console emite mensagens semelhantes às do exemplo a seguir:

   Deploying services (azd deploy)
   
   (✓) Done: Deploying service demo
   - Endpoint: https://<your-Azure-Spring-Apps-instance-name>-demo.azuremicroservices.io/
   
   
   SUCCESS: Your application was deployed to Azure in xx minutes xx seconds.
   You can view the resources created under the resource group rg-<your-environment-name> in Azure Portal:
   https://portal.azure.com/#@/resource/subscriptions/<your-subscription-id>/resourceGroups/rg-<your-environment-name>/overview
   

O botão Implantar no Azure na próxima seção inicia uma experiência de portal do Azure que baixa um pacote JAR da página de lançamentos spring-cloud-azure-tools no GitHub. Não são necessárias etapas de preparação locais.

Use as seguintes etapas para preparar o projeto:

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

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

2. Use o seguinte comando para mover para a pasta do projeto:

   cd gs-spring-boot-for-azure/complete
   

3. Use o seguinte comando Maven para criar o projeto:

   ./mvnw clean package
   

4. Execute o projeto de exemplo localmente usando o seguinte comando:

   ./mvnw spring-boot:run
   

Use as seguintes etapas para preparar o projeto:

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

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

2. Use o seguinte comando para mover para a pasta do projeto:

   cd gs-spring-boot-for-azure/complete
   

3. Use o seguinte comando Maven para criar o projeto:

   ./mvnw clean package
   

4. Execute o projeto de exemplo localmente usando o seguinte comando:

   ./mvnw spring-boot:run
   

Use as seguintes etapas para criar o projeto:

1. Use o seguinte comando para gerar um projeto de start.spring.io exemplo com as dependências recomendadas para o Azure Spring Apps:

   curl https://start.spring.io/starter.tgz -d dependencies=web -d baseDir=demo -d bootVersion=3.0.0 -d javaVersion=17 -d type=maven-project -d groupId=com.example -d artifactId=demo -d name=demo -d packageName=com.example.demo -d packaging=jar | tar -xzvf -
   

2. Crie um controlador web para sua aplicação web adicionando o arquivo src/main/java/com/example/demo/HelloController.java com o seguinte conteúdo:

   package com.example.demo;
   
   import org.springframework.web.bind.annotation.RestController;
   import org.springframework.web.bind.annotation.RequestMapping;
   
   @RestController
   public class HelloController {
   
       @RequestMapping("/")
       public String index() {
           return "Hello World";
        }
   }
   

3. Use o seguinte comando Maven para criar o projeto:

   ./mvnw clean package
   

4. Execute o projeto de exemplo localmente usando o seguinte comando:

   ./mvnw spring-boot:run
   

Para preparar o projeto Spring, siga as etapas na seção Antes de começar do Java no Azure Spring Apps.

Esta seção usa um botão Implantar no Azure para iniciar uma experiência de implantação no portal do Azure. Essa experiência usa um modelo ARM para criar recursos do Azure.

3.1. Inicie sessão no portal do Azure

Vá para o portal do Azure e insira suas credenciais para entrar no portal. A vista predefinida é o dashboard de serviço.

3.2. Criar recursos do Azure

Use as seguintes etapas para criar todos os recursos do Azure dos quais o aplicativo depende:

1. Selecione o seguinte botão Implantar no Azure para iniciar a experiência de implantação no portal do Azure:

   

2. Preencha o formulário na guia Noções básicas . Use a tabela a seguir como um guia para preencher o formulário:

   Definição	Valor sugerido	Description
   Subscrição	O nome da subscrição.	A subscrição do Azure que quer utilizar para o servidor. Se tiver várias subscrições, escolha a subscrição na qual pretende ser cobrado pelo recurso.
   Grupo de recursos	myresourcegroup	Um nome de grupo de recursos novo ou um já existente na sua subscrição.
   Região	A região mais próxima dos seus utilizadores.	A região é usada para criar o grupo de recursos.

3. Selecione Rever e Criar para rever as suas seleções. Em seguida, selecione Criar para implantar o aplicativo no Azure Spring Apps.

4. Na barra de ferramentas, selecione o ícone Notificações (um sino) para monitorizar o processo de implementação. Após a conclusão da implantação, você pode selecionar Fixar no painel, que cria um bloco para esse serviço no painel do portal do Azure como um atalho para a página Visão geral do serviço. Selecione Ir para recurso para abrir a página Visão geral do serviço.

   

3.1. Inicie sessão no portal do Azure

Vá para o portal do Azure e insira suas credenciais para entrar no portal. A vista predefinida é o dashboard de serviço.

3.2. Criar uma instância do Azure Spring Apps

Use as seguintes etapas para criar a instância de serviço:

1. Selecione Criar um recurso no canto do portal do Azure.

2. Selecione Compute>Azure Spring Apps.

3. Preencha o formulário Básico com as seguintes informações:

   Definição	Valor sugerido	Description
   Subscrição	O nome da subscrição.	A subscrição do Azure que quer utilizar para o servidor. Se tiver várias subscrições, escolha a subscrição na qual pretende ser cobrado pelo recurso.
   Grupo de recursos	myresourcegroup	Um nome de grupo de recursos novo ou um já existente na sua subscrição.
   Nome	Miasa	Um nome exclusivo que identifica seu serviço Azure Spring Apps. O nome deve ter entre 4 e 32 caracteres e pode conter apenas letras minúsculas, números e hífenes. 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	A região mais próxima dos seus utilizadores.	A localização que esteja mais próxima dos seus utilizadores.
   Opções e planos de hospedagem	Enterprise	O plano de preços que determina o recurso e o custo associados à sua instância.
   Zona redundante	não selecionado	A opção para criar seu serviço Azure Spring Apps em uma zona de disponibilidade do Azure. Atualmente, esse recurso não é suportado em todas as regiões.
   Plano IP de Software	Pay As You Go	O plano de preços que lhe permite pagar à medida que avança com as Aplicações Azure Spring.
   Implantar projeto de exemplo	não selecionado	A opção para usar o aplicativo de exemplo interno.

4. Selecione Rever e Criar para rever as suas seleções. Em seguida, selecione Criar para provisionar a instância do Azure Spring Apps.

5. Na barra de ferramentas, selecione o ícone Notificações (um sino) para monitorizar o processo de implementação. Após a conclusão da implantação, você pode selecionar Fixar no painel, que cria um bloco para esse serviço no painel do portal do Azure como um atalho para a página Visão geral do serviço.

   

6. Selecione Ir para o recurso para ir para a página Visão Geral do Azure Spring Apps.

3.1. Fornecer nomes para cada recurso

Crie variáveis para manter os nomes dos recursos usando os comandos a seguir. Certifique-se de substituir os espaços reservados pelos seus próprios valores.

export LOCATION="<region>"
export RESOURCE_GROUP="<resource-group-name>"
export SERVICE_NAME="<Azure-Spring-Apps-instance-name>"
export APP_NAME="demo"

3.2. Criar um novo grupo de recursos

Use as seguintes etapas para criar um novo grupo de recursos:

1. Use o seguinte comando para entrar na CLI do Azure:

   az login
   

2. Use o seguinte comando para definir o local padrão:

   az configure --defaults location=${LOCATION}
   

3. Use o comando a seguir para listar todas as assinaturas disponíveis para determinar a ID da assinatura a ser usada:

   az account list --output table
   

4. Use o seguinte comando para definir a assinatura padrão:

   az account set --subscription <subscription-ID>
   

5. Use o seguinte comando para criar um grupo de recursos:

   az group create --resource-group ${RESOURCE_GROUP}
   

6. Use o seguinte comando para definir o grupo de recursos recém-criado como o grupo de recursos padrão:

   az configure --defaults group=${RESOURCE_GROUP}
   

3.3. Instalar extensão e registrar namespace

Use os seguintes comandos para instalar a extensão Azure Spring Apps para a CLI do Azure e registrar o namespace: Microsoft.SaaS:

az extension add --name spring --upgrade
az provider register --namespace Microsoft.SaaS

3.4. Criar uma instância do Azure Spring Apps

Use as seguintes etapas para criar a instância de serviço:

1. Use o seguinte comando para aceitar os termos legais e as declarações de privacidade do plano Enterprise:

   Nota

   Esta etapa é necessária somente se sua assinatura nunca tiver sido usada para criar uma instância do plano Enterprise do Azure Spring Apps.

   az term accept \
       --publisher vmware-inc \
       --product azure-spring-cloud-vmware-tanzu-2 \
       --plan asa-ent-hr-mtr
   

2. Use o seguinte comando para criar uma instância de serviço do Azure Spring Apps:

   az spring create \
       --name ${SERVICE_NAME} \
       --sku Enterprise
   

3.5. Criar um aplicativo em sua instância do Azure Spring Apps

Um aplicativo é uma abstração de um aplicativo de negócios. Para obter mais informações, consulte Aplicativo e implantação no Azure Spring Apps. Os aplicativos são executados em uma instância de serviço do Azure Spring Apps, conforme mostrado no diagrama a seguir.

Use o seguinte comando para criar o aplicativo no Azure Spring Apps:

az spring app create \
    --service ${SERVICE_NAME} \
    --name ${APP_NAME} \
    --assign-endpoint true

3.1. Inicie sessão no portal do Azure

Abra seu navegador da Web e vá para o portal do Azure, insira suas credenciais e entre no portal. A vista predefinida é o dashboard de serviço.

3.2. Criar uma instância do Azure Spring Apps

Use as seguintes etapas para criar a instância de serviço:

1. Selecione Criar um recurso no canto do portal do Azure.

2. Selecione Compute>Azure Spring Apps.

3. Preencha o formulário Básico com as seguintes informações:

   Definição	Valor sugerido	Description
   Subscrição	O nome da subscrição.	A subscrição do Azure que quer utilizar para o servidor. Se tiver várias subscrições, escolha a subscrição na qual pretende ser cobrado pelo recurso.
   Grupo de recursos	myresourcegroup	Um nome de grupo de recursos novo ou um já existente na sua subscrição.
   Nome	Miasa	Um nome exclusivo que identifica seu serviço Azure Spring Apps. O nome deve ter entre 4 e 32 caracteres e pode conter apenas letras minúsculas, números e hífenes. 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	A região mais próxima dos seus utilizadores.	A localização que esteja mais próxima dos seus utilizadores.
   Opções e planos de hospedagem	Enterprise	O plano de preços que determina o recurso e o custo associados à sua instância.
   Zona redundante	não selecionado	A opção para criar seu serviço Azure Spring Apps em uma zona de disponibilidade do Azure. Atualmente, esse recurso não é suportado em todas as regiões.
   Plano IP de Software	Pay As You Go	O plano de preços que lhe permite pagar à medida que avança com as Aplicações Azure Spring.
   Implantar projeto de exemplo	não selecionado	A opção para usar o aplicativo de exemplo interno.

4. Selecione Rever e Criar para rever as suas seleções. Em seguida, selecione Criar para provisionar a instância do Azure Spring Apps.

5. Na barra de ferramentas, selecione o ícone Notificações (um sino) para monitorizar o processo de implementação. Após a conclusão da implantação, você pode selecionar Fixar no painel, que cria um bloco para esse serviço no painel do portal do Azure como um atalho para a página Visão geral do serviço.

   

6. Selecione Ir para o recurso para ir para a página Visão Geral do Azure Spring Apps.

Para criar uma instância do Azure Spring Apps, siga as etapas na seção Criar um aplicativo no Azure Spring Apps do Java no Azure Spring Apps.

O botão Implantar no Azure na seção anterior inicia uma experiência de portal do Azure que inclui a implantação de aplicativos, portanto, nada mais é necessário.

Use as seguintes etapas para implantar usando o plug-in Maven para Azure Spring Apps:

1. Navegue até o diretório completo e execute o seguinte comando para configurar o aplicativo no Azure Spring Apps:

   ./mvnw com.microsoft.azure:azure-spring-apps-maven-plugin:1.19.0:config
   

   A lista a seguir descreve as interações de comando:

   • Login OAuth2: você precisa autorizar o logon no Azure com base no protocolo OAuth2.
   • Selecionar assinatura: selecione o número da lista de assinaturas da instância do Azure Spring Apps que você criou, que assume como padrão a primeira assinatura na lista. Se você usar o número padrão, pressione Enter diretamente.
   • Usar aplicativos Azure Spring existentes no Azure: pressione y para usar a instância existente do Azure Spring Apps.
   • Selecione Azure Spring Apps para implantação: selecione o número da lista da instância do Azure Spring Apps que você criou. Se você usar o número padrão, pressione Enter diretamente.
   • Usar aplicativo existente no Azure Spring Apps <your-instance-name>: pressione n para criar um novo aplicativo.
   • Insira o nome do aplicativo (demonstração): forneça um nome de aplicativo. Se você usar a ID de artefato de projeto padrão, pressione Enter diretamente.
   • Exponha o acesso público para este aplicativo (boot-for-azure): pressione y.
   • Confirme para salvar todas as configurações acima: Pressione y. Se você pressionar n, a configuração não será salva nos arquivos POM.

2. Use o seguinte comando para implantar o aplicativo:

   ./mvnw azure-spring-apps:deploy
   

   A lista a seguir descreve a interação de comando:

   • Login OAuth2: você precisa autorizar o logon no Azure com base no protocolo OAuth2.

   Depois que o comando for executado, você poderá ver nas seguintes mensagens de log que a implantação foi bem-sucedida:

   [INFO] Deployment(default) is successfully created
   [INFO] Starting Spring App after deploying artifacts...
   [INFO] Deployment Status: Running
   [INFO]   InstanceName:demo-default-x-xxxxxxxxxx-xxxxx  Status:Running Reason:null       DiscoverStatus:N/A
   [INFO] Getting public url of app(demo)...
   [INFO] Application url: https://<your-Azure-Spring-Apps-instance-name>-demo.azuremicroservices.io
   

Use o seguinte comando para implantar o arquivo .jar para o aplicativo:

az spring app deploy \
    --service ${SERVICE_NAME} \
    --name ${APP_NAME} \
    --artifact-path target/demo-0.0.1-SNAPSHOT.jar

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

Esta seção fornece as etapas para implantar seu aplicativo no Azure Spring Apps.

4.1. Importar o projeto

Use as seguintes etapas para importar o projeto:

1. Abra o IntelliJ IDEA e selecione Abrir.

2. Na caixa de diálogo Abrir arquivo ou projeto, selecione a pasta de demonstração.

   

4.2. Crie e implante seu aplicativo

Use as seguintes etapas para criar e implantar seu aplicativo:

1. Se você ainda não instalou o Kit de Ferramentas do Azure para IntelliJ, siga as etapas em Instalar o Kit de Ferramentas do Azure para IntelliJ.

   Nota

   O Kit de Ferramentas do Azure para IntelliJ fornece quatro maneiras de fazer logon no Azure, e a implantação só pode começar depois de fazer logon.

2. Clique com o botão direito do mouse em seu projeto na janela Projeto IntelliJ e selecione Azure ->Deploy to Azure Spring Apps.

   

3. Aceite o nome do aplicativo no campo Nome . Nome refere-se à configuração, não ao nome do aplicativo. Normalmente, não é necessário alterá-lo.

4. Na caixa de texto Artefato , selecione Maven:demo(Java 17).

5. Na caixa de texto Subscrição, verifique se a subscrição está correta.

6. Na caixa de texto Spring Apps, selecione a instância do Azure Spring Apps que você criou.

7. Na caixa de texto Aplicativo , selecione o sinal de adição (+) para criar um novo aplicativo.

   

8. Na caixa de texto Nome do aplicativo: em Noções básicas do aplicativo, digite demonstração e selecione Mais configurações.

9. Selecione o botão Ativar ao lado de Ponto de extremidade Público. O botão muda para Desativar para ser ativado>.< Em seguida, selecione OK.

   

10. Em Antes de iniciar, selecione Run Maven Goal 'demo:package' e, em seguida, selecione o ícone de lápis para editar a linha de comando.

    

11. Na caixa de texto Linha de comando, digite -DskipTests após o pacote e selecione OK.

    

12. Para iniciar a implantação, selecione o botão Executar na parte inferior da caixa de diálogo Implantar no Azure . O plug-in executa o demo comando package -DskipTests Maven no aplicativo e implanta o arquivo .jar gerado pelo package comando.

A implantação do aplicativo pode levar alguns minutos. Você pode ver a URL pública do aplicativo no log do console de saída.

Para implantar o aplicativo no Azure Spring Apps, siga as etapas na seção Criar e implantar o aplicativo do Java no Azure Spring Apps.

Após a conclusão da implantação, localize a URL do aplicativo nas saídas de implantação. Use as seguintes etapas para validar:

1. Acesse a URL do aplicativo na página Saídas da Implantação. Quando você abre o aplicativo, você recebe a resposta Hello World.

   

2. Verifique os detalhes de cada implantação de recurso, que são úteis para investigar quaisquer problemas de implantação.

Após a conclusão da implantação, acesse o aplicativo com a URL do aplicativo de saída. Use as seguintes etapas para verificar os logs do aplicativo para investigar qualquer problema de implantação:

1. Acesse a URL do aplicativo de saída na página Saídas da Implantação. Quando você abre o aplicativo, você recebe a resposta Hello World.

   

2. No painel de navegação da página Visão geral da instância do Azure Spring Apps, selecione Logs para verificar os logs do aplicativo.

   

Após a conclusão da implantação, acesse o aplicativo com o ponto de extremidade de saída. Quando você abre o aplicativo, você recebe a resposta Hello World.

Após a conclusão da implantação, use as seguintes etapas para localizar a URL do aplicativo a partir das saídas de implantação:

1. Acesse a URL do aplicativo na página Saídas da Implantação. Quando você abre o aplicativo, você recebe a resposta Hello World.

   

2. Verifique os detalhes de cada implantação de recurso, que são úteis para investigar quaisquer problemas de implantação.

Após a conclusão da implantação, use as seguintes etapas para verificar os logs do aplicativo para investigar qualquer problema de implantação:

1. Acesse a URL do aplicativo na página Saídas da Implantação. Quando você abre o aplicativo, você recebe a resposta Hello World.

   

2. No painel de navegação da página de visão geral da instância do Azure Spring Apps, selecione Logs para verificar os logs do aplicativo.

   

Após a conclusão da implantação, acesse o aplicativo com o ponto de extremidade de saída. Quando você abre o aplicativo, você recebe a resposta Hello World.

Após a conclusão da implantação, use as seguintes etapas para localizar a URL do aplicativo a partir das saídas de implantação:

1. Acesse a URL do aplicativo na página Saídas da Implantação. Quando você abre o aplicativo, você recebe a resposta Hello World.

   

2. Verifique os detalhes de cada implantação de recurso, que são úteis para investigar quaisquer problemas de implantação.

Após a conclusão da implantação, use as seguintes etapas para validar o aplicativo:

1. Aceda ao URL da aplicação. Quando você abre o aplicativo, você recebe a resposta Hello World.

2. Verifique os logs do console, que são úteis para investigar quaisquer problemas de implantação.

Após a conclusão da implantação, use as seguintes etapas para verificar os logs do aplicativo para investigar qualquer problema de implantação:

1. Acesse o aplicativo com a URL do aplicativo de saída. Quando você abre o aplicativo, você recebe a resposta Hello World.

2. Use o seguinte comando para verificar o log do aplicativo para investigar qualquer problema de implantação:

   az spring app logs \
       --service ${SERVICE_NAME} \
       --name ${APP_NAME}
   

Use as seguintes etapas para transmitir os logs do aplicativo:

1. Acesse o aplicativo com a URL do aplicativo de saída. Quando você abre o aplicativo, você recebe a resposta Hello World.

2. Abra a janela do Azure Explorer , expanda o nó Azure, expanda o nó de serviço Azure Spring Apps, expanda a instância do Azure Spring Apps que você criou e selecione a instância de demonstração do aplicativo que você criou.

3. Clique com o botão direito do rato e selecione Iniciar Registos de Transmissão e, em seguida, selecione OK para ver os registos de aplicações em tempo real.

   

Use as seguintes etapas para transmitir os logs do aplicativo:

1. Acesse o aplicativo com a URL do aplicativo de saída. Quando você abre o aplicativo, você recebe a resposta Hello World.

2. Siga as etapas na seção Transmitir seus logs de aplicativos do Java no Azure Spring Apps.

Use as seguintes etapas para excluir todo o grupo de recursos, incluindo a instância de serviço recém-criada:

1. Localize o grupo de recursos no portal do Azure. No menu de navegação, selecione Grupos de recursos e, em seguida, selecione o nome do seu grupo de recursos.

2. Na página Grupo de recursos , selecione Excluir. Introduza o nome do seu grupo de recursos na caixa de texto para confirmar a eliminação e, em seguida, selecione Eliminar.

Use as seguintes etapas para excluir todo o grupo de recursos, incluindo a instância de serviço recém-criada:

1. Localize o grupo de recursos no portal do Azure. No menu de navegação, selecione Grupos de recursos e, em seguida, selecione o nome do seu grupo de recursos.

2. Na página Grupo de recursos , selecione Excluir. Introduza o nome do seu grupo de recursos na caixa de texto para confirmar a eliminação e, em seguida, selecione Eliminar.

Use o seguinte comando para excluir o grupo de recursos usando a CLI do Azure:

az group delete --name ${RESOURCE_GROUP}

Use as seguintes etapas para excluir o grupo de recursos usando o IntelliJ:

1. Vá para o seu Intellij IDEA e encontre o nome do seu grupo de recursos.

2. Clique com o botão direito do mouse no grupo de recursos e selecione Excluir para excluir todos os recursos relacionados do Azure.

Use as seguintes etapas para excluir o grupo de recursos usando o Visual Studio Code:

1. Vá para Visual Studio Code, selecione Agrupar por para habilitar Grupo por Grupo de Recursos e localize o nome do seu grupo de recursos.

2. Clique com o botão direito do mouse no grupo de recursos e selecione Excluir Grupo de Recursos... para excluir todos os recursos relacionados do Azure.

Use as seguintes etapas para excluir todo o grupo de recursos, incluindo a instância de serviço recém-criada:

1. Localize o grupo de recursos no portal do Azure. No menu de navegação, selecione Grupos de recursos e, em seguida, selecione o nome do seu grupo de recursos.

2. Na página Grupo de recursos , selecione Excluir. Introduza o nome do seu grupo de recursos na caixa de texto para confirmar a eliminação e, em seguida, selecione Eliminar.

Use as seguintes etapas para excluir todo o grupo de recursos, incluindo a instância de serviço recém-criada:

1. Localize o grupo de recursos no portal do Azure. No menu de navegação, selecione Grupos de recursos e, em seguida, selecione o nome do seu grupo de recursos.

2. Na página Grupo de recursos , selecione Excluir. Introduza o nome do seu grupo de recursos na caixa de texto para confirmar a eliminação e, em seguida, selecione Eliminar.

Use o seguinte comando para excluir todos os recursos do Azure usados neste aplicativo de exemplo:

azd down

A lista a seguir descreve a interação de comando:

• Total de recursos a eliminar: <seu-recursos-total>, tem a certeza de que pretende continuar?: Prima y.

O console emite mensagens semelhantes ao exemplo a seguir:

SUCCESS: Your application was removed from Azure in xx minutes xx seconds.