Início Rápido: Implantar um aplicativo controlado por evento nos Aplicativos Spring do Azure
Artigo
Observação
Os planos Básico, Standard e Enterprise serão preteridos a partir de meados de março de 2025, com um período de desativação de 3 anos. Recomendamos a transição para os Aplicativos de Contêiner do Azure. Para mais informações, confira o anúncio de desativação dos Aplicativos Spring do Azure.
Este artigo se aplica a:✅ Consumo padrão e dedicado (versão prévia) ✅ Basic/Standard ✅ Enterprise
Este artigo explica como implantar um aplicativo controlado por eventos do Spring Boot no Aplicativos Spring do Azure.
O projeto de exemplo é um aplicativo controlado por eventos que se inscreve em uma fila do Barramento de Serviço do Microsoft Azure com o nome lower-case e, em seguida, manipula a mensagem e envia outra mensagem para outra fila com o nome upper-case. Para tornar o aplicativo simples, o processamento de mensagens apenas converte a mensagem em maiúsculas. O diagrama a seguir descreve esse processo:
Este artigo fornece as seguintes opções para implantação em Aplicativos Spring do Azure:
A opção do portal do Azure é a maneira mais fácil e rápida de criar recursos e implantar aplicativos com um único clique. Essa opção é adequada para os desenvolvedores do Spring que desejam implantar rapidamente aplicativos nos serviços de nuvem do Azure.
A opção do portal do Microsoft Azure + plug-in do Maven fornece uma maneira mais convencional de criar recursos e implantar aplicativos passo a passo. Esta opção é adequada para os desenvolvedores do Spring que estão usando os serviços de nuvem do Azure pela primeira vez.
A opção do Azure Developer CLI é a maneira mais eficiente de criar recursos e implantar aplicativos automaticamente por meio de comandos simples. O Azure Developer CLI usa um modelo para provisionar os recursos do Azure necessários e implantar o código do aplicativo. Essa opção é adequada para os desenvolvedores do Spring que estão familiarizados com os serviços de nuvem do Azure.
A opção do portal do Azure é a maneira mais fácil e rápida de criar recursos e implantar aplicativos com apenas um clique. Essa opção é adequada para os desenvolvedores do Spring que desejam implantar rapidamente aplicativos nos serviços de nuvem do Azure.
A opção do portal do Microsoft Azure + plug-in do Maven fornece uma maneira mais convencional de criar recursos e implantar aplicativos passo a passo. Esta opção é adequada para os desenvolvedores do Spring que estão usando os serviços de nuvem do Azure pela primeira vez.
A opção CLI do Azure é uma ferramenta de linha de comando poderosa para gerenciar recursos do Azure. Essa opção é adequada para os desenvolvedores do Spring que estão familiarizados com os serviços de nuvem do Azure.
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:
O projeto de exemplo está pronto no GitHub. Clone o projeto de exemplo usando o seguinte comando:
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.
Abra um terminal, crie uma nova pasta vazia e navegue até ela.
Use o seguinte comando para inicializar o projeto:
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
3. Preparar o ambiente de nuvem
Os principais recursos que você precisa para executar este exemplo são uma instância dos Aplicativos Spring do Azure, um Azure Key Vault e uma instância do Barramento de Serviço do Azure. Siga as seguintes etapas para criar esses recursos.
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:
Selecione o botão Implantar no Azure para iniciar a experiência de implantação no portal do Azure:
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.
Selecione Revisar e criar para revisar suas seleções. Em seguida, selecione Criar para implantar o aplicativo nos Aplicativos Spring do Azure.
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:
Selecione Criar um recurso no canto do portal do Azure.
Na caixa de pesquisa Pesquisar serviços e o marketplace, procure e selecione barramento de serviço.
Na seção Barramento de Serviço , selecione Criar.
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.
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.
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.
Selecione Ir para o recurso para ir para a página Namespace do Barramento de Serviço .
Selecione Políticas de acesso compartilhado no menu de navegação e selecione RootManageSharedAccessKey.
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.
Selecione Filas no menu de navegação e selecione Fila.
Na página Criar Fila, insira letras minúsculas para Nome e selecione Criar.
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:
Selecione Criar um recurso no canto do portal.
Selecione Computação>Aplicativos Spring do Azure.
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.
(Opcional) Use as seguintes etapas para criar um Ambiente de Aplicativos de Contêiner:
Preencha a guia Básico com as seguintes informações:
Nome do ambiente: myacaenv
Plano: Consumo
Redundância de zona: Desabilitada
Selecione Criar para criar o Ambiente de Aplicativos de Contêiner.
Preencha a guia Básico com as seguintes informações:
Nome do ambiente: myacaenv
Plano: (versão prévia) Consumo e perfis de carga de trabalho dedicados
Redundância de zona: Desabilitada
Selecione a guia Perfis de carga de trabalho (versão prévia) e, em seguida, selecione Adicionar perfil de carga de trabalho para adicionar um perfil de carga de trabalho.
Na página Adicionar perfil de carga de trabalho (versão prévia), adicione as seguintes informações:
Nome do perfil de carga de trabalho: my-wlp
Tamanho do perfil de carga de trabalho: selecione Dedicado-D4
Intervalo de contagem de instâncias de dimensionamento automático: selecione 3 e 5
Selecione Adicionar. Essa seleção leva você de volta à página Adicionar perfil de carga de trabalho (versão prévia). Selecione my-wlp e, em seguida, selecione Criar para criar o Ambiente de Aplicativos de Contêiner.
Selecione Revisar e criar para revisar suas seleções. Selecione Criar para provisionar a instância do Aplicativos Spring do Azure.
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.
Selecione Ir para o recurso para ir para a página Visão geral dos Aplicativos Spring do Azure.
Selecione Aplicativos no menu de navegação esquerdo e, em seguida, selecione Criar Aplicativo.
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.
Selecione Criar para concluir a criação da instância dos Aplicativos Spring do Azure.
Após a criação do aplicativo, selecione o nome do aplicativo que você criou na etapa anterior.
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.
Selecione Salvar para salvar as propriedades da conexão.
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.
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.
4. Implantar o aplicativo em Aplicativos Spring 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.
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.
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.
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.
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
Observação
O senhor também pode usar azd up para combinar os três comandos anteriores: azd provision (provisiona recursos do Azure), azd package (empacota uma cópia implantável do seu aplicativo) e azd deploy (implanta o código do aplicativo). Para obter mais informações, confira Azure-Samples/ASA-Samples-Event-Driven-Application.
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:
O projeto de exemplo está pronto no GitHub. Clone o projeto de exemplo usando o seguinte comando:
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.
Abra um terminal, crie uma nova pasta vazia e navegue até ela.
Use o seguinte comando para inicializar o projeto:
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
3. Preparar o ambiente de nuvem
Os principais recursos necessários para executar esse exemplo são uma instância do Aplicativos Spring do Azure, uma instância do Azure Key Vault e uma instância do Barramento de Serviços do Azure. Siga as seguintes etapas para criar esses recursos.
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:
Selecione o botão Implantar no Azure para iniciar a experiência de implantação no portal do Azure:
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.
Selecione Revisar e criar para revisar suas seleções. Em seguida, selecione Criar para implantar o aplicativo nos Aplicativos Spring do Azure.
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:
Selecione Criar um recurso no canto do portal do Azure.
Na caixa de pesquisa Pesquisar serviços e o marketplace, procure e selecione barramento de serviço.
Na seção Barramento de Serviço , selecione Criar.
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.
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.
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.
Selecione Ir para o recurso para ir para a página Namespace do Barramento de Serviço .
Selecione Políticas de acesso compartilhado no menu de navegação e selecione RootManageSharedAccessKey.
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.
Selecione Filas no menu de navegação e selecione Fila.
Na página Criar Fila, insira letras minúsculas para Nome e selecione Criar.
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:
Selecione Criar um recurso no canto do portal do Azure.
Selecione Computação>Aplicativos Spring do Azure.
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.
Selecione Revisar e criar para revisar suas seleções. Selecione Criar para provisionar a instância do Aplicativos Spring do Azure.
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
Vá para a sua instância do Azure Spring Apps no portal do Azure.
Selecione Aplicativos no menu de navegação e, em seguida, selecione Criar Aplicativo.
Na página Criar Aplicativo , insira simple-event-driven-app para Nome do aplicativo e selecione Java 17 para Plataforma de runtime.
Após a criação do aplicativo, selecione o nome do aplicativo que você criou na etapa anterior.
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.
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.
Use o seguinte comando para definir o modelo usando o plano standard :
azd env set PLAN standard
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.
4. Implantar o aplicativo em Aplicativos Spring 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.
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.
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.
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.
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
Observação
O senhor também pode usar azd up para combinar os três comandos anteriores: azd provision (provisiona recursos do Azure), azd package (empacota uma cópia implantável do seu aplicativo) e azd deploy (implanta o código do aplicativo). Para obter mais informações, confira Azure-Samples/ASA-Samples-Event-Driven-Application.
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:
O projeto de exemplo está pronto no GitHub. Clone o projeto de exemplo usando o seguinte comando:
Construa o projeto de exemplo usando os comandos a seguir:
cd ASA-Samples-Event-Driven-Application
./mvnw clean package
3. Preparar o ambiente de nuvem
Os principais recursos necessários para executar esse exemplo são uma instância do Aplicativos Spring do Azure e uma instância do Barramento de Serviços do Azure. As seções a seguir descrevem como criar esses recursos.
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:
Selecione o botão Implantar no Azure para iniciar a experiência de implantação no portal do Azure:
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.
Selecione Revisar e criar para revisar suas seleções. Em seguida, selecione Criar para implantar o aplicativo nos Aplicativos Spring do Azure.
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:
Selecione Criar um recurso no canto do portal do Azure.
Na caixa de pesquisa Pesquisar serviços e o marketplace, procure e selecione barramento de serviço.
Na seção Barramento de Serviço , selecione Criar.
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.
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.
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.
Selecione Ir para o recurso para ir para a página Namespace do Barramento de Serviço .
Selecione Filas no menu de navegação e, em seguida, selecione Fila.
Na página Criar Fila, insira letras minúsculas para Nome e selecione Criar.
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:
Selecione Criar um recurso no canto do portal do Azure.
Selecione Computação>Aplicativos Spring do Azure.
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.
Selecione Revisar e criar para revisar suas seleções. Em seguida, selecione Criar para provisionar a instância dos Aplicativos Spring do Azure.
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 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:
Vá para a sua instância do Azure Spring Apps no portal do Azure.
No painel de navegação, abra o painel Aplicativos e selecione Criar Aplicativo.
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.
Selecione Criar para concluir a criação do aplicativo e selecione o aplicativo para exibir os detalhes.
Selecione Conector de serviço no painel de navegação e selecione Criar para criar uma nova conexão de serviço.
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.
Configure a guia Próximo: autenticação com as seguintes informações:
Observação
A Microsoft recomenda usar o fluxo de autenticação mais seguro disponível. O fluxo de autenticação descrito nesse procedimento, como para bancos de dados, caches, mensagens ou serviços de IA, exige um grau muito alto de confiança no aplicativo e traz riscos não presentes em outros fluxos. Use esse fluxo somente quando opções mais seguras, como identidades gerenciadas para conexões sem senha ou sem chave, não forem viáveis. Para operações de máquinas locais, prefira identidades de usuário para conexões sem senha ou sem chave.
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.
Selecione Avançar: Rede. Use a opção padrão Configurar regras de firewall para habilitar o acesso ao serviço de destino.
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.
Use as etapas a seguir para criar um novo grupo de recursos:
Use o seguinte comando para fazer logon na CLI do Azure:
az login
Use o seguinte comando para definir o local padrão:
az configure --defaults location=${LOCATION}
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
Use o comando a seguir para definir a assinatura padrão:
az account set --subscription <subscription-ID>
Use o comando a seguir para criar um grupo de recursos:
az group create --resource-group ${RESOURCE_GROUP}
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:
Use o comando a seguir para criar um namespace do Barramento de Serviço:
az servicebus namespace create --name ${SERVICE_BUS_NAME_SPACE}
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:
Obtenha a cadeia de conexão do Barramento de Serviço do Microsoft Azure usando o comando a seguir:
Observação
A Microsoft recomenda usar o fluxo de autenticação mais seguro disponível. O fluxo de autenticação descrito nesse procedimento, como para bancos de dados, caches, mensagens ou serviços de IA, exige um grau muito alto de confiança no aplicativo e traz riscos não presentes em outros fluxos. Use esse fluxo somente quando opções mais seguras, como identidades gerenciadas para conexões sem senha ou sem chave, não forem viáveis. Para operações de máquinas locais, prefira identidades de usuário para conexões sem senha ou sem chave.
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.
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.
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
5. Validar os aplicativos
Siga as etapas a seguir para confirmar se o aplicativo controlado por eventos funciona corretamente. Você pode validar o aplicativo enviando uma mensagem para a fila lower-case e confirmando que há uma mensagem na fila upper-case.
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.
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}
6. Limpar os recursos
Exclua os recursos que você criou neste artigo quando não precisar mais deles. Você pode excluir o grupo de recursos do Azure, que inclui todos os recursos no grupo de recursos.
Use as seguintes etapas para excluir todo o grupo de recursos, incluindo o serviço recém-criado:
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.
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:
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.
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:
Use as seguintes etapas para excluir todo o grupo de recursos, incluindo o serviço recém-criado:
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.
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:
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.
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.
