Partilhar via

Guia de início rápido: implantar um arquivo de artefato nos Aplicativos de Contêiner do Azure (visualização)

  • Artigo

Neste guia de início rápido, você aprende a implantar um aplicativo de contêiner a partir de um arquivo de artefato pré-criado. O exemplo neste artigo implanta um aplicativo Java usando um arquivo JAR, que inclui um arquivo de manifesto específico do Java. Seu trabalho é criar um serviço de API da Web de back-end que retorna uma coleção estática de álbuns de música. Depois de concluir este início rápido, você pode continuar a Comunicação entre microsserviços para saber como implantar um aplicativo front-end que chama a API.

A captura de tela a seguir mostra a saída do serviço de API de álbum que você implanta.

Captura de tela da resposta do endpoint da API de álbuns.

Pré-requisitos

Requisito Instruções
Conta do Azure Se você não tiver uma, crie uma conta gratuitamente. 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 GitHub Obtenha um gratuitamente.
git Instalar o git
CLI do Azure Instale a CLI do Azure.
Java Instale o JDK, recomende o 17 ou posterior
Maven Instale o Maven.

Configurar

Para entrar no Azure a partir da CLI, execute o seguinte comando e siga os prompts para concluir o processo de autenticação.

az login

Para garantir que você esteja executando a versão mais recente da CLI, execute o comando upgrade.

az upgrade

Em seguida, instale ou atualize a extensão Aplicativos de Contêiner do Azure para a CLI.

Se você receber erros sobre parâmetros ausentes ao executar az containerapp comandos na CLI do Azure ou cmdlets do Az.App módulo no Azure PowerShell, certifique-se de ter a versão mais recente da extensão Aplicativos de Contêiner do Azure instalada.

az extension add --name containerapp --upgrade

Nota

A partir de maio de 2024, as extensões da CLI do Azure não habilitam mais recursos de visualização por padrão. Para acessar os recursos de visualização do Container Apps, instale a extensão Container Apps com --allow-preview trueo .

az extension add --name containerapp --upgrade --allow-preview true

Agora que a extensão ou módulo atual está instalado, registre os Microsoft.App namespaces e Microsoft.OperationalInsights .

az provider register --namespace Microsoft.App

az provider register --namespace Microsoft.OperationalInsights

Criar variáveis de ambiente

Agora que a configuração da CLI do Azure está concluída, você pode definir as variáveis de ambiente usadas ao longo deste artigo.

Defina as seguintes variáveis em seu shell bash.

RESOURCE_GROUP="album-containerapps"
LOCATION="canadacentral"
ENVIRONMENT="env-album-containerapps"
API_NAME="album-api"
SUBSCRIPTION=<YOUR_SUBSCRIPTION_ID>

Se necessário, pode consultar o ID da sua subscrição.

az account list --output table

Preparar o repositório GitHub

Comece clonando o repositório de exemplo.

Use o seguinte comando git para clonar o aplicativo de exemplo na pasta code-to-cloud :

git clone https://github.com/azure-samples/containerapps-albumapi-java code-to-cloud

cd code-to-cloud

Criar um arquivo JAR

Nota

O exemplo Java suporta apenas uma compilação Maven, que resulta em um arquivo JAR executável. A compilação usa configurações padrão, pois não há suporte para a passagem de variáveis de ambiente.

Construa o projeto com o Maven.

mvn clean package -DskipTests

Executar localmente o projeto

java -jar target\containerapps-albumapi-java-0.0.1-SNAPSHOT.jar

Para verificar se o aplicativo está em execução, abra um navegador e vá para http://localhost:8080/albums. A página retorna uma lista dos objetos JSON.

Implantar o artefato

Crie e implante seu primeiro aplicativo de contêiner a partir do arquivo JAR local com o containerapp up comando.

Este comando:

  • Cria o grupo de recursos
  • Cria um Registro de Contêiner do Azure
  • Cria a imagem do contêiner e a envia por push para o registro
  • Cria o ambiente Container Apps com um espaço de trabalho do Log Analytics
  • Cria e implanta o aplicativo de contêiner usando uma imagem de contêiner público

O up comando usa o arquivo Docker na raiz do repositório para criar a imagem do contêiner. A EXPOSE instrução no arquivo Docker define a porta de destino. Um arquivo do Docker, no entanto, não é necessário para criar um aplicativo de contêiner.

Nota

Nota: Ao usar containerapp up em combinação com uma base de código sem Docker, use o parâmetro para que o --location aplicativo seja executado em um local diferente do Leste dos EUA.

az containerapp up \
  --name $API_NAME \
  --resource-group $RESOURCE_GROUP \
  --location $LOCATION \
  --environment $ENVIRONMENT \
  --artifact ./target/containerapps-albumapi-java-0.0.1-SNAPSHOT.jar \
  --ingress external \
  --target-port 8080 \
  --subscription $SUBSCRIPTION

Verificar a implementação

Copie o FQDN para um navegador da Web. No seu navegador da Web, vá para o /albums ponto de extremidade do FQDN.

Captura de tela da resposta do endpoint da API de álbuns.

Implantar um arquivo WAR

Você também pode implantar seu aplicativo de contêiner a partir de um arquivo WAR.

Clean up resources (Limpar recursos)

Se não pretender continuar a utilizar esta aplicação, pode eliminar a instância das Aplicações de Contentor do Azure e todos os serviços associados removendo o grupo de recursos.

Siga estas etapas para remover os recursos criados:

az group delete \
  --resource-group $RESOURCE_GROUP

Gorjeta

Tem problemas? Informe-nos no GitHub abrindo um problema no repositório de Aplicativos de Contêiner do Azure.

Próximos passos

Saiba mais sobre como desenvolver em Java em aplicativos de contêiner