Guia de início rápido: implantar um aplicativo controlado por eventos no Azure Spring Apps
Artigo
Nota
Os planos Basic, Standard e Enterprise serão preteridos a partir de meados de março de 2025, com um período de aposentadoria de 3 anos. Recomendamos a transição para os Aplicativos de Contêiner do Azure. Para obter mais informações, consulte o anúncio de aposentadoria do Azure Spring Apps.
O plano de consumo padrão e dedicado será preterido a partir de 30 de setembro de 2024, com um desligamento completo após seis meses. Recomendamos a transição para os Aplicativos de Contêiner do Azure. Para obter mais informações, consulte Migrar consumo padrão e plano dedicado do Azure Spring Apps para Aplicativos de Contêiner do Azure.
Este artigo aplica-se a:✅ Consumo padrão e dedicado (Pré-visualização) ✅ Básico/Standard ✅ Enterprise
Este artigo explica como implantar um aplicativo controlado por eventos do Spring Boot no Azure Spring Apps.
O projeto de exemplo é um aplicativo controlado a eventos que se inscreve em uma fila do Service Bus chamada lower-casee, em seguida, manipula a mensagem e envia outra mensagem para outra fila chamada 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 no Azure Spring Apps:
A opção de 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 desenvolvedores do Spring que desejam implantar rapidamente aplicativos nos serviços de nuvem do Azure.
A opção de plug-in do portal do Azure + Maven é uma maneira mais convencional de criar recursos e implantar aplicativos passo a passo. Essa opção é adequada para desenvolvedores do Spring que usam os serviços de nuvem do Azure pela primeira vez.
A opção CLI do Desenvolvedor do Azure é uma maneira mais eficiente de criar recursos e implantar aplicativos automaticamente por meio de comandos simples. A CLI do Desenvolvedor do Azure usa um modelo para provisionar os recursos do Azure necessários e implantar o código do aplicativo. Essa opção é adequada para desenvolvedores do Spring que estão familiarizados com os serviços de nuvem do Azure.
A opção de 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 desenvolvedores do Spring que desejam implantar rapidamente aplicativos nos serviços de nuvem do Azure.
A opção de plug-in do portal do Azure + Maven é uma maneira mais convencional de criar recursos e implantar aplicativos passo a passo. Essa opção é adequada para desenvolvedores do Spring que usam os serviços de nuvem do Azure pela primeira vez.
A opção CLI do Azure usa uma poderosa ferramenta de linha de comando para gerenciar recursos do Azure. Essa opção é adequada para 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 de portal do Azure que baixa um pacote JAR da página de versões ASA-Samples-Web-Application no GitHub. Não são necessárias etapas de preparação locais.
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:
Crie o projeto de exemplo usando os seguintes comandos:
cd ASA-Samples-Event-Driven-Application
./mvnw clean package
Use as etapas a seguir para preparar o exemplo localmente. Estas etapas usam o AZD para inicializar o aplicativo controlado por eventos a partir dos modelos da CLI do Desenvolvedor do Azure.
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 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
3. Prepare o ambiente de nuvem
Os principais recursos necessários para executar este exemplo são uma instância do Azure Spring Apps, um Cofre da Chave do Azure e uma instância do Barramento de Serviço do Azure. Use as etapas a seguir 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 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:
Selecione o seguinte 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 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.
Selecione Rever e Criar para rever as suas seleções. Em seguida, selecione Criar para implantar o aplicativo no Azure Spring Apps.
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 Service Bus
Use as seguintes etapas para criar uma instância do Service Bus:
Selecione Criar um recurso no canto do portal do Azure.
Na caixa de pesquisa Serviços de pesquisa e marketplace, procure barramento de serviço.
Na seção Service Bus, selecione Criar.
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.
Nome do namespace
my-srvbus
Um nome exclusivo que identifica o serviço do Service Bus.
Location
A localização mais próxima dos seus utilizadores.
A localização que esteja mais próxima dos seus utilizadores.
Opções e planos de hospedagem
Básica
O plano de preços determina o recurso e o custo associados à sua instância.
Selecione Rever e Criar para rever os parâmetros de criação. Em seguida, selecione Criar para concluir a criação da instância do Service Bus.
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.
Selecione Ir para o recurso para ir para a página Namespace do Service Bus.
Selecione Políticas de acesso compartilhado no menu de navegação e, em seguida, selecione RootManageSharedAccessKey.
Na página Política SAS: RootManageSharedAccessKey, copie e salve o valor da Cadeia de Conexão Primária, que é usado para configurar conexões do aplicativo Spring.
Selecione Filas no menu de navegação e, em seguida, selecione Fila.
Na página Criar fila, digite minúsculas para Nome e selecione Criar.
Crie outra fila repetindo a etapa anterior usando maiúsculas para Name.
3.3. Criar uma instância do Azure Spring Apps
Use as seguintes etapas para criar a instância de serviço:
Selecione Criar um recurso no canto do portal.
Selecione Compute>Azure Spring Apps.
Preencha o formulário Consumo padrão e dedicado (visualização) 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
Consumo padrão e dedicado (pré-visualização)
O plano de preços determina os recursos e o custo associados à sua instância.
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.
(Opcional) Use as seguintes etapas para criar um ambiente de aplicativos de contêiner:
Preencha a guia Noções básicas com as seguintes informações:
Nome do ambiente: myacaenv
Plano: Consumo
Redundância de zona: Desativado
Selecione Criar para criar o Ambiente de Aplicativos de Contêiner.
Preencha a guia Noções básicas com as seguintes informações:
Nome do ambiente: myacaenv
Planejar: (Visualizar) Consumo e perfis de carga de trabalho dedicados
Redundância de zona: Desativado
Selecione a guia Perfis de carga de trabalho (Visualização) 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 (Visualização), adicione as seguintes informações:
Nome do perfil da carga de trabalho: my-wlp
Tamanho do perfil da carga de trabalho: Selecione Dedicado-D4
Intervalo de contagem de instâncias de dimensionamento automático: Selecione 3 e 5
Selecione Adicionar. Esta seleção leva você de volta à página Adicionar perfil de carga de trabalho (Visualização ). Selecione my-wlp e, em seguida, selecione Criar para criar o Ambiente de Aplicativos de Contêiner.
Selecione Rever e Criar para rever as suas seleções. Selecione Criar para provisionar a instância do Azure Spring Apps.
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. Selecionar Ir para recurso abre a página Visão geral do serviço.
Selecione Ir para o recurso para ir para a página Visão Geral do Azure Spring Apps.
Selecione Aplicações no menu de navegação esquerdo e, em seguida, selecione Criar Aplicação.
Na página Criar Aplicativo, digite simple-event-driven-app Nome do aplicativo e selecione Usar aplicativo de exemplo de início rápido para criar aplicativo.
Selecione Criar para concluir a criação da instância do Azure Spring Apps.
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 seguinte propriedade na guia Variáveis de ambiente.
SERVICE_BUS_CONNECTION_STRING: Insira a cadeia de conexão primária do Service Bus.
Selecione Salvar para salvar as propriedades da conexão.
Use o comando a seguir para fazer logon 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.
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
A conclusão deste comando poderá demorar algum tempo. 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.
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 y para usar o aplicativo criado.
Confirme para salvar todas as configurações acima: Pressione y. 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:
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
Use as etapas a seguir para usar o AZD para empacotar o aplicativo, provisionar os recursos do Azure exigidos pelo aplicativo Web e implantar no Azure Spring Apps.
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.
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 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
Nota
Você 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 (implanta azd deploy o código do aplicativo). Para obter mais informações, consulte Azure-Samples/ASA-Samples-Event-Driven-Application.
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 versões ASA-Samples-Web-Application no GitHub. Não são necessárias etapas de preparação locais.
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:
Crie o projeto de exemplo usando os seguintes comandos:
cd ASA-Samples-Event-Driven-Application
./mvnw clean package
Use as etapas a seguir para preparar o exemplo localmente. Estas etapas usam o AZD para inicializar o aplicativo controlado por eventos a partir dos modelos da CLI do Desenvolvedor do Azure.
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 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
3. Prepare o ambiente de nuvem
Os principais recursos necessários para executar este exemplo são uma instância do Azure Spring Apps, uma instância do Azure Key Vault e uma instância do Azure Service Bus. Use as etapas a seguir 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 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:
Selecione o seguinte 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 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.
Selecione Rever e Criar para rever as suas seleções. Em seguida, selecione Criar para implantar o aplicativo no Azure Spring Apps.
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 Service Bus
Use as seguintes etapas para criar uma instância do Service Bus:
Selecione Criar um recurso no canto do portal do Azure.
Na caixa de pesquisa Serviços de pesquisa e marketplace, procure barramento de serviço.
Na seção Service Bus, selecione Criar.
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.
Nome do namespace
my-srvbus
Um nome exclusivo que identifica o serviço do Service Bus.
Location
A localização mais próxima dos seus utilizadores.
A localização que esteja mais próxima dos seus utilizadores.
Opções e planos de hospedagem
Básica
O plano de preços determina o recurso e o custo associados à sua instância.
Selecione Rever e Criar para rever os parâmetros de criação. Em seguida, selecione Criar para concluir a criação da instância do Service Bus.
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.
Selecione Ir para o recurso para ir para a página Namespace do Service Bus.
Selecione Políticas de acesso compartilhado no menu de navegação e, em seguida, selecione RootManageSharedAccessKey.
Na página Política SAS: RootManageSharedAccessKey, copie e salve o valor da Cadeia de Conexão Primária, que é usado para configurar conexões do aplicativo Spring.
Selecione Filas no menu de navegação e, em seguida, selecione Fila.
Na página Criar fila, digite minúsculas para Nome e selecione Criar.
Crie outra fila repetindo a etapa anterior usando maiúsculas para Name.
3.3. Criar uma instância do Azure Spring Apps
Use as seguintes etapas para criar uma instância do Azure Spring Apps:
Selecione Criar um recurso no canto do portal do Azure.
Selecione Compute>Azure Spring Apps.
Preencha o formulário Básico com as seguintes informações:
Use a tabela a seguir como um guia para preencher o formulário. O plano recomendado é Standard.
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 determina o recurso e o custo associados à sua instância.
Região
A região mais próxima dos seus utilizadores
A localização que esteja mais próxima dos seus utilizadores.
Zona redundante
não selecionado
Se deseja criar seu serviço Azure Spring Apps em uma zona de disponibilidade do Azure, ele só pode ser suportado em várias regiões no momento.
Selecione Rever e Criar para rever as suas seleções. Selecione Criar para provisionar a instância do Azure Spring Apps.
Na barra de ferramentas, selecione o ícone Notificações (um sino) para monitorizar o processo de implementaçã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. Selecionar Ir para recurso abre a página Visão geral do serviço.
3.4. Conectar a instância do aplicativo à instância do Service Bus
Vá para sua instância do Azure Spring Apps no portal do Azure.
Selecione Aplicações no menu de navegação e, em seguida, selecione Criar Aplicação.
Na página Create App, insira simple-event-driven-app para Nome do aplicativo e selecione Java 17 for Runtime platform.
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, digite SERVICE_BUS_CONNECTION_STRING para Chave, cole a cadeia de conexão do Service Bus para Valor e selecione Salvar.
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.
Use o seguinte comando para definir o modelo usando o plano padrão :
azd env set PLAN standard
Use o comando a seguir 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 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
Nota
A conclusão deste comando poderá demorar algum tempo. É mostrado 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.
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 y para usar o aplicativo criado.
Confirme para salvar todas as configurações acima: Pressione y. 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:
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
Use as etapas a seguir para usar o AZD para empacotar o aplicativo, provisionar os recursos do Azure exigidos pelo aplicativo Web e implantar no Azure Spring Apps.
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.
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 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
Nota
Você 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 (implanta azd deploy o código do aplicativo). Para obter mais informações, consulte Azure-Samples/ASA-Samples-Event-Driven-Application.
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 versões ASA-Samples-Web-Application no GitHub. Não são necessárias etapas de preparação locais.
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:
Crie o projeto de exemplo usando os seguintes comandos:
cd ASA-Samples-Event-Driven-Application
./mvnw clean package
3. Prepare o ambiente de nuvem
Os principais recursos necessários para executar este exemplo são uma instância do Azure Spring Apps e uma instância do Azure Service Bus. 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 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:
Selecione o seguinte 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 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.
Selecione Rever e Criar para rever as suas seleções. Em seguida, selecione Criar para implantar o aplicativo no Azure Spring Apps.
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 Service Bus
Use as seguintes etapas para criar uma instância do Service Bus:
Selecione Criar um recurso no canto do portal do Azure.
Na caixa de pesquisa Serviços de pesquisa e marketplace, procure barramento de serviço.
Na seção Service Bus, selecione Criar.
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.
Nome do namespace
my-srvbus
Um nome exclusivo que identifica o serviço do Service Bus.
Location
A localização mais próxima dos seus utilizadores.
A localização que esteja mais próxima dos seus utilizadores.
Opções e planos de hospedagem
Básica
O plano de preços determina o recurso e o custo associados à sua instância.
Selecione Rever e Criar para rever os parâmetros de criação. Em seguida, selecione Criar para concluir a criação da instância do Service Bus.
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.
Selecione Ir para o recurso para ir para a página Namespace do Service Bus.
Selecione Filas no menu de navegação e, em seguida, selecione Fila.
Na página Criar fila, digite minúsculas para Nome e selecione Criar.
Crie outra fila repetindo a etapa anterior usando maiúsculas para Name.
3.3. Criar uma instância do Azure Spring Apps
Use as seguintes etapas para criar a instância de serviço:
Selecione Criar um recurso no canto do portal do Azure.
Selecione Compute>Azure Spring Apps.
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.
Selecione Rever e Criar para rever as suas seleções. Em seguida, selecione Criar para provisionar a instância do Azure Spring Apps.
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 o recurso para ir para a página Visão Geral do Azure Spring Apps.
3.4. Conectar a instância do aplicativo à instância do Service Bus
Use as seguintes etapas para conectar suas instâncias de serviço:
Vá para 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 simple-event-driven-app e deixe todos os outros campos com seus valores padrão.
Selecione Criar para concluir a criação do aplicativo e, em seguida, selecione o aplicativo para exibir os detalhes.
Selecione Service Connector no painel de navegação e, em seguida, selecione Criar para criar uma nova conexão de serviço.
Preencha a guia Noções básicas com as seguintes informações:
Tipo de serviço: Selecione Service Bus.
Nome da conexão: preenchido com um nome gerado automaticamente que você pode modificar.
Subscrição: selecione a sua subscrição.
Namespace: selecione o namespace que você criou.
Tipo de cliente: Selecione SpringBoot.
Configure a guia Next: Authentication com as seguintes informações:
Nota
A Microsoft recomenda o uso do fluxo de autenticação mais seguro disponível. O fluxo de autenticação descrito neste procedimento, como para bancos de dados, caches, mensagens ou serviços de IA, requer 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áquina local, prefira identidades de usuário para conexões sem senha ou sem chave.
Selecione o tipo de autenticação que você deseja usar entre o serviço de computação e o serviço de destino.: Selecione Cadeia de conexão.
Selecione Next: Networking. Use a opção padrão Configurar regras de firewall para habilitar o acesso ao serviço de destino.
Selecione Seguinte: Rever e Criar para rever as suas seleções e, em seguida, selecione Criar para criar a ligação.
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.
Use as seguintes etapas para criar um novo grupo de recursos:
Use o seguinte comando para entrar 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 para determinar a ID da assinatura a ser usada:
az account list --output table
Use o seguinte comando para definir a assinatura padrão:
az account set --subscription <subscription-ID>
Use o seguinte comando 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 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 Microsoft.SaaS namespace:
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 sua instância do Azure Spring Apps:
az spring create \
--name ${AZURE_SPRING_APPS_INSTANCE} \
--sku Enterprise
Em seguida, use o seguinte comando para criar um aplicativo na instância do Azure Spring Apps:
az spring app create \
--service ${AZURE_SPRING_APPS_INSTANCE} \
--name ${APP_NAME}
3.5. Criar uma instância do Service Bus
Use as seguintes etapas para criar uma instância do Service Bus:
Use o seguinte comando para criar um namespace do Service Bus:
az servicebus namespace create --name ${SERVICE_BUS_NAME_SPACE}
Use os seguintes comandos 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 Service Bus
Agora você criou o Service Bus e o aplicativo no Azure Spring Apps, mas o aplicativo não pode se conectar ao Service Bus. Use as seguintes etapas para permitir que o aplicativo se conecte ao Service Bus e implante o aplicativo:
Obtenha a cadeia de conexão do Service Bus usando o seguinte comando:
Nota
A Microsoft recomenda o uso do fluxo de autenticação mais seguro disponível. O fluxo de autenticação descrito neste procedimento, como para bancos de dados, caches, mensagens ou serviços de IA, requer 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áquina local, 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 de portal do Azure que inclui a implantação de aplicativos, portanto, nada mais é necessário.
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 y para usar o aplicativo criado.
Confirme para salvar todas as configurações acima: Pressione y. 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:
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] Starting Spring App after deploying artifacts...
[INFO] Deployment Status: Running
O ambiente de nuvem agora está pronto. Implante o aplicativo usando o seguinte comando:
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. Valide o aplicativo
Use 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, em seguida, confirmar que há uma mensagem na upper-case fila.
Envie uma mensagem para a fila com o lower-case Service Bus Explorer. Para obter mais informações, consulte a seção Enviar uma mensagem para uma fila ou tópico de Usar o Service Bus Explorer para executar operações de dados no Service Bus.
Confirme se há uma nova mensagem enviada para a upper-case fila. Para obter mais informações, consulte a seção Espreitar uma mensagem de Usar o Service Bus Explorer para executar operações de dados no Service Bus.
Vá para a página Visão geral da instância do Azure Spring Apps e selecione Logs para verificar os logs do aplicativo.
Envie uma mensagem para a fila com o lower-case Service Bus Explorer. Para obter mais informações, consulte a seção Enviar uma mensagem para uma fila ou tópico de Usar o Service Bus Explorer para executar operações de dados no Service Bus.
Confirme se há uma nova mensagem enviada para a upper-case fila. Para obter mais informações, consulte a seção Espreitar uma mensagem de Usar o Service Bus Explorer para executar operações de dados no Service Bus.
Vá para a página Visão geral da instância do Azure Spring Apps e selecione Logs para verificar os logs do aplicativo.
Verifique os detalhes de cada implantação de recurso, que são úteis para investigar quaisquer problemas de implantação.
Envie uma mensagem para a fila com o lower-case Service Bus Explorer. Para obter mais informações, consulte a seção Enviar uma mensagem para uma fila ou tópico de Usar o Service Bus Explorer para executar operações de dados no Service Bus.
Confirme se há uma nova mensagem enviada para a upper-case fila. Para obter mais informações, consulte a seção Espreitar uma mensagem de Usar o Service Bus Explorer para executar operações de dados no Service Bus.
Vá para a página Visão geral da instância do Azure Spring Apps e selecione Logs para verificar os logs do aplicativo.
Verifique os detalhes de cada implantação de recurso, que são úteis para investigar quaisquer problemas de implantação.
Envie uma mensagem para a fila com o lower-case Service Bus Explorer. Para obter mais informações, consulte a seção Enviar uma mensagem para uma fila ou tópico de Usar o Service Bus Explorer para executar operações de dados no Service Bus.
Confirme se há uma nova mensagem enviada para a upper-case fila. Para obter mais informações, consulte a seção Espreitar uma mensagem de Usar o Service Bus Explorer para executar operações de dados no Service Bus.
Vá para a página Visão geral da instância do Azure Spring Apps e selecione Logs para verificar os logs do aplicativo.
Use o seguinte comando para verificar o log do aplicativo para investigar qualquer problema de implantação:
az spring app logs \
--service ${AZURE_SPRING_APPS_INSTANCE} \
--name ${APP_NAME}
6. Limpar os recursos
Certifique-se de excluir os recursos criados neste artigo quando não precisar mais deles. Pode eliminar 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:
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.
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 o serviço recém-criado:
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.
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 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:
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.
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 o serviço recém-criado:
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.
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 as interações de comando:
Total de recursos a eliminar: <seu-recursos-total>, tem a certeza de que pretende continuar?: Prima y.
Você gostaria de excluir permanentemente esses recursos, permitindo que seus nomes sejam reutilizados?: Pressione y. Pressione n se quiser reutilizar o Cofre da Chave.
O console emite mensagens semelhantes ao exemplo a seguir:
SUCCESS: Your application was removed from Azure in xx minutes xx seconds.
