Guia de Início Rápido: Implantar um arquivo de artefato nos Aplicativos de Contêiner do Azure (versão prévia)
Neste início rápido, você aprenderá a implantar um aplicativo de contêiner de um arquivo de artefato predefinido. 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 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 em Comunicação entre microsserviços para saber como implantar um aplicativo de front-end que chama a API.
A captura de tela a seguir mostra a saída da API do álbum implatado.
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. |
| Java | Instalar o JDK, recomendado o 17 ou posterior |
| Maven | Instale o Maven. |
Instalação
Para entrar no Azure usando a CLIl, execute o comando a seguir 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 dos Aplicativos de Contêiner do Azure para a CLI.
Se você receber erros sobre parâmetros ausentes ao executar comandos az containerapp na CLI do Azure ou cmdlets do módulo Az.App no Azure PowerShell, verifique se está com a versão mais recente da extensão Aplicativos de Contêiner do Azure instalada.
az extension add --name containerapp --upgrade
Observação
A partir de maio de 2024, as extensões da CLI do Azure já não permitem funcionalidades de versão prévia do recurso por padrão. Para acessar as versões prévias dos recursos dos Aplicativos de Contêiner, instale a extensão Aplicativos de Contêiner com --allow-preview true.
az extension add --name containerapp --upgrade --allow-preview true
Agora que a extensão ou módulo atual está instalado, registre os namespaces Microsoft.App 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 foi concluída, você pode definir as variáveis de ambiente que são usadas ao longo deste artigo.
Defina as variáveis a seguir no shell bash.
RESOURCE_GROUP="album-containerapps"
LOCATION="canadacentral"
ENVIRONMENT="env-album-containerapps"
API_NAME="album-api"
SUBSCRIPTION=<YOUR_SUBSCRIPTION_ID>
Se necessário, você pode consultar sua ID de assinatura.
az account list --output table
Preparar o repositório GitHub
Comece com a clonagem do 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
Observação
O exemplo em Java dá suporte apenas a um build do Maven, o que resulta em um arquivo JAR executável. O build usa as configurações padrão, pois não há suporte para a passagem de variáveis de ambiente.
Crie o projeto com o Maven.
mvn clean package -DskipTests
Executar o projeto localmente
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 comando containerapp up.
Esse comando:
- Cria o grupo de recursos
- Cria um Registro de Contêiner do Azure
- Compila a imagem de contêiner e a envia para o registro
- Cria o ambiente para Aplicativos de Contêiner com um workspace do Log Analytics
- Cria e implanta o aplicativo de contêiner usando uma imagem de contêiner pública
O comando up usa o arquivo docker na raiz do repositório para criar a imagem de contêiner. A instrução EXPOSE no arquivo do Docker define a porta de destino. No entanto, não é necessário um arquivo do Docker para criar um aplicativo de contêiner.
Observação
Observação: ao usar containerapp up em combinação com uma base de código sem Docker, use o parâmetro --location para que o 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 implantação
Copie o FQDN para um navegador da Web. No navegador da Web, vá até o ponto de extremidade /albums do FQDN.
Implantar um arquivo WAR
Você também pode implantar seu aplicativo de contêiner de um arquivo WAR.
Limpar os recursos
Se caso não pretende usar esse aplicativo, você pode excluir a instância de Aplicativos de Contêiner do Azure e todos os serviços associados removendo o grupo de recursos.
Siga estas etapas para remover os recursos que você criou:
az group delete \
--resource-group $RESOURCE_GROUP
Dica
Está enfrentando problemas? Deixe-nos saber sobre GitHub abrindo um problema no repositório dos Aplicativos de Contêiner do Azure.