Como implantar aplicativos poliglotas no plano do Azure Spring Apps Enterprise

Este artigo aplica-se a:❌ Basic/Standard ✔️ Enterprise

Este artigo mostra como implantar aplicativos poliglotas no plano do Azure Spring Apps Enterprise e como esses aplicativos poliglotas podem usar os recursos de serviço de compilação fornecidos por buildpacks.

Pré-requisitos

• Uma instância de plano do Azure Spring Apps Enterprise já provisionada. Para obter mais informações, consulte Guia de início rápido: criar e implantar aplicativos no Azure Spring Apps usando o plano Enterprise.
• Azure CLI versão 2.45.0 ou superior. Use o seguinte comando para instalar a extensão Azure Spring Apps: az extension add --name spring

Implantar aplicativos poliglotas em uma instância de serviço

Esta seção se aplica à criação e implantação de aplicativos poliglotas quando o serviço de compilação está habilitado. Se você desabilitar o serviço de compilação, poderá implantar aplicativos somente com uma imagem de contêiner personalizada. Você pode criar sua própria imagem ou usar uma criada por uma instância do Azure Spring Apps Enterprise. Para obter mais informações, consulte Implantar um aplicativo com uma imagem de contêiner personalizada.

Gerenciar construtores

Ao criar uma instância do Azure Spring Apps Enterprise, você deve escolher um construtor padrão de um dos seguintes buildpacks da família de idiomas com suporte:

• Java Azure Buildpack para VMware Tanzu
• .NET Core Buildpack para VMware Tanzu
• Go Buildpack para VMware Tanzu
• Servidores Web Buildpack para VMware Tanzu
• Node.js Buildpack para VMware Tanzu
• Python Buildpack para VMware Tanzu
• Java Native Image Buildpack para VMware Tanzu
• PHP Buildpack para VMware Tanzu

Para obter mais informações, consulte Language Family Buildpacks for VMware Tanzu.

Esses buildpacks suportam a criação com código-fonte ou artefatos para Java, .NET Core, Go, arquivos estáticos da Web, Node.js e aplicativos Python. Você também pode ver as versões do buildpack durante a criação ou visualização de um construtor. E você pode criar um construtor personalizado especificando buildpacks e uma pilha.

Todos os construtores configurados em uma instância de serviço do Azure Spring Apps são listados na página Serviço de Compilação, conforme mostrado na captura de tela a seguir:

Selecione Adicionar para criar um novo construtor. A captura de tela a seguir mostra os recursos que você deve usar para criar o construtor personalizado. A pilha do sistema operacional inclui Bionic Base, Bionic Full, Jammy Tiny, Jammy Base, e Jammy Full. Bionic é baseado em Ubuntu 18.04 (Bionic Beaver) e Jammy é baseado em Ubuntu 22.04 (Jammy Jellyfish). Para obter mais informações, consulte a seção Recomendações da pilha do sistema operacional.

Recomendamos o uso Jammy OS Stack para criar seu construtor porque o VMware está preterindo Bionic OS Stacko .

Você também pode editar um construtor personalizado quando o construtor não é usado em uma implantação. Você pode atualizar os buildpacks ou a pilha do sistema operacional, mas o nome do construtor é somente leitura.

O construtor é um recurso que contribui continuamente para suas implantações. Ele fornece as imagens de tempo de execução mais recentes e os pacotes de compilação mais recentes.

Não é possível excluir um construtor quando implantações ativas existentes estão sendo criadas com o construtor. Para excluir um construtor nesse estado, use as seguintes etapas:

1. Salve a configuração como um novo construtor.
2. Implante aplicativos com o novo construtor. As implantações estão ligadas ao novo construtor.
3. Migre as implantações no construtor anterior para o novo construtor.
4. Exclua o construtor original.

Recomendações de pilha de SO

No Azure Spring Apps, recomendamos o uso Jammy OS Stack para criar seu construtor porque Bioinic OS Stack está na linha para a descontinuação pelo VMware. A lista a seguir descreve as opções disponíveis:

• Jammy Tiny: Adequado para construir uma imagem mínima para o menor tamanho possível e pegada de segurança. Como construir uma imagem nativa Java, ele pode tornar a imagem de contêiner final menor. As bibliotecas integradas são limitadas. Por exemplo, você não pode se conectar a uma instância de aplicativo para solução de problemas porque não shell há biblioteca.

  • A maioria dos aplicativos Go.
  • Aplicativos Java. Algumas opções de configuração do Apache Tomcat, como a configuração bin/setenv.sh, não estão disponíveis porque o Tiny não tem shell.

• Jammy Base: Adequado para a maioria dos aplicativos sem extensões nativas.

  • Aplicativos Java e aplicativos .NET Core.
  • Opte por aplicações que requerem algumas bibliotecas C.
  • Aplicativos Node.js, Python ou Servidores Web sem extensões nativas.

• Jammy Full: Inclui a maioria das bibliotecas e é adequado para aplicativos com extensões nativas. Por exemplo, inclui uma biblioteca mais completa de fontes. Se seu aplicativo depende da extensão nativa, use a Full pilha.

  • Node.js ou aplicativos Python com extensões nativas.

Para obter mais informações, consulte Ubuntu Stacks na documentação do VMware.

Gerenciar o registro de contêiner

Esta seção mostra como gerenciar o registro de contêiner usado pelo serviço de compilação se você habilitar o serviço de compilação com seu próprio registro de contêiner. Se você habilitar o serviço de compilação com um registro de contêiner gerenciado do Azure Spring Apps, poderá ignorar esta seção.

Depois de habilitar um registro de contêiner de usuário com o serviço de compilação, você pode mostrar e configurar o registro usando o portal do Azure ou a CLI do Azure.

az spring container-registry list \
    --resource-group <resource-group-name> \
    --service <Azure-Spring-Apps-instance-name> 

az spring container-registry show \
    --resource-group <resource-group-name> \
    --service <Azure-Spring-Apps-instance-name> \
    --name <your-container-registry-name>

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

az spring container-registry delete \
    --resource-group <resource-group-name> \
    --service <Azure-Spring-Apps-instance-name> \
    --name <your-container-registry-name> 

O serviço de compilação pode usar um registro de contêiner e também pode alterar o registro de contêiner associado. Este processo é demorado. Quando a alteração acontece, todos os recursos do construtor e da compilação sob o serviço de compilação são reconstruídos e, em seguida, as imagens de contêiner finais são enviadas por push para o novo registro de contêiner.

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

az spring build-service update \
    --resource-group <resource-group-name> \
    --service <Azure-Spring-Apps-instance-name> \
    --registry-name <your-container-registry-name> 

Crie e implante aplicativos poliglotas

Você pode criar e implantar aplicativos poliglotas das seguintes maneiras usando o registro de contêiner:

• Para o serviço de compilação usando o registro de contêiner gerenciado do Azure Spring Apps, você pode criar um aplicativo em uma imagem e, em seguida, implantá-lo na instância de serviço atual do Azure Spring Apps. A compilação e a implantação são executadas juntas usando o az spring app deploy comando.

• Para o serviço de compilação usando um registro de contêiner gerenciado pelo usuário, você pode criar um aplicativo em uma imagem de contêiner e, em seguida, implantar a imagem na instância atual do Azure Spring Apps Enterprise e em outras instâncias. Os comandos build e deploy são separados. Você pode usar o comando build para criar ou atualizar uma compilação e, em seguida, usar o comando deploy para implantar a imagem de contêiner na instância de serviço.

Para obter mais informações, consulte a seção Build service on demand de Use Tanzu Build Service.

Os exemplos a seguir mostram alguns comandos de compilação úteis para usar.

az configure --defaults group=<resource-group-name> spring=<service-name>

az spring build-service build list
az spring build-service build show --name <build-name>
az spring build-service build create --name <build-name> --artifact-path <artifact-path>
az spring build-service build update --name <build-name> --artifact-path <artifact-path>
az spring build-service build delete --name <build-name>

Os seguintes exemplos da CLI do Azure mostram a criação e a implantação de um arquivo de artefato para dois cenários de registro de contêiner:

• Registro de contêiner gerenciado do Azure Spring Apps.
• Registro de contêiner gerenciado pelo usuário.

az spring app deploy \
    --resource-group <resource-group-name> \
    --service <Azure-Spring-Apps-instance-name> \
    --name <app-name> \
    --builder <builder-name> \
    --artifact-path <path-to-your-JAR-file>

az spring build-service build create \
    --resource-group <resource-group-name> \
    --service <Azure-Spring-Apps-instance-name> \
    --name <build-name> \
    --builder <builder-name> \
    --artifact-path <path-to-your-JAR-file>

az spring build-service build update \
    --resource-group <resource-group-name> \
    --service <Azure-Spring-Apps-instance-name> \
    --name <build-name> \
    --builder <builder-name> \
    --artifact-path <path-to-your-JAR-file>

az spring app deploy \
   --resource-group <resource-group-name> \
   --service <Azure-Spring-Apps-instance-name> \
   --name <app-name> \
   --container-image <your-container-image> \
   --container-registry <your-container-registry> \
   --registry-password <your-password> \
   --registry-username <your-username>

Se você implantar o aplicativo com um arquivo de artefato, use --artifact-path para especificar o caminho do arquivo. Ambos os arquivos JAR e WAR são aceitáveis.

Se a CLI do Azure detetar o pacote WAR como um JAR fino, use --disable-validation para desabilitar a validação.

O exemplo a seguir implanta a pasta de código-fonte em uma implantação ativa usando o --source-path parâmetro para especificar a pasta.

az spring app deploy \
    --resource-group <resource-group-name> \
    --service <Azure-Spring-Apps-instance-name> \
    --name <app-name> \
    --builder <builder-name> \
    --source-path <path-to-source-code>

az spring build-service build create \
   --resource-group <resource-group-name> \
   --service <Azure-Spring-Apps-instance-name> \
    --name <build-name> \
    --builder <builder-name> \
    --source-path <path-to-source-code>

az spring build-service build update \
    --resource-group <resource-group-name> \
    --service <Azure-Spring-Apps-instance-name> \
    --name <build-name> \
    --builder <builder-name> \
    --source-path <path-to-source-code>

Você também pode configurar o ambiente de compilação para criar o aplicativo. Por exemplo, em um aplicativo Java, você pode especificar a versão JDK usando o ambiente de BP_JVM_VERSION compilação.

Para especificar ambientes de compilação, use --build-env, conforme mostrado no exemplo a seguir. As variáveis de ambiente de compilação disponíveis são descritas posteriormente neste artigo.

az spring app deploy \
    --resource-group <resource-group-name> \
    --service <Azure-Spring-Apps-instance-name> \
    --name <app-name> \
    --build-env <key1=value1> <key2=value2> \
    --builder <builder-name> \
    --artifact-path <path-to-your-JAR-file>

az spring build-service build create \
    --resource-group <resource-group-name> \
    --service <Azure-Spring-Apps-instance-name> \
    --name <build-name> \
    --build-env <key1=value1> <key2=value2> \
    --builder <builder-name> \
    --artifact-path <path-to-your-JAR-file>

az spring build-service build update \
    --resource-group <resource-group-name> \
    --service <Azure-Spring-Apps-instance-name> \
    --name <build-name> \
    --build-env <key1=value1> <key2=value2> \
    --builder <builder-name> \
    --artifact-path <path-to-your-JAR-file>

Para cada compilação, você também pode especificar os recursos de compilação, conforme mostrado no exemplo a seguir.

az spring app deploy \
    --resource-group <resource-group-name> \
    --service <Azure-Spring-Apps-instance-name> \
    --name <app-name> \
    --build-env <key1=value1> <key2=value2> \
    --build-cpu <build-cpu-size> \
    --build-memory <build-memory-size> \
    --builder <builder-name> \
    --artifact-path <path-to-your-JAR-file>

az spring build-service build create \
    --resource-group <resource-group-name> \
    --service <Azure-Spring-Apps-instance-name> \
    --name <build-name> \
    --build-env <key1=value1> <key2=value2> \
    --build-cpu <build-cpu-size> \
    --build-memory <build-memory-size> \
    --builder <builder-name> \
    --artifact-path <path-to-your-JAR-file>

az spring build-service build update \
    --resource-group <resource-group-name> \
    --service <Azure-Spring-Apps-instance-name> \
    --name <build-name> \
    --build-env <key1=value1> <key2=value2> \
    --build-cpu <build-cpu-size> \
    --build-memory <build-memory-size> \
    --builder <builder-name> \
    --artifact-path <path-to-your-JAR-file>

O recurso de CPU/memória de compilação padrão é 1 vCPU, 2 Gi. Se o seu aplicativo precisar de uma quantidade menor ou maior de memória, use --build-memory para especificar os recursos de memória - por exemplo, 500Mi, , 1Gi2Gi, e assim por diante. Se seu aplicativo precisar de uma quantidade menor ou maior de recursos da CPU, use --build-cpu para especificar os recursos da CPU - por exemplo, 500m, , 12, e assim por diante. O limite máximo de recursos de CPU/memória para uma compilação é 8 vCPU, 16Gi.

Os recursos de CPU e memória são limitados pelo tamanho do pool de agentes de serviço de compilação. Para obter mais informações, consulte a seção Pool de agentes de compilação de Usar o Tanzu Build Service. A soma da cota de recursos de compilação de processamento não pode exceder o tamanho do pool de agentes.

O número paralelo de tarefas de compilação depende do tamanho do pool de agentes e de cada recurso de compilação. Por exemplo, se o recurso de compilação for o padrão 1 vCPU, 2 Gi e o tamanho do pool de agentes for 6 vCPU, 12 Gi, o número de compilação paralelo será 6.

Outras tarefas de compilação são bloqueadas por um tempo devido a limitações de cota de recursos.

Seu aplicativo deve escutar na porta 8080. Os aplicativos Spring Boot substituem o para usar o SERVER_PORT 8080 automaticamente.

Idiomas suportados para implantações

A tabela a seguir indica os recursos suportados para cada idioma.

Para obter mais informações sobre as configurações suportadas para aplicativos de idiomas diferentes, consulte a seção correspondente mais adiante neste artigo.

Limitações do Java Native Image

Native Image é uma tecnologia para compilar código Java antecipadamente para um executável nativo. As imagens nativas oferecem várias vantagens, como uma inicialização instantânea e consumo de memória reduzido. Você pode empacotar imagens nativas em uma imagem de contêiner leve para uma implantação mais rápida e eficiente. Devido à Otimização de Mundo Fechado, aplicam-se as seguintes limitações :

• Os seguintes recursos Java requerem configuração em tempo de compilação executável:
  • Carregamento dinâmico de classes
  • Reflexão
  • Proxy dinâmico
  • JNI (Interface Nativa Java)
  • Serialização
• O bytecode não está mais disponível em tempo de execução, portanto, a depuração e o monitoramento com ferramentas direcionadas para a JVMTI não são possíveis.

Os seguintes recursos não são suportados no Azure Spring Apps devido à limitação do Java Native Image. Os Aplicativos de primavera do Azure darão suporte a eles quando a Imagem Nativa Java e a comunidade superarem a limitação.

Implementar aplicações Java

O buildpack para implementar aplicações Java é tanzu-buildpacks/java-azure.

A tabela a seguir lista os recursos suportados no Azure Spring Apps:

Implantar aplicativos .NET

O buildpack para implantar aplicativos .NET é tanzu-buildpacks/dotnet-core.

A tabela a seguir lista os recursos suportados no Azure Spring Apps:

Implantar aplicativos Python

O buildpack para implantar aplicativos Python é tanzu-buildpacks/python.

A tabela a seguir lista os recursos suportados no Azure Spring Apps:

Implantar aplicativos Go

O buildpack para implantar aplicativos Go é tanzu-buildpacks/go.

A tabela a seguir lista os recursos suportados no Azure Spring Apps:

Implantar aplicativos Node.js

O buildpack para implantar aplicativos Node.js é tanzu-buildpacks/nodejs.

A tabela a seguir lista os recursos suportados no Azure Spring Apps:

Implantar aplicativos WebServer

O buildpack para implantar aplicativos WebServer é tanzu-buildpacks/web-servers.

Para obter mais informações, consulte Implantar arquivos estáticos da Web.

Implementar aplicações Java Native Image (pré-visualização)

O buildpack para implementar aplicações Java Native Image é tanzu-buildpacks/java-native-image.

Você pode implantar aplicativos de imagem nativos do Spring Boot usando o tanzu-buildpacks/java-native-image buildpack. O Spring Native fornece suporte para compilar aplicativos Spring Boot em executáveis nativos. O buildpack usa o Liberica Native Image Kit (NIK) para criar imagens nativas de aplicativos Spring Boot e esses aplicativos são totalmente suportados.

Ao construir uma imagem nativa Java, você deve definir o ambiente BP_NATIVE_IMAGE de compilação para e o recurso de memória de compilação não deve ser inferior a true 8Gi. O tamanho do pool do agente de serviço de compilação não deve ser inferior a 4 vCPU, 8 Gi. Para obter mais informações, consulte a seção Pool de agentes de compilação de Usar o Tanzu Build Service.

Se você quiser construir a imagem nativa em uma imagem de contêiner de tamanho menor, recomendamos usar um construtor com a pilha do Jammy Tiny sistema operacional. Para obter mais informações, consulte a seção Recomendações da pilha do sistema operacional.

A tabela a seguir lista os recursos suportados no Azure Spring Apps:

Existem algumas limitações para Java Native Image. Para obter mais informações, consulte a seção Limitações da imagem nativa do Java.

Implantar aplicativos PHP

O buildpack para implantar aplicativos PHP é tanzu-buildpacks/php.

O buildpack Tanzu PHP é compatível apenas com o Full OS Stack. Recomendamos o uso de um construtor com a pilha do Jammy Full sistema operacional. Para obter mais informações, consulte a seção Recomendações da pilha do sistema operacional.

A tabela a seguir lista os recursos suportados no Azure Spring Apps:

Próximos passos

• Implantar arquivos estáticos da Web