Usar o Acelerador de Aplicativo do VMware Tanzu com o plano Enterprise do Azure Spring Apps

Este artigo se aplica a: ❎ Básico/Padrão ✅ Enterprise

Esse artigo mostra como usar o Application Accelerator for VMware Tanzu (App Accelerator) com o plano Aplicativos Spring do Azure Enterprise para inicializar o desenvolvimento de seus aplicativos de maneira detectável e repetível.

O App Accelerator ajuda você a iniciar o desenvolvimento de seus aplicativos e a implantá-los de maneira detectável e repetível. Você pode usar o App Accelerator para criar novos projetos com base em projetos de acelerador publicados. Para obter mais informações, veja Application Accelerator for VMware Tanzu na documentação do VMware.

Pré-requisitos

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

• Compreenda e cumpra os requisitos listados na seção Requisitos do Plano empresarial no Azure Marketplace.

• CLI do Azure com a extensão dos Aplicativos Spring do Azure. Use o comando a seguir para remover versões anteriores e instalar a extensão mais recente. Se você instalou a extensão spring-cloud anteriormente, desinstale-a para evitar incompatibilidades de configuração e versão.

  az extension remove --name spring
  az extension add --name spring
  az extension remove --name spring-cloud
  

• Para usar o App Accelerator no VS Code, você também precisará atender aos seguintes pré-requisitos:

  • Visual Studio Code
  • Extensão de aplicativos do Aplicativos Spring do Azure para Visual Studio Code

Habilitar Acelerador de Aplicativos

Você pode habilitar o App Accelerator ao provisionar uma instância do plano Aplicativos Spring do Azure Enterprise. Se você já tiver um recurso do plano Enterprise do Aplicativos Spring do Azure, veja a seção Gerenciar o App Accelerator em uma instância de plano Enterprise existente para habilitá-lo.

Você pode habilitar o App Accelerator usando o portal do Azure ou a CLI do Azure.

Monitore o acelerador de aplicativos

O Application Accelerator permite gerar novos projetos a partir de arquivos em repositórios Git. A tabela a seguir descreve os componentes do Application Accelerator:

Você pode ver as instâncias em execução e o uso de recursos de todos os componentes usando o portal do Azure e a CLI do Azure.

az spring application-accelerator show \
    --service <Azure-Spring-Apps-service-instance-name> \
    --resource-group <resource-group-name>

Configure as Ferramentas para Desenvolvedores para acessar o Application Accelerator

Para acessar o Application Accelerator, você deve configurar o Tanzu Ferramentas para Desenvolvedores. Para obter mais informações, veja Configurar Tanzu Ferramentas para Desenvolvedores no plano Aplicativos Spring do Azure Enterprise.

Use o Application Accelerator para inicializar seus novos projetos

Para usar o Application Accelerator para inicializar seus novos projetos, você deve obter permissões para gerenciar aceleradores. Você pode então gerenciar aceleradores predefinidos ou seus próprios aceleradores.

Obtenha permissões para gerenciar aceleradores

Gerenciar seus aceleradores requer as seguintes permissões:

• Leia: Obtenha o acelerador predefinido de Aplicativos Spring do Azure
• Outro: desabilitar o acelerador predefinido de Aplicativos Spring do Azure
• Outro: Habilitar o Acelerador Predefinido de Aplicativos Spring do Azure
• Gravar: Criar ou atualizar o acelerador personalizado da Microsoft Aplicativos Spring do Azure
• Leia: Obtenha o acelerador personalizado do Aplicativos Spring do Azure

Para obter mais informações, veja Como usar permissões em Aplicativos Spring do Azure.

Gerenciar aceleradores predefinidos

Você pode começar com vários aceleradores predefinidos para inicializar seus novos projetos. Você pode desabilitar ou habilitar os aceleradores integrados de acordo com sua preferência.

Você pode gerenciar aceleradores predefinidos usando o portal do Azure ou a CLI do Azure.

az spring application-accelerator predefined-accelerator list \
    --service <service-instance-name> \
    --resource-group <resource-group-name>

az spring application-accelerator predefined-accelerator disable \
    --name <predefined-accelerator-name> \
    --service <service-instance-name> \
    --resource-group <resource-group-name>

az spring application-accelerator predefined-accelerator enable \
    --name <predefined-accelerator-name> \
    --service <service-instance-name> \
    --resource-group <resource-group-name>

Gerencie seus próprios aceleradores

Além de usar os aceleradores predefinidos, você pode criar seus próprios aceleradores. Você pode usar qualquer repositório Git no Azure DevOps, GitHub, GitLab ou BitBucket.

Use as etapas a seguir para criar e manter seus próprios aceleradores:

Primeiro, crie um arquivo chamado accelerator.yaml no diretório raiz do seu repositório Git.

Você pode usar o arquivo accelerator.yaml para declarar opções de entrada que os usuários preenchem usando um formulário na IU. Esses valores de opção controlam o processamento pelo mecanismo de modelo antes de retornar os arquivos de saída compactados. Se você não incluir um arquivo accelerator.yaml, o repositório ainda funcionará como um acelerador, mas os arquivos serão passados sem modificações aos usuários. Para obter mais informações, veja Criando um arquivo accelerator.yaml.

Em seguida, publique o novo acelerador.

Depois de criar seu arquivo accelerator.yaml, você poderá criar seu acelerador. Você pode então visualizá-lo no portal do Azure ou na página do Application Accelerator no Ferramentas para Desenvolvedores Portal. Você pode publicar o novo acelerador usando o portal do Azure ou a CLI do Azure.

az spring application-accelerator customized-accelerator create \
    --name <customized-accelerator-name> \
    --service <service-instance-name> \
    --resource-group <resource-group-name> \
    --display-name <display-name> \
    --git-url <git-repo-url> \
   [--description <description>] \
   [--icon-url <icon-url>] \
   [--accelerator-tags <tags-on-accelerator>] \
   [--git-interval <git-repository-refresh-interval-in-seconds>] \
   [--git-branch <git-branch-name>] \
   [--git-commit <git-commit-ID>] \
   [--git-tag <git-tag>] \
   [--ca-cert-name <ca-cert-name>] \
   [--username] \
   [--password] \
   [--private-key] \
   [--host-key] \
   [--host-key-algorithm]

A tabela a seguir descreve os campos personalizáveis do acelerador.

Para visualizar todos os aceleradores publicados, consulte a seção Aceleradores de aplicativos da página Ferramentas do desenvolvedor. Selecione o URL do App Accelerator para visualizar os aceleradores publicados no Ferramentas para Desenvolvedores Portal:

Para visualizar o acelerador recém-publicado, atualize o Portal de Ferramentas para Desenvolvedores.

Faça referência a um fragmento em seus próprios aceleradores

Escrever e manter aceleradores pode se tornar repetitivo e detalhado à medida que novos aceleradores são adicionados. Algumas pessoas criam novos projetos copiando os existentes e fazendo modificações, mas esse processo pode ser tedioso e sujeito a erros. Para facilitar a criação e manutenção de aceleradores, o Application Accelerator suporta um recurso chamado Composition que permite a reutilização de partes de um acelerador, chamadas de fragmentos.

Use as etapas a seguir para fazer referência a um fragmento em seu acelerador:

1. Publique o novo acelerador do tipo Fragment usando o portal do Azure ou a CLI do Azure.

   • Portal do Azure
   • CLI do Azure

   Para criar um acelerador de fragmentos, abra a seção Aceleradores, selecione Adicionar acelerador na seção Aceleradores personalizados e selecione Fragmento.

   

2. Altere o arquivo accelerator.yaml em seu projeto de acelerador. Use a instrução imports na seção accelerator e a instrução InvokeFragment na seção engine para referenciar o fragmento no acelerador, conforme mostrado no exemplo a seguir:

   accelerator:
       ...
     # options for the UI
     options:
       ...
     imports:
     - name: <fragment-accelerator-name>
     ...
   
   engine:
     chain:
       ...
     - merge:
       - include: [ "**" ]
       - type: InvokeFragment
         reference: <fragment-accelerator-name>
   

3. Sincronize a alteração com o Portal de Ferramentas para Desenvolvedores.

   Para refletir as alterações no Ferramentas para Desenvolvedores Portal mais rapidamente, você pode fornecer um valor para o campo Intervalo Git do seu acelerador personalizado. O valor Intervalo Git indica a frequência com que o sistema verifica atualizações no repositório Git.

4. Sincronize a alteração com o seu acelerador personalizado no portal do Azure utilizando o portal do Azure ou o CLI do Azure.

   • Portal do Azure
   • CLI do Azure

   A lista a seguir mostra as duas maneiras de sincronizar alterações:

   • Crie ou atualize seu acelerador personalizado.
   • Abra a seção Aceleradores e selecione Sincronizar certificado.

Para obter mais informações, veja Usar fragmentos no Application Accelerator na documentação do VMware.

Use aceleradores para inicializar um novo projeto

Use as etapas a seguir para inicializar um novo projeto usando aceleradores:

1. Na página Ferramentas para Desenvolvedores, selecione o URL do App Accelerator para abrir o Portal de Ferramentas para Desenvolvedores.

   

2. No Portal Ferramentas para Desenvolvedores, selecione um acelerador.

3. Especifique as opções de entrada na seção Configurar acelerador da página Gerar aceleradores.

   

4. Selecione EXPLORE FILE para visualizar a estrutura do projeto e o código-fonte.

5. Selecione Revisar e gerar para revisar os parâmetros especificados e, em seguida, selecione Gerar acelerador.

   

6. Você pode então visualizar ou baixar o projeto como um arquivo zip.

   

Configurar aceleradores com um certificado autoassinado

Ao configurar um repositório Git privado e habilitar o HTTPS com um certificado autoassinado, você deve configurar o nome do certificado CA para o acelerador para verificação do certificado do cliente do acelerador para o repositório Git.

Use as etapas a seguir para configurar aceleradores com um certificado autoassinado:

1. Importe os certificados para Aplicativos Spring do Azure. Para obter mais informações, consulte a seção Importar um certificado de Usar certificados TLS/SSL em seu aplicativo nos Aplicativos Spring do Azure.
2. Configure o certificado para o acelerador usando o portal do Azure ou a CLI do Azure.

az spring application-accelerator customized-accelerator create \
    --resource-group <resource-group-name> \
    --service <service-instance-name> \
    --name <customized-accelerator-name> \
    --git-url <git-repo-URL> \
    --ca-cert-name <ca-cert-name>

Girar certificados

À medida que os certificados expiram, você precisa alternar os certificados nos Aplicativos Spring Cloud usando as seguintes etapas:

1. Gere novos certificados de uma CA confiável.
2. Importe os certificados para Aplicativos Spring do Azure. Para obter mais informações, consulte a seção Importar um certificado de Usar certificados TLS/SSL em seu aplicativo nos Aplicativos Spring do Azure.
3. Sincronize os certificados usando o portal do Azure ou a CLI do Azure.

Os aceleradores não usarão automaticamente o certificado mais recente. Você deve sincronizar um ou todos os certificados usando o portal do Azure ou a CLI do Azure.

az spring application-accelerator customized-accelerator sync-cert \
    --name <customized-accelerator-name> \
    --service <service-instance-name> \
    --resource-group <resource-group-name>

Gerenciar o App Accelerator em uma instância existente do plano Enterprise

Você pode habilitar o App Accelerator em uma instância existente do plano Aplicativos Spring do Azure Enterprise usando o portal do Azure ou a CLI do Azure.

az spring application-accelerator create \
    --service <Azure-Spring-Apps-service-instance-name> \
    --resource-group <resource-group-name>

az spring application-accelerator delete \
    --service <Azure-Spring-Apps-service-instance-name> \
    --resource-group <resource-group-name>

az spring dev-tool create \
    --resource-group <resource-group-name> \
    --service <Azure-Spring-Apps-service-instance-name> \
    --assign-endpoint

Use o App Accelerator no VS Code

Você pode inicializar seu projeto a partir de qualquer acelerador do App Accelerator em uma instância de serviço do plano Enterprise do Aplicativos Spring do Azure diretamente no VS Code.

Veja a lista de aceleradores de aplicativos

Use as etapas a seguir para exibir a lista de aceleradores de aplicativos em uma instância de serviço do plano Aplicativos Spring do Azure Enterprise:

1. No Visual Studio Code, abra a extensão Aplicativos Spring do Azure e entre em sua conta do Azure.

2. Expanda a instância de serviço desejada e clique com o botão direito para selecionar a instância de serviço.

3. No menu, selecione Abrir acelerador de aplicativos para abrir a lista de aceleradores de aplicativos. O sistema solicitará que você instale a extensão Tanzu Application Accelerator Visual Studio Code se ela não estiver instalada.

   

4. Selecione qualquer acelerador para inicializar seu projeto.

   

Solucionar problemas do Acelerador de Aplicativo

Se você tentar abrir o App Accelerator para uma instância de serviço que não ativou o App Accelerator ou expôs um ponto de extremidade público, você verá a seguinte mensagem de erro: Application Accelerator of Spring Apps <instance-name> is not enabled or publically accessible.

Para habilitar o App Accelerator e expor ponto de extremidade públicos, use as etapas a seguir. Para obter mais informações, veja a seção Gerenciar o App Accelerator em uma instância existente do plano Enterprise.

1. Se você habilitou o logon único no Portal de Ferramentas para Desenvolvedores, verá a seguinte mensagem ao acessar a extensão: The extension 'Tanzu App Accelerator' wants to sign in using VMware Tanzu. Para obter mais informações, consulte a seção Configurar Portal de Ferramentas para Desenvolvedores de Configurar Tanzu Dev Tools no Aplicativos Spring do Azure Enterprise plano.

2. Selecione Permitir, selecione Abrir e selecione Abrir novamente para abrir a lista de extensões do VS Code.

   

Às vezes, você pode receber uma mensagem de erro semelhante ao exemplo a seguir: AADSTS50011: The redirect URI 'vscode://VMware.tanzu-app-accelerator' specified in the request does not match the redirect URIs configured for the application 'xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx'. Make sure the redirect URI sent in the request matches one added to your application in the Azure portal. Navigate to https://aka.ms/redirectUriMismatchError to learn more about how to fix this.

Para resolver esse problema, adicione o URI de redirecionamento vscode://VMware.tanzu-app-accelerator ao provedor de identidade (IdP) relevante. No Microsoft Entra ID, acesse o menu Autenticação e adicione URIs de redirecionamento para aplicativos móveis e espaço de trabalho nas configurações da plataforma.

Próximas etapas

• Azure Spring Apps