Início Rápido: Implantar um aplicativo controlado por evento nos Aplicativos Spring do Azure

• Uma assinatura do Azure. Caso você não tenha uma assinatura do Azure, crie uma conta gratuita do Azure antes de começar.

• Uma assinatura do Azure. Caso você não tenha uma assinatura do Azure, crie uma conta gratuita do Azure antes de começar.
• Git.
• Kit de Desenvolvimento Java (JDK), versão 17.

• Uma assinatura do Azure. Caso você não tenha uma assinatura do Azure, crie uma conta gratuita do Azure antes de começar.
• Git.
• Kit de Desenvolvimento Java (JDK), versão 17.
• Azure Developer CLI (AZD), versão 1.2.0 ou superior.

• Uma assinatura do Azure. Caso você não tenha uma assinatura do Azure, crie uma conta gratuita do Azure antes de começar.
• Se você estiver implantando uma instância de plano Enterprise do Aplicativos Spring do Azure pela primeira vez na assinatura de destino, confira a seção Requisitos em Exibir a oferta de camada Enterprise dos Aplicativos Spring do Azure no Azure Marketplace.

• Uma assinatura do Azure. Caso você não tenha uma assinatura do Azure, crie uma conta gratuita do Azure antes de começar.
• Se você estiver implantando uma instância de plano Enterprise do Aplicativos Spring do Azure pela primeira vez na assinatura de destino, confira a seção Requisitos em Exibir a oferta de camada Enterprise dos Aplicativos Spring do Azure no Azure Marketplace.
• Git.
• Kit de Desenvolvimento Java (JDK), versão 17.

• Uma assinatura do Azure. Caso você não tenha uma assinatura do Azure, crie uma conta gratuita do Azure antes de começar.
• Se você estiver implantando uma instância de plano Enterprise do Aplicativos Spring do Azure pela primeira vez na assinatura de destino, confira a seção Requisitos em Exibir a oferta de camada Enterprise dos Aplicativos Spring do Azure no Azure Marketplace.
• Git.
• Kit de Desenvolvimento Java (JDK), versão 17.
• CLI do Azure versão 2.45.0 ou superior.

O botão Implantar no Azure na próxima seção inicia uma experiência do portal do Azure que baixa um pacote JAR da página de versões do ASA-Samples-Web-Application no GitHub. Nenhuma etapa de preparação local é necessária.

Use as seguintes etapas para preparar o exemplo localmente:

1. O projeto de exemplo está pronto no GitHub. Clone o projeto de exemplo usando o seguinte comando:

   git clone https://github.com/Azure-Samples/ASA-Samples-Event-Driven-Application.git
   

2. Construa o projeto de exemplo usando os comandos a seguir:

   cd ASA-Samples-Event-Driven-Application
   ./mvnw clean package
   

Use as seguintes etapas para preparar o exemplo localmente. Essas etapas usam o AZD para inicializar o aplicativo controlado por eventos dos modelos de Azure Developer CLI.

1. Abra um terminal, crie uma nova pasta vazia e navegue até ela.

2. Use o seguinte comando para inicializar o projeto:

   azd init --template Azure-Samples/ASA-Samples-Event-Driven-Application
   

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

   • Insira um novo nome de ambiente: forneça um nome de ambiente, que é usado como um sufixo para o grupo de recursos criado para manter todos os recursos do Azure. Esse nome deve ser exclusivo em sua assinatura do Azure.

   O console gera 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 do ARM para criar recursos do Azure.

3.1. Entre no Portal do Azure

Acesse o portal do Azure e insira suas credenciais para entrar no portal. A exibição padrão é o painel 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 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 uma guia para concluir o formulário:

   Configuração	Valor sugerido	Descrição
   Assinatura	O nome da sua assinatura.	A assinatura do Azure que você deseja usar para o servidor. Caso você tenha várias assinaturas, escolha a assinatura na qual você deseja receber a cobrança do recurso.
   Grupo de recursos	myresourcegroup	Um novo nome do grupo de recursos ou um existente de sua assinatura.
   Região	A região mais próxima de seus usuários.	A região é usada para criar o grupo de recursos.

3. Selecione Revisar e criar para revisar suas seleções. Em seguida, selecione Criar para implantar o aplicativo nos Aplicativos Spring do Azure.

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

   

3.1. Entre no Portal do Azure

Abra seu navegador da Web e acesse o portal do Azure. Insira suas credenciais para entrar no portal. A exibição padrão é o painel de serviço.

3.2. Criar uma instância do Barramento de Serviço do Microsoft Azure

Use as etapas a seguir para criar uma instância de Barramento de Serviço:

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

2. Na caixa de pesquisa Pesquisar serviços e o marketplace, procure e selecione barramento de serviço.

3. Na seção Barramento de Serviço , selecione Criar.

4. Preencha o formulário na guia Noções básicas. Use a tabela a seguir como uma guia para concluir o formulário:

   Configuração	Valor sugerido	Descrição
   Assinatura	O nome da sua assinatura.	A assinatura do Azure que você deseja usar para o servidor. Caso você tenha várias assinaturas, escolha a assinatura na qual você deseja receber a cobrança do recurso.
   Grupo de recursos	myresourcegroup	Um novo nome do grupo de recursos ou um existente de sua assinatura.
   Nome do namespace	my-srvbus	Um nome exclusivo que identifica o serviço do Barramento de Serviço.
   Localidade	O local mais próximo de seus usuários.	A localização mais próxima dos usuários.
   Opções e planos de hospedagem	Basic	O plano de preços determina o recurso e o custo associados à sua instância.

5. Selecione Examinar e Criar para examinar os parâmetros de criação. Em seguida, selecione Criar para concluir a criação da instância do Barramento de Serviço.

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

   

7. Selecione Ir para o recurso para ir para a página Namespace do Barramento de Serviço .

8. Selecione Políticas de acesso compartilhado no menu de navegação e selecione RootManageSharedAccessKey.

9. Na página Política de SAS: RootManageSharedAccessKey, copie e salve o valor da Cadeia de Conexão Primária, que é usada para configurar conexões do aplicativo Spring.

10. Selecione Filas no menu de navegação e selecione Fila.

11. Na página Criar Fila, insira letras minúsculas para Nome e selecione Criar.

12. Crie outra fila repetindo a etapa anterior usando letras maiúsculas para Nome.

3.3. Criar uma instância do Azure Spring Apps

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

1. Selecione Criar um recurso no canto do portal.

2. Selecione Computação>Aplicativos Spring do Azure.

3. Preencha o formulário Consumo padrão e dedicado (versão prévia) com as seguintes informações:

   Configuração	Valor sugerido	Descrição
   Assinatura	O nome da sua assinatura	A assinatura do Azure que você deseja usar para o servidor. Caso você tenha várias assinaturas, escolha a assinatura na qual você deseja receber a cobrança do recurso.
   Grupo de recursos	myresourcegroup	Um novo nome do grupo de recursos ou um existente de sua assinatura.
   Nome	myasa	Um nome exclusivo que identifica o serviço Aplicativos Spring do Azure. 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.
   Plano	Consumo padrão e dedicado (versão prévia)	O plano de preços determina os recursos e o custo associados à sua instância.
   Região	A região mais próxima dos usuários	A localização mais próxima dos usuários.
   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 do Dapr.

4. (Opcional) Use as seguintes etapas para criar um Ambiente de Aplicativos de Contêiner:

   • Carga de trabalho de consumo
   • Carga de trabalho dedicada

   1. Preencha a guia Básico com as seguintes informações:

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

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

5. Selecione Revisar e criar para revisar suas seleções. Selecione Criar para provisionar a instância do Aplicativos Spring do Azure.

6. Na barra de ferramentas, selecione o ícone (sino) Notificações para monitorar o processo de implantação. Depois que a implantação estiver 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. A opção Ir para recurso abre a página Visão geral do servidor.

   

7. Selecione Ir para o recurso para ir para a página Visão geral dos Aplicativos Spring do Azure.

8. Selecione Aplicativos no menu de navegação esquerdo e, em seguida, selecione Criar Aplicativo.

9. Na página Criar Aplicativo, insira simple-event-driven-app para Nome do aplicativo e, em seguida, selecione Usar aplicativo de exemplo de início rápido para criar o aplicativo.

   

10. Selecione Criar para concluir a criação da instância dos Aplicativos Spring do Azure.

11. Após a criação do aplicativo, selecione o nome do aplicativo que você criou na etapa anterior.

12. Selecione Configuração no painel de navegação e configure a propriedade a seguir na guia Variáveis de ambiente.

    • SERVICE_BUS_CONNECTION_STRING: insira a cadeia de conexão primária do Barramento de Serviço.

    

13. Selecione Salvar para salvar as propriedades da conexão.

1. Use o seguinte comando para fazer logon no Azure com o OAuth2. Ignore esta etapa se você já tiver feito o logon.

   azd auth login
   

   O console gera mensagens semelhantes ao exemplo a seguir:

   Logged in to Azure.
   

2. Use o seguinte comando para provisionar a infraestrutura do modelo para o 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 gera 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
   

   Observação

   Esse comando pode demorar algum tempo para ser concluído. Você verá um indicador de progresso ao provisionar recursos do Azure.

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

Use as etapas a seguir para implantar usando o plug-in Maven para Aplicativos Spring do Azure:

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

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

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

   • Logon do OAuth2: autorize a entrada no Azure com base no protocolo OAuth2.
   • Selecionar assinatura: selecione o número da lista de assinaturas da instância dos Aplicativos Spring do Azure que você criou, que usa como padrão a primeira assinatura na lista. Se você usar o número padrão, pressione Enter diretamente.
   • Usar o Aplicativos Spring do Azure existente: pressione S para usar a instância existente do Aplicativos Spring do Azure.
   • Selecionar os Aplicativos Spring do Azure para implantação: selecione o número da lista da instância dos Aplicativos Spring do Azure que você criou. Se você usar o número padrão, pressione Enter diretamente.
   • Use o aplicativo existente no Aplicativos Spring do Azure <nome da sua instância>: pressione S para usar o aplicativo criado.
   • Confirme para salvar todas as configurações acima: pressione S. 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:

   • Logon do OAuth2: autorize a entrada no Azure com base no protocolo OAuth2.

   Depois que o comando for executado, você poderá pelas 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
   

Use as etapas a seguir para usar AZD para empacotar o aplicativo, provisionar os recursos do Azure exigidos pelo aplicativo Web e, em seguida, implantar em Aplicativos Spring do Azure.

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

   azd package
   

   O console gera 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 gera mensagens semelhantes ao exemplo a seguir:

   Deploying services (azd deploy)
   
   (✓) Done: Deploying service simple-event-driven-app
   - No endpoints were found
   
   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 do portal do Azure que baixa um pacote JAR da página de versões do ASA-Samples-Web-Application no GitHub. Nenhuma etapa de preparação local é necessária.

Use as seguintes etapas para preparar o exemplo localmente:

1. O projeto de exemplo está pronto no GitHub. Clone o projeto de exemplo usando o seguinte comando:

   git clone https://github.com/Azure-Samples/ASA-Samples-Event-Driven-Application.git
   

2. Construa o projeto de exemplo usando os comandos a seguir:

   cd ASA-Samples-Event-Driven-Application
   ./mvnw clean package
   

Use as seguintes etapas para preparar o exemplo localmente. Essas etapas usam o AZD para inicializar o aplicativo controlado por eventos dos modelos de Azure Developer CLI.

1. Abra um terminal, crie uma nova pasta vazia e navegue até ela.

2. Use o seguinte comando para inicializar o projeto:

   azd init --template Azure-Samples/ASA-Samples-Event-Driven-Application
   

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

   • Insira um novo nome de ambiente: forneça um nome de ambiente, que é usado como um sufixo para o grupo de recursos criado para manter todos os recursos do Azure. Esse nome deve ser exclusivo em sua assinatura do Azure.

   O console gera 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 do ARM para criar recursos do Azure.

3.1. Entre no Portal do Azure

Acesse o portal do Azure e insira suas credenciais para entrar no portal. A exibição padrão é o painel 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 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 uma guia para concluir o formulário:

   Configuração	Valor sugerido	Descrição
   Assinatura	O nome da sua assinatura.	A assinatura do Azure que você deseja usar para o servidor. Caso você tenha várias assinaturas, escolha a assinatura na qual você deseja receber a cobrança do recurso.
   Grupo de recursos	myresourcegroup	Um novo nome do grupo de recursos ou um existente de sua assinatura.
   Região	A região mais próxima de seus usuários.	A região é usada para criar o grupo de recursos.

3. Selecione Revisar e criar para revisar suas seleções. Em seguida, selecione Criar para implantar o aplicativo nos Aplicativos Spring do Azure.

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

   

3.1. Entre no Portal do Azure

Abra seu navegador da Web e acesse o portal do Azure. Insira suas credenciais para entrar no portal. A exibição padrão é o painel de serviço.

3.2. Criar uma instância do Barramento de Serviço do Microsoft Azure

Use as etapas a seguir para criar uma instância de Barramento de Serviço:

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

2. Na caixa de pesquisa Pesquisar serviços e o marketplace, procure e selecione barramento de serviço.

3. Na seção Barramento de Serviço , selecione Criar.

4. Preencha o formulário na guia Noções básicas. Use a tabela a seguir como uma guia para concluir o formulário:

   Configuração	Valor sugerido	Descrição
   Assinatura	O nome da sua assinatura.	A assinatura do Azure que você deseja usar para o servidor. Caso você tenha várias assinaturas, escolha a assinatura na qual você deseja receber a cobrança do recurso.
   Grupo de recursos	myresourcegroup	Um novo nome do grupo de recursos ou um existente de sua assinatura.
   Nome do namespace	my-srvbus	Um nome exclusivo que identifica o serviço do Barramento de Serviço.
   Localidade	O local mais próximo de seus usuários.	A localização mais próxima dos usuários.
   Opções e planos de hospedagem	Basic	O plano de preços determina o recurso e o custo associados à sua instância.

5. Selecione Examinar e Criar para examinar os parâmetros de criação. Em seguida, selecione Criar para concluir a criação da instância do Barramento de Serviço.

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

   

7. Selecione Ir para o recurso para ir para a página Namespace do Barramento de Serviço .

8. Selecione Políticas de acesso compartilhado no menu de navegação e selecione RootManageSharedAccessKey.

9. Na página Política de SAS: RootManageSharedAccessKey, copie e salve o valor da Cadeia de Conexão Primária, que é usada para configurar conexões do aplicativo Spring.

10. Selecione Filas no menu de navegação e selecione Fila.

11. Na página Criar Fila, insira letras minúsculas para Nome e selecione Criar.

12. Crie outra fila repetindo a etapa anterior usando letras maiúsculas para Nome.

3.3. Criar uma instância do Azure Spring Apps

Use o seguinte comando para criar uma instância dos Aplicativos Spring do Azure:

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

2. Selecione Computação>Aplicativos Spring do Azure.

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

   Use a tabela a seguir como um guia para concluir o formulário. O Plano recomendado é o Standard.

   Configuração	Valor sugerido	Descrição
   Assinatura	O nome da sua assinatura	A assinatura do Azure que você deseja usar para o servidor. Caso você tenha várias assinaturas, escolha a assinatura na qual você deseja receber a cobrança do recurso.
   Grupo de recursos	myresourcegroup	Um novo nome do grupo de recursos ou um existente de sua assinatura.
   Nome	myasa	Um nome exclusivo que identifica o serviço Aplicativos Spring do Azure. 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.
   Plano	Standard	O plano determina o recurso e o custo associados à instância.
   Região	A região mais próxima dos usuários	A localização mais próxima dos usuários.
   Com Redundância de Zona	Não selecionado	Se o serviço do Aplicativos Spring do Azure deve ser criado em uma zona de disponibilidade do Azure, ele só pode ter suporte em várias regiões no momento.

4. Selecione Revisar e criar para revisar suas seleções. Selecione Criar para provisionar a instância do Aplicativos Spring do Azure.

5. Na barra de ferramentas, selecione o ícone (sino) Notificações para monitorar o processo de implantação. Quando a implantação estiver 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. A opção Ir para recurso abre a página Visão geral do servidor.

   

3.4. Conectar a instância do aplicativo à instância do Barramento de Serviço

1. Vá para a sua instância do Azure Spring Apps no portal do Azure.

2. Selecione Aplicativos no menu de navegação e, em seguida, selecione Criar Aplicativo.

3. Na página Criar Aplicativo , insira simple-event-driven-app para Nome do aplicativo e selecione Java 17 para Plataforma de runtime.

   

4. Após a criação do aplicativo, selecione o nome do aplicativo que você criou na etapa anterior.

5. Na página Configuração, selecione a guia Variáveis de ambiente, insiraSERVICE_BUS_CONNECTION_STRING para Chave, cole a cadeia de conexão do Barramento de Serviço para Valor e selecione Salvar.

   

1. Use o seguinte comando para entrar no Azure com OAuth2. Ignore esta etapa se você já tiver feito o logon.

   azd auth login
   

   O console gera mensagens semelhantes ao exemplo a seguir:

   Logged in to Azure.
   

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

   azd env set PLAN standard
   

3. Use o seguinte comando para empacotar uma cópia implantável do 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 gera 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> in Azure Portal:
   https://portal.azure.com/#@/resource/subscriptions/<your-subscription-id>/resourceGroups/rg-<your-environment-name>/overview
   

   Observação

   Esse comando pode demorar algum tempo para ser concluído. Você verá um indicador de progresso ao provisionar recursos do Azure.

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

Use as etapas a seguir para implantar usando o plug-in Maven para Aplicativos Spring do Azure:

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

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

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

   • Logon do OAuth2: autorize a entrada no Azure com base no protocolo OAuth2.
   • Selecionar assinatura: selecione o número da lista de assinaturas da instância dos Aplicativos Spring do Azure que você criou, que usa como padrão a primeira assinatura na lista. Se você usar o número padrão, pressione Enter diretamente.
   • Usar o Aplicativos Spring do Azure existente: pressione S para usar a instância existente do Aplicativos Spring do Azure.
   • Selecionar os Aplicativos Spring do Azure para implantação: selecione o número da lista da instância dos Aplicativos Spring do Azure que você criou. Se você usar o número padrão, pressione Enter diretamente.
   • Use o aplicativo existente no Aplicativos Spring do Azure <nome da sua instância>: pressione S para usar o aplicativo criado.
   • Confirme para salvar todas as configurações acima: pressione S. 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:

   • Logon do OAuth2: autorize a entrada no Azure com base no protocolo OAuth2.

   Depois que o comando for executado, você poderá pelas 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
   

Use as etapas a seguir para usar AZD para empacotar o aplicativo, provisionar os recursos do Azure exigidos pelo aplicativo Web e, em seguida, implantar em Aplicativos Spring do Azure.

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

   azd package
   

   O console gera 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 gera mensagens semelhantes ao exemplo a seguir:

   Deploying services (azd deploy)
   
   (✓) Done: Deploying service simple-event-driven-app
   - No endpoints were found
   
   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 do portal do Azure que baixa um pacote JAR da página de versões do ASA-Samples-Web-Application no GitHub. Nenhuma etapa de preparação local é necessária.

Use as seguintes etapas para preparar o exemplo localmente:

1. O projeto de exemplo está pronto no GitHub. Clone o projeto de exemplo usando o seguinte comando:

   git clone https://github.com/Azure-Samples/ASA-Samples-Event-Driven-Application.git
   

2. Construa o projeto de exemplo usando os comandos a seguir:

   cd ASA-Samples-Event-Driven-Application
   ./mvnw clean package
   

Use as seguintes etapas para preparar o exemplo localmente:

1. O projeto de exemplo está pronto no GitHub. Clone o projeto de exemplo usando o seguinte comando:

   git clone https://github.com/Azure-Samples/ASA-Samples-Event-Driven-Application.git
   

2. Construa o projeto de exemplo usando os comandos a seguir:

   cd ASA-Samples-Event-Driven-Application
   ./mvnw clean package
   

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 do ARM para criar recursos do Azure.

3.1. Entre no Portal do Azure

Acesse o portal do Azure e insira suas credenciais para entrar no portal. A exibição padrão é o painel 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 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 uma guia para concluir o formulário:

   Configuração	Valor sugerido	Descrição
   Assinatura	O nome da sua assinatura.	A assinatura do Azure que você deseja usar para o servidor. Caso você tenha várias assinaturas, escolha a assinatura na qual você deseja receber a cobrança do recurso.
   Grupo de recursos	myresourcegroup	Um novo nome do grupo de recursos ou um existente de sua assinatura.
   Região	A região mais próxima de seus usuários.	A região é usada para criar o grupo de recursos.

3. Selecione Revisar e criar para revisar suas seleções. Em seguida, selecione Criar para implantar o aplicativo nos Aplicativos Spring do Azure.

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

   

3.1. Entre no Portal do Azure

Acesse o portal do Azure e insira suas credenciais para entrar no portal. A exibição padrão é o painel de serviço.

3.2. Criar uma instância do Barramento de Serviço do Microsoft Azure

Use as etapas a seguir para criar uma instância de Barramento de Serviço:

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

2. Na caixa de pesquisa Pesquisar serviços e o marketplace, procure e selecione barramento de serviço.

3. Na seção Barramento de Serviço , selecione Criar.

4. Preencha o formulário na guia Noções básicas. Use a tabela a seguir como uma guia para concluir o formulário:

   Configuração	Valor sugerido	Descrição
   Assinatura	O nome da sua assinatura.	A assinatura do Azure que você deseja usar para o servidor. Caso você tenha várias assinaturas, escolha a assinatura na qual você deseja receber a cobrança do recurso.
   Grupo de recursos	myresourcegroup	Um novo nome do grupo de recursos ou um existente de sua assinatura.
   Nome do namespace	my-srvbus	Um nome exclusivo que identifica o serviço do Barramento de Serviço.
   Localidade	O local mais próximo de seus usuários.	A localização mais próxima dos usuários.
   Opções e planos de hospedagem	Basic	O plano de preços determina o recurso e o custo associados à sua instância.

5. Selecione Examinar e Criar para examinar os parâmetros de criação. Em seguida, selecione Criar para concluir a criação da instância do Barramento de Serviço.

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

   

7. Selecione Ir para o recurso para ir para a página Namespace do Barramento de Serviço .

8. Selecione Filas no menu de navegação e, em seguida, selecione Fila.

9. Na página Criar Fila, insira letras minúsculas para Nome e selecione Criar.

10. Crie outra fila repetindo a etapa anterior usando letras maiúsculas para Nome.

3.3. Criar uma instância do Azure Spring Apps

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

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

2. Selecione Computação>Aplicativos Spring do Azure.

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

   Configuração	Valor sugerido	Descrição
   Assinatura	O nome da sua assinatura.	A assinatura do Azure que você deseja usar para o servidor. Caso você tenha várias assinaturas, escolha a assinatura na qual você deseja receber a cobrança do recurso.
   Grupo de recursos	myresourcegroup	Um novo nome do grupo de recursos ou um existente de sua assinatura.
   Nome	myasa	Um nome exclusivo que identifica o serviço Aplicativos Spring do Azure. 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	A região mais próxima de seus usuários.	A localização mais próxima dos usuários.
   Opções e planos de hospedagem	Empresa	O plano de preços determina os recursos e o custo associados à sua instância.
   Com Redundância de Zona	Não selecionado	A opção para criar o serviço do Aplicativos Spring do Azure em uma zona de disponibilidade do Azure. Atualmente, não há suporte para esse recurso em todas as regiões.
   Plano IP de software	Pago conforme o uso	O plano de preços que permite pagar conforme o uso do Aplicativos Spring do Azure.
   Implantar um projeto de exemplo	Não selecionado	A opção para usar o aplicativo de exemplo interno.

4. Selecione Revisar e criar para revisar suas seleções. Em seguida, selecione Criar para provisionar a instância dos Aplicativos Spring do Azure.

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

   

6. Selecione Ir para o recurso para ir para a página Visão geral dos Aplicativos Spring do Azure.

3.4. Conectar a instância do aplicativo à instância do Barramento de Serviço

Use as etapas a seguir para conectar as instâncias de serviço:

1. Vá para a sua instância do Azure Spring Apps no portal do Azure.

2. No painel de navegação, abra o painel Aplicativos e selecione Criar Aplicativo.

3. Na página Criar Aplicativo, para o nome do aplicativo, use aplicativo controlado por eventos simples e deixe todos os outros campos com seus valores padrão.

4. Selecione Criar para concluir a criação do aplicativo e selecione o aplicativo para exibir os detalhes.

5. Selecione Conector de serviço no painel de navegação e selecione Criar para criar uma nova conexão de serviço.

6. Preencha a guia Básico com as seguintes informações:

   • Tipo de serviço: selecione Barramento de Serviço.
   • Nome da conexão: preenchido com um nome gerado automaticamente que você pode modificar.
   • Assinatura: Selecione sua assinatura.
   • Namespace: selecione o namespace que você criou.
   • Tipo de cliente: selecione SpringBoot.

7. Configure a guia Próximo: autenticação com as seguintes informações:

   • Selecione o tipo de autenticação que você gostaria de usar entre o serviço de computação e o serviço de destino: selecione Cadeia de conexão.

8. Selecione Avançar: Rede. Use a opção padrão Configurar regras de firewall para habilitar o acesso ao serviço de destino.

9. Selecione Próximo: examinar e criar para examinar suas seleções e, em seguida, selecione Criar para criar a conexão.

3.1. Fornecer nomes para cada recurso

Crie variáveis para manter os nomes dos recursos usando os comandos a seguir. Substitua os espaços reservados pelos seus valores.

export RESOURCE_GROUP=<event-driven-app-resource-group-name>
export LOCATION=<desired-region>
export SERVICE_BUS_NAME_SPACE=<event-driven-app-service-bus-namespace>
export AZURE_SPRING_APPS_INSTANCE=<Azure-Spring-Apps-instance-name>
export APP_NAME=<event-driven-app-name>

3.2. Criar um novo grupo de recursos

Use as etapas a seguir para criar um novo grupo de recursos:

1. Use o seguinte comando para fazer logon 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 e determinar a ID de assinatura a ser usada:

   az account list --output table
   

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

   az account set --subscription <subscription-ID>
   

5. Use o comando a seguir 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 a extensão e registrar o namespace

Use os seguintes comandos para instalar a extensão dos Aplicativos Spring do Azure para a CLI do Azure e registrar o namespaces 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 o seguinte comando para criar uma instância dos Aplicativos Spring do Azure:

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

Em seguida, use o seguinte comando para criar um aplicativo na instância dos Aplicativos Spring do Azure:

az spring app create \
    --service ${AZURE_SPRING_APPS_INSTANCE} \
    --name ${APP_NAME}

3.5. Criar uma instância do Barramento de Serviço do Microsoft Azure

Use as etapas a seguir para criar uma instância de Barramento de Serviço:

1. Use o comando a seguir para criar um namespace do Barramento de Serviço:

   az servicebus namespace create --name ${SERVICE_BUS_NAME_SPACE}
   

2. Use os comandos a seguir para criar duas filas denominadas lower-case e upper-case:

   az servicebus queue create \
       --namespace-name ${SERVICE_BUS_NAME_SPACE} \
       --name lower-case
   az servicebus queue create \
       --namespace-name ${SERVICE_BUS_NAME_SPACE} \
       --name upper-case
   

3.6. Conectar a instância do aplicativo à instância do Barramento de Serviço

Agora você criou o Barramento de Serviços e o aplicativo no Aplicativos Spring do Azure, mas o aplicativo não pode se conectar ao Barramento de Serviços. Siga as etapas a seguir para permitir que o aplicativo se conecte ao Barramento de Serviço do Azure e, em seguida, implante o aplicativo:

1. Obtenha a cadeia de conexão do Barramento de Serviço do Microsoft Azure usando o comando a seguir:

   export SERVICE_BUS_CONNECTION_STRING=$( \
       az servicebus namespace authorization-rule keys list \
           --namespace-name ${SERVICE_BUS_NAME_SPACE} \
           --name RootManageSharedAccessKey \
           --query primaryConnectionString \
           --output tsv)
   

2. Utilize o comando a seguir para fornecer a cadeia de conexão ao aplicativo por meio de uma variável de ambiente:

   az spring app update \
       --service ${AZURE_SPRING_APPS_INSTANCE} \
       --name ${APP_NAME} \
       --env SPRING_CLOUD_AZURE_SERVICEBUS_CONNECTIONSTRING=${SERVICE_BUS_CONNECTION_STRING} \
             SPRING_CLOUD_AZURE_KEYVAULT_SECRET_PROPERTYSOURCEENABLED=false
   

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

Use as etapas a seguir para implantar usando o plug-in Maven para Aplicativos Spring do Azure:

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

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

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

   • Logon do OAuth2: autorize a entrada no Azure com base no protocolo OAuth2.
   • Selecionar assinatura: selecione o número da lista de assinaturas da instância dos Aplicativos Spring do Azure que você criou, que usa como padrão a primeira assinatura na lista. Se você usar o número padrão, pressione Enter diretamente.
   • Usar o Aplicativos Spring do Azure existente: pressione S para usar a instância existente do Aplicativos Spring do Azure.
   • Selecionar os Aplicativos Spring do Azure para implantação: selecione o número da lista da instância dos Aplicativos Spring do Azure que você criou. Se você usar o número padrão, pressione Enter diretamente.
   • Use o aplicativo existente no Aplicativos Spring do Azure <nome da sua instância>: pressione S para usar o aplicativo criado.
   • Confirme para salvar todas as configurações acima: pressione S. 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:

   • Logon do OAuth2: autorize a entrada no Azure com base no protocolo OAuth2.

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

   [INFO] Starting Spring App after deploying artifacts...
   [INFO] Deployment Status: Running
   

O ambiente de nuvem está pronto. Implante o aplicativo usando o comando a seguir:

az spring app deploy \
    --service ${AZURE_SPRING_APPS_INSTANCE} \
    --name ${APP_NAME} \
    --artifact-path target/simple-event-driven-app-0.0.2-SNAPSHOT.jar

1. Envie uma mensagem para a fila lower-case com o Service Bus Explorer. Para obter mais informações, confira a seção Enviar uma mensagem para uma fila ou tópico em Usar o Service Bus Explorer para executar operações de dados no Barramento de Serviços .

2. Confirme se há uma nova mensagem enviada para a fila upper-case. Para obter mais informações, consulte a seção Espiar uma mensagem em Usar o Service Bus Explorer para executar operações de dados no Barramento de Serviço.

3. Vá para a página Visão geral da instância dos Aplicativos Spring do Azure e selecione Logs para verificar os logs do aplicativo.

   

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

1. Envie uma mensagem para a fila lower-case com o Service Bus Explorer. Para obter mais informações, confira a seção Enviar uma mensagem para uma fila ou tópico em Usar o Service Bus Explorer para executar operações de dados no Barramento de Serviços .

2. Confirme se há uma nova mensagem enviada para a fila upper-case. Para obter mais informações, consulte a seção Espiar uma mensagem em Usar o Service Bus Explorer para executar operações de dados no Barramento de Serviço.

3. Vá para a página Visão geral da instância dos Aplicativos Spring do Azure e selecione Logs para verificar os logs do aplicativo.

   

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

1. Envie uma mensagem para a fila lower-case com o Service Bus Explorer. Para obter mais informações, confira a seção Enviar uma mensagem para uma fila ou tópico em Usar o Service Bus Explorer para executar operações de dados no Barramento de Serviços .

2. Confirme se há uma nova mensagem enviada para a fila upper-case. Para obter mais informações, consulte a seção Espiar uma mensagem em Usar o Service Bus Explorer para executar operações de dados no Barramento de Serviço.

3. Vá para a página Visão geral da instância dos Aplicativos Spring do Azure e selecione Logs para verificar os logs do aplicativo.

   

4. Use o seguinte comando para marcar o log do aplicativo para investigar problemas de implantação:

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

Use as seguintes etapas para excluir todo o grupo de recursos, incluindo o serviço recém-criado:

1. Encontre 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 do Grupo de recursos, selecione Excluir. Insira o nome do seu grupo de recursos na caixa de texto para confirmar a exclusão e selecione Excluir.

Use as seguintes etapas para excluir todo o grupo de recursos, incluindo o serviço recém-criado:

1. Encontre 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 do Grupo de recursos, selecione Excluir. Insira o nome do seu grupo de recursos na caixa de texto para confirmar a exclusão e selecione Excluir.

Use o comando a seguir para excluir todo o grupo de recursos, incluindo o serviço recém-criado:

az group delete --name ${RESOURCE_GROUP}

Use as seguintes etapas para excluir todo o grupo de recursos, incluindo o serviço recém-criado:

1. Encontre 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 do Grupo de recursos, selecione Excluir. Insira o nome do seu grupo de recursos na caixa de texto para confirmar a exclusão e selecione Excluir.

Use as seguintes etapas para excluir todo o grupo de recursos, incluindo o serviço recém-criado:

1. Encontre 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 do Grupo de recursos, selecione Excluir. Insira o nome do seu grupo de recursos na caixa de texto para confirmar a exclusão e selecione Excluir.

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

azd down

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

• Total de recursos a serem excluídos: <your-resources-total>, tem certeza de que deseja continuar?: Pressione s.
• Em vez disso, você gostaria de excluir permanentemente esses recursos, permitindo que seus nomes sejam reutilizados?: Pressione s. Pressione n se quiser reutilizar o Key Vault.

O console gera mensagens semelhantes ao exemplo a seguir:

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