Usar o Tanzu Build Service

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.

O plano consumo e dedicado Standard 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 mais informações, confira Migrar o plano dedicado e consumo Standard dos Aplicativos Spring do Azure para os Aplicativos de Contêiner do Azure.

Este artigo se aplica a: ❎ Básico/Standard ✅ Enterprise

Este artigo mostra como usar o VMware Tanzu Build Service com o plano do Enterprise dos Aplicativos Spring do Azure.

O Serviço de Build do VMware Tanzu automatiza a criação, o gerenciamento e a governança de contêineres em escala empresarial. O Tanzu Build Service usa o projeto de buildpacks nativos de nuvem de software livre para transformar o código-fonte do aplicativo em imagens de contêiner. Ele executa builds reproduzíveis alinhados aos padrões modernos de contêineres e mantém as imagens atualizadas.

Buildpacks

Os Buildpacks do VMware Tanzu fornecem suporte de estrutura e runtime para os aplicativos. Os buildpacks normalmente analisam seus aplicativos para determinar quais dependências baixar e como configurar os aplicativos para se comunicarem com os serviços associados.

Os buildpacks da família de idiomas são buildpacks compostos que fornecem suporte simplificado para os runtimes de linguagem e as configurações de aplicativo mais populares. Esses buildpacks combinam vários buildpacks de componentes em agrupamentos ordenados. Os agrupamentos atendem aos requisitos de cada buildpack.

Construtores

Um Construtor é um recurso do Build Service do Tanzu. Um Construtor contém um conjunto de buildpacks e uma pilha usada no processo de criação do código-fonte.

Pool de agentes de compilação

O Tanzu Build Service no plano Enterprise é o ponto de entrada para conteinerizar aplicativos de usuário por meio do código-fonte e dos artefatos. Há um pool de agentes de build dedicado que reserva recursos de computação para um determinado número de tarefas de compilação simultâneas. O pool de agentes de build impede a contenção de recursos com seus aplicativos em execução.

A tabela a seguir mostra os tamanhos disponíveis para os conjuntos de dimensionamento do pool de agentes de build:

Conjunto de dimensionamento	CPU/Gi
S1	2 vCPU, 4 Gi
S2	3 vCPU, 6 Gi
S3	4 vCPU, 8 Gi
S4	5 vCPU, 10 Gi
S5	6 vCPU, 12 Gi
S6	8 vCPU, 16 Gi
S7	16 vCPU, 32 Gi
S8	32 vCPU, 64 Gi
S9	64 vCPU, 128 Gi

O Tanzu Build Service permite, no máximo, uma tarefa de build do tamanho de pool para compilar e o dobro das tarefas de build do tamanho do pool para enfileirar. Se a cota do pool de agentes não for suficiente para a tarefa de build, a solicitação para este build resultará no seguinte erro: The usage of build results in Building or Queuing status are (cpu: xxx, memory: xxxMi) and the remained quota is insufficient for this build. please retry with smaller size of build resourceRequests, retry after the previous build process completed or increased your build agent pool size.

Configurar o pool de agentes de build

Quando você cria uma nova uma instância de serviço dos Aplicativos Spring do Azure Enterprise pelo portal do Azure, você pode configurar o número de recursos para o pool de agentes de build na guia de Configurações do VMware Tanzu.

A imagem a seguir mostra os recursos fornecidos ao pool de agentes do Tanzu Build Service depois que você provisionou a instância de serviço corretamente. Você também pode atualizar o tamanho configurado do pool de agentes aqui depois de criar a instância de serviço.

Criar serviço sob demanda

Você pode habilitar ou desabilitar o serviço de build ao criar uma instância dos Aplicativos Spring do Azure no plano Enterprise.

Características de build e implantação

Por padrão, o Tanzu Build Service está habilitado para que você possa usar um registro de contêiner. Se desabilitar o serviço de build, você só poderá implantar um aplicativo com uma imagem de contêiner personalizada. Você tem as seguintes opções:

• Habilitar o serviço de build e use o registro de contêiner gerenciado dos Aplicativos Spring do Azure

  Os Aplicativos Spring do Azure oferecem um Registro de Contêiner do Azure gerenciado para armazenar imagens criadas dos seus aplicativos. Você só pode executar o build e a implantação juntos como um único comando, mas não separadamente. Você pode usar as imagens de contêiner criadas para implantar aplicativos somente na mesma instância de serviço. As imagens não estão acessíveis para outras instâncias de serviço dos Aplicativos Spring do Azure Enterprise.

• Habilitar o serviço de build e use seu próprio registro de contêiner.

  Esse cenário separa o processo de build da implantação. Você pode executar builds a partir do código-fonte ou artefatos de um aplicativo para uma imagem de contêiner separadamente da implantação do aplicativo. Você pode implantar as imagens de contêiner armazenadas em seu próprio registro de contêiner em várias instâncias de serviço dos Aplicativos Spring do Azure Enterprise.

• Desabilitar o serviço de build.

  Ao desabilitar o serviço de build, você só pode implantar aplicativos com imagens de contêiner, que podem ser criadas a partir de qualquer instância de serviço dos Aplicativos Spring do Azure Enterprise.

Definir as configurações do serviço de build

Você pode configurar o Tanzu Build Service e o registro de contêiner usando o portal do Azure ou a CLI do Azure.

Portal do Azure

Siga as próximas etapas para habilitar o Tanzu Build Service ao provisionar uma instância de serviço dos Aplicativos Spring do Azure:

1. Abra o Portal do Azure.

2. Na guia Básico, selecione Nível Enterprise na seção Preços e depois especifique as informações necessárias.

3. Selecione Próximo: Configurações do VMware Tanzu.

4. Na guia Configurações do VMware Tanzu, selecione Habilitar Serviço de Build. Para Registro de contêiner, a configuração padrão é usar um Registro de Contêiner do Azure gerenciado para armazenar imagens criadas.

   

5. Se você escolher Usar seu próprio registro de contêiner para armazenar imagens criadas (pré-visualização) do Registro de contêiner, forneça o servidor, o nome de usuário e a senha do registro de contêiner.

   

6. Se você desabilitar Habilitar o Serviço de Build, as opções do registro de contêiner não serão apresentadas, mas você poderá implantar aplicativos com imagens de contêiner.

   

7. Selecione Examinar e criar.

CLI do Azure

Siga as próximas etapas para habilitar o Tanzu Build Service ao provisionar uma instância de serviço dos Aplicativos Spring do Azure:

1. Use os seguintes comandos para entrar na CLI do Azure, listar as assinaturas disponíveis e escolher sua assinatura ativa:

   az login
   az account list --output table
   az account set --subscription <subscription-id>
   

2. Use o seguinte comando para registrar o namespace Microsoft.Saas.

   az provider register --namespace Microsoft.SaaS
   

3. Use o comando a seguir para aceitar os termos legais e as declarações de privacidade do plano Aplicativos Spring do Azure Enterprise. Essa etapa só será necessária se sua assinatura nunca tiver sido usada para criar uma instância do plano Enterprise dos Aplicativos Spring do Azure.

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

4. Selecione uma localização. O local deve dar suporte ao plano Enterprise dos Aplicativos Spring do Azure. Para obter mais informações, consulte Perguntas frequentes sobre Aplicativos Spring do Azure.

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

   az group create \
       --name <resource-group-name> \
       --location <location>
   

   Para obter mais informações sobre grupos de recursos, veja O que é o Azure Resource Manager?

6. Prepare um nome para a instância de serviço do Azure Spring Apps. 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.

7. Use um dos comandos a seguir para criar uma instância de serviço dos Aplicativos Spring do Azure:

   • Use o comando a seguir para criar uma instância de serviço dos Aplicativos Spring do Azure com o serviço de build habilitado e usando um Registro de Contêiner do Azure gerenciado. O serviço de build é habilitado por padrão.

     az spring create \
         --resource-group <resource-group-name> \
         --name <Azure-Spring-Apps-service-instance-name> \
         --sku enterprise
     

   • Use o comando a seguir para criar uma instância de serviço dos Aplicativos Spring do Azure com o serviço de build habilitado e usando seu próprio registro de contêiner. O serviço de build é habilitado por padrão.

     az spring create \
         --resource-group <resource-group-name> \
         --name <Azure-Spring-Apps-service-instance-name> \
         --sku enterprise \
         --registry-server <your-container-registry-login-server> \
         --registry-username <your-container-registry-username> \
         --registry-password <your-container-registry-password>
     

   • Use o seguinte comando para criar uma instância de serviço dos Aplicativos Spring do Azure com o serviço de build desabilitado.

     az spring create \
         --resource-group <resource-group-name> \
         --name <Azure-Spring-Apps-service-instance-name> \
         --sku enterprise \
         --disable-build-service
     

Implantar aplicativos poliglotas

Você pode implantar aplicativos poliglotas em uma instância de serviço dos Aplicativos Spring do Azure Enterprise com o Tanzu Build Service habilitado ou desabilitado. Para mais informações, confira Como implantar aplicativos poliglotas nos Aplicativos Spring do Azure Enterprise.

Configurar a integração do APM e os certificados de AC

Usando o Buildpacks do Tanzu Partner e o Buildpack de Certificados de AC, o nível Enterprise dos Aplicativos Spring do Azure proporciona uma experiência de configuração simplificada para dar suporte à integração do monitor de desempenho de aplicativos (APM). Essa integração inclui cenários de integração de certificados de autoridade de certificação (AC) para aplicativos poliglotas. Para obter mais informações, consulte Como configurar a integração do APM e os certificados de AC.

Logs de build em tempo real

Uma tarefa de compilação é disparada quando um aplicativo é implantado por meio de um comando da CLI do Azure. Os logs de build são transmitidos em tempo real como parte da saída do comando da CLI. Para mais informações sobre como usar logs de build a fim de diagnosticar problemas, confira Analisar logs e métricas com configurações de diagnóstico.

Histórico de build

Você pode conferir todos os recursos de build na seção Builds da página Serviço de Build dos Aplicativos Spring do Azure.

A tabela na seção Builds inclui as seguintes colunas:

• Nome do Build: o nome do build.
• Estado de Provisionamento: o estado de provisionamento do build. Os valores são Succeeded, Failed, Updating e Creating. Os estados de provisionamento Updating e Creating significam que o build não pode ser atualizado até que o build atual seja concluído. O estado de provisionamento Failed indica que o build de código-fonte mais recente falhou ao gerar um novo resultado de build.
• Cota de Recurso: a cota de recursos no pod do build.
• Construtor: o construtor usado no build.
• Resultado de Build Mais Recente: a marca da imagem mais recente do resultado de build.
• Estado de Provisionamento do Resultado de Build Mais Recente: o estado de provisionamento do resultado mais recente do build. Os valores são Queuing, Building, Succeeded e Failed.
• Hora da Última Transição do Resultado de Build Mais Recente: a hora da última transição do resultado mais recente de build.
• Motivo da Última Transição do Resultado de Build Mas Recente: o motivo da última transição do resultado de build mais recente. Os valores são CONFIG, STACK e BUILDPACK. CONFIG significa que o resultado de build foi alterado devido a atualizações do construtor ou por uma nova operação de implantação do código-fonte. STACK significa que o resultado de build foi alterado devido a uma atualização de pilha. BUILDPACK significa que o resultado de build foi alterado devido a uma atualização do buildpack.
• Status da Última Transição do Resultado de Build Mais Recente: o status da última transição do resultado mais recente de build. Os valores são True e False.

Para Estado de Provisionamento, se o valor for Failed, implante o código-fonte novamente. Se o erro continuar, crie um tíquete de suporte.

Para Estado de Provisionamento do Resultado de Build Mais Recente, se o valor for Failed, verifique os logs de build. Para mais informações, confira Solucionar problemas comuns de compilação em Aplicativos Spring do Azure.

Para obter o Status da Última Transição do Resultado de Build Mais Recente, se o valor for Failed, veja a coluna Motivo da Última Transição do Resultado de Build Mais Recente. Se o motivo for BUILDPACK ou STACK, nenhuma ação é necessária. Se o motivo for CONFIG, implante o código-fonte novamente. Se o erro continuar, crie um tíquete de suporte.

Próximas etapas

• Como configurar a integração do APM e certificados de AC