Usar o Tanzu Build Service

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: ❎ Basic/Standard ✅ Enterprise

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

O VMware Tanzu Build Service automatiza a criação, o gerenciamento e a governança de contêineres em escala corporativa. O Tanzu Build Service usa o projeto Cloud Native Buildpacks de código aberto para transformar o código-fonte do aplicativo em imagens de contêiner. Ele executa compilações reproduzíveis alinhadas com os padrões modernos de contêineres e mantém as imagens atualizadas.

Pacotes de construção

Os VMware Tanzu Buildpacks fornecem suporte de estrutura e tempo de execução para aplicativos. Buildpacks normalmente examinam seus aplicativos para determinar quais dependências baixar e como configurar aplicativos para se comunicar com serviços vinculados.

Os buildpacks da família de idiomas são buildpacks compostos que fornecem suporte fácil e pronto para uso para os tempos de execução de linguagem e configurações de aplicativos mais populares. Esses buildpacks combinam vários buildpacks de componentes em agrupamentos ordenados. Os agrupamentos satisfazem os requisitos de cada buildpack.

Construtores

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

Criar pool de agentes

O Tanzu Build Service no plano Enterprise é o ponto de entrada para contentorizar aplicações de utilizador a partir do código-fonte e dos artefactos. Há um pool de agentes de compilação dedicado que reserva recursos de computação para um determinado número de tarefas de compilação simultâneas. O pool de agentes de compilação impede a contenção de recursos com seus aplicativos em execução.

A tabela a seguir mostra os tamanhos disponíveis para conjuntos de escala de pool de agentes de compilação:

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 compilação do tamanho do pool para construir e o dobro das tarefas de compilação do tamanho do pool para a fila. Se a cota do pool de agentes for insuficiente para a tarefa de compilação, a solicitação para essa compilação receberá o 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 compilação

Ao criar uma nova instância do serviço Azure Spring Apps Enterprise usando o portal do Azure, você pode usar a guia Configurações do VMware Tanzu para configurar o número de recursos fornecidos ao pool de agentes de compilação.

A imagem a seguir mostra os recursos fornecidos ao Tanzu Build Service Agent Pool depois de provisionar com êxito a instância de serviço. Você também pode atualizar o tamanho do pool de agentes configurado aqui depois de criar a instância de serviço.

Crie um serviço sob demanda

Você pode habilitar ou desabilitar o serviço de compilação ao criar uma instância do plano do Azure Spring Apps Enterprise.

Características de compilação e implantação

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

• Habilite o serviço de compilação e use o registro de contêiner gerenciado do Azure Spring Apps.

  O Azure Spring Apps fornece um Registro de Contêiner do Azure gerenciado para armazenar imagens criadas para seus aplicativos. Você pode executar a compilação e a implantação juntas apenas como um 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 são acessíveis por outras instâncias de serviço do Azure Spring Apps Enterprise.

• Habilite o serviço de compilação e use seu próprio registro de contêiner.

  Este cenário separa a compilação da implantação. Você pode executar compilações 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 do Azure Spring Apps Enterprise.

• Desative o serviço de compilação.

  Ao desabilitar o serviço de compilação, você pode implantar aplicativos somente com imagens de contêiner, que podem ser criadas a partir de qualquer instância de serviço do Azure Spring Apps Enterprise.

Definir configurações de serviço de compilação

Você pode definir o Tanzu Build Service e as configurações do Registro de contêiner usando o portal do Azure ou a CLI do Azure.

Portal do Azure

Use as seguintes etapas para habilitar o Tanzu Build Service ao provisionar uma instância de serviço do Azure Spring Apps:

1. Abra o portal do Azure.

2. Na guia Noções básicas, selecione Camada corporativa na seção Preços e especifique as informações necessárias.

3. Selecione Next: VMware Tanzu settings.

4. Na guia Configurações do VMware Tanzu , selecione Ativar serviço de compilação. Para o 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ê selecionar Usar seu próprio registro de contêiner para armazenar imagens construídas (visualização) para o 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 Serviço de Compilação, as opções de registro de contêiner não serão fornecidas, mas você poderá implantar aplicativos com imagens de contêiner.

   

7. Selecione Rever e criar.

CLI do Azure

Use as seguintes etapas para habilitar o Tanzu Build Service ao provisionar uma instância de serviço do Azure Spring Apps:

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

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

2. Use o comando a seguir para registrar o Microsoft.Saas namespace.

   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 do Azure Spring Apps Enterprise. Esta etapa é necessária somente se sua assinatura nunca tiver sido usada para criar uma instância do plano Enterprise do Azure Spring Apps.

   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 do Azure Spring Apps Enterprise. Para obter mais informações, consulte Perguntas frequentes sobre o Azure Spring Apps.

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

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

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

6. Prepare um nome para sua 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 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.

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

   • Use o comando a seguir para criar uma instância de serviço do Azure Spring Apps com o serviço de compilação habilitado e usando um Registro de Contêiner do Azure gerenciado. O serviço de compilação está 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 do Azure Spring Apps com o serviço de compilação habilitado e usando seu próprio registro de contêiner. O serviço de compilação está 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 comando a seguir para criar uma instância de serviço do Azure Spring Apps com o serviço de compilação desabilitado.

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

Implante aplicativos poliglotas

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

Configurar a integração com APM e certificados de CA

Usando o Tanzu Partner Buildpacks e o CA Certificates Buildpack, o plano do Azure Spring Apps Enterprise fornece 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 (CA) para aplicativos poliglotas. Para obter mais informações, consulte Como configurar a integração APM e certificados de CA.

Logs de compilação em tempo real

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

Construir história

Você pode ver todos os recursos de compilação na seção Compilações da página Serviço de Criação do Azure Spring Apps.

A tabela na seção Compilações contém as seguintes colunas:

• Nome da compilação: O nome da compilação.
• Estado de provisionamento: o estado de provisionamento da compilação. Os valores são Succeeded, Failed, Updating, e Creating. Os estados Updating de provisionamento significam que Creating a compilação não pode ser atualizada até que a compilação atual seja concluída. O estado Failed de provisionamento significa que sua compilação de código-fonte mais recente não conseguiu gerar um novo resultado de compilação.
• Cota de recursos: A cota de recursos no pod de compilação da compilação.
• Construtor: O construtor usado na construção.
• Resultado da compilação mais recente: A marca de imagem de resultado da compilação mais recente da compilação.
• Estado de provisionamento do resultado da compilação mais recente: o estado de provisionamento do resultado da compilação mais recente. Os valores são Queuing, Building, Succeeded, e Failed.
• Último resultado da compilação Tempo de transição: o último tempo de transição para o resultado de compilação mais recente da compilação.
• Último resultado da compilação Motivo da última transição: O último motivo da transição para o resultado da compilação mais recente da compilação. Os valores são CONFIG, STACKe BUILDPACK. CONFIG significa que o resultado da compilação é alterado por atualizações do construtor ou por uma nova operação de implantação do código-fonte. STACK significa que o resultado da compilação é alterado por uma atualização de pilha. BUILDPACK significa que o resultado da compilação é alterado por uma atualização do buildpack.
• Status da última transição do resultado da compilação: o último status de transição para o resultado da compilação mais recente da compilação. Os valores são True e False.

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

Para Latest Build Result Provisioning State, quando o valor for Failed, verifique os logs de compilação. Para obter mais informações, consulte Solucionar problemas comuns de compilação no Azure Spring Apps.

Para Latest Build Result Last Transition Status, quando o valor for Failed, consulte a coluna Latest Build Result Last Transition Reason . 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 persistir, crie um tíquete de suporte.

Próximos passos

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