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. |
| Apache Maven | Baixe e instale o Apache 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 verify
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 verify
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.