Início rápido: iniciar o seu primeiro aplicativo Java nos Aplicativos de Contêiner do Azure

Este artigo mostra como implantar o aplicativo Spring de exemplo PetClinic para ser executado nos Aplicativos de Contêiner do Azure. Em vez de criar manualmente um Dockerfile e usar diretamente um registro de contêiner, você pode implantar seu aplicativo Java diretamente de um Arquivo Java (JAR) ou de um arquivo de aplicativo Web (WAR).

Ao final deste tutorial, você implanta um aplicativo Web, que pode ser gerenciado por meio do portal do Azure.

A imagem a seguir é uma captura de tela da aparência do seu aplicativo depois de implantado no Azure.

Pré-requisitos

Requisito	Instruções
Conta do Azure	Se você não tiver, crie uma conta gratuita. Você precisa da permissão de Colaborador ou Proprietário na assinatura do Azure para continuar. Consulte Atribuir funções do Azure usando o portal do Azure para obter detalhes.
Conta do GitHub	Obtenha uma gratuitamente.
Git	Instale o git
CLI do Azure	Instale a CLI do Azure.
Extensão da CLI de Aplicativos de Contêiner	Use a versão 0.3.47 ou superior. Use o comando az extension add --name containerapp --upgrade --allow-preview para instalar a versão mais recente.
Java	Instale o Java Development Kit. Use a versão 17 ou posterior.
Maven	Instale o Maven.

Preparar o projeto

Clone o aplicativo de exemplo Spring PetClinic para seu computador.

git clone https://github.com/spring-projects/spring-petclinic.git

git clone https://github.com/spring-petclinic/spring-framework-petclinic.git

Compilar o projeto

Altere para a pasta spring-petclinic.

cd spring-petclinic

Limpe a área de build do Maven, compile o código do projeto e crie um arquivo JAR, tudo isso ignorando todos os testes.

mvn clean package -DskipTests

Depois de executar o comando de build, um arquivo chamado petclinic.jar será gerado na pasta /target.

Observação

Se necessário, você pode especificar a versão do Tomcat nas variáveis de ambiente de build do Java.

Altere para a pasta spring-framework-petclinic.

cd spring-framework-petclinic

Limpe a área de build do Maven, compile o código do projeto e crie um arquivo WAR, tudo isso ignorando todos os testes.

mvn clean package -DskipTests

Depois de executar o comando de build, um arquivo chamado petclinic.war é gerado na pasta /target.

Implantar o projeto

Implante o pacote JAR nos Aplicativos de Contêiner do Azure.

Observação

Se necessário, você pode especificar a versão do JDK nas variáveis de ambiente de build do Java.

Agora você pode implantar o arquivo WAR com o comando da CLI az containerapp up.

az containerapp up \
  --name <CONTAINER_APP_NAME> \
  --resource-group <RESOURCE_GROUP> \
  --subscription <SUBSCRIPTION_ID>\
  --location <LOCATION> \
  --environment <ENVIRONMENT_NAME> \
  --artifact <JAR_FILE_PATH_AND_NAME> \
  --ingress external \
  --target-port 8080 \
  --query properties.configuration.ingress.fqdn

Observação

A versão padrão do JDK é 17. Se você precisar alterar a versão do JDK para compatibilidade com o seu aplicativo, poderá usar o argumento --build-env-vars BP_JVM_VERSION=<YOUR_JDK_VERSION> para ajustar o número de versão.

Você pode encontrar mais variáveis de ambiente de build aplicáveis em Variáveis de ambiente de build Java.

Implante o pacote WAR nos Aplicativos de Contêiner do Azure.

Agora você pode implantar o arquivo WAR com o comando da CLI az containerapp up.

az containerapp up \
  --name <CONTAINER_APP_NAME> \
  --resource-group <RESOURCE_GROUP> \
  --subscription <SUBSCRIPTION>\
  --location <LOCATION> \
  --environment <ENVIRONMENT_NAME> \
  --artifact <WAR_FILE_PATH_AND_NAME> \
  --build-env-vars BP_TOMCAT_VERSION=10.* \
  --ingress external \
  --target-port 8080 \
  --query properties.configuration.ingress.fqdn

Observação

A versão padrão do Tomcat é 9. Se você precisar alterar a versão do Tomcat para compatibilidade com seu aplicativo, poderá usar o argumento --build-env-vars BP_TOMCAT_VERSION=<YOUR_TOMCAT_VERSION> para ajustar o número de versão.

Neste exemplo, a versão do Tomcat é definida como 10 (incluindo quaisquer versões secundárias) definindo a variável de ambiente BP_TOMCAT_VERSION=10.*.

Você pode encontrar mais variáveis de ambiente de build aplicáveis em Variáveis de ambiente de build Java.

Verificar o status do aplicativo

Neste exemplo, o comando containerapp up inclui o argumento --query properties.configuration.ingress.fqdn, que retorna o FQDN (nome de domínio totalmente qualificado), também conhecido como URL do aplicativo.

Exiba o aplicativo colando essa URL em um navegador. Seu aplicativo deve ser semelhante à captura de tela a seguir.

Próximas etapas

Variáveis de ambiente de build do Java