Implantar um aplicativo com uma imagem de contêiner personalizada

Este artigo aplica-se a: ✔️ Standard ✔️ Enterprise

Este artigo explica como implantar aplicativos Spring Boot no Azure Spring Apps usando uma imagem de contêiner personalizada. A implantação de um aplicativo com um contêiner personalizado oferece suporte à maioria dos recursos como na implantação de um aplicativo JAR. Outros aplicativos Java e não Java também podem ser implementados com a imagem do contêiner.

Pré-requisitos

• Uma imagem de contêiner contendo o aplicativo.
• A imagem é enviada por push para um registro de imagem. Para obter mais informações, consulte Azure Container Registry.

Implementar a sua aplicação

Para implantar um aplicativo em uma imagem de contêiner personalizada, use as seguintes etapas:

    --container-command "java" \
    --container-args "-jar /app.jar -Dkey=value"

    --disable-probe true

Matriz de suporte a recursos

A matriz a seguir mostra quais recursos são suportados em cada tipo de aplicativo.

Pontos comuns a serem observados ao implantar com um contêiner personalizado

Os pontos a seguir ajudarão você a resolver situações comuns ao implantar com uma imagem personalizada.

Confiar em uma autoridade de certificação

Há duas opções para confiar em uma Autoridade de Certificação:

Opção 1: Carregar através das Aplicações Azure Spring

Para carregar os certificados de CA em seus aplicativos, consulte Usar certificados TLS/SSL em seu aplicativo no Azure Spring Apps. Em seguida, os certs serão montados no local /etc/azure-spring-cloud/certs/public/.

Opção 2: Instalação manual na imagem

Para confiar em uma autoridade de certificação na imagem, defina as seguintes variáveis, dependendo do seu ambiente:

• Você deve importar aplicativos Java para o armazenamento confiável adicionando as seguintes linhas ao seu Dockerfile:

  ADD EnterpriseRootCA.crt /opt/
  RUN keytool -keystore /etc/ssl/certs/java/cacerts -storepass changeit -noprompt -trustcacerts -importcert -alias EnterpriseRootCA -file /opt/EnterpriseRootCA.crt
  

• Para aplicações Node.js, defina a NODE_EXTRA_CA_CERTS variável de ambiente:

  ADD EnterpriseRootCA.crt /opt/
  ENV NODE_EXTRA_CA_CERTS="/opt/EnterpriseRootCA.crt"
  

• Para Python, ou outras linguagens que dependem da loja CA do sistema, em imagens Debian ou Ubuntu, adicione as seguintes variáveis de ambiente:

  ADD EnterpriseRootCA.crt /usr/local/share/ca-certificates/
  RUN /usr/sbin/update-ca-certificates
  

• Para Python ou outras linguagens que dependem do armazenamento CA do sistema, em imagens baseadas em CentOS ou Fedora, adicione as seguintes variáveis de ambiente:

  ADD EnterpriseRootCA.crt /etc/pki/ca-trust/source/anchors/
  RUN /usr/bin/update-ca-trust
  

Evite comportamentos inesperados quando as imagens são alteradas

Quando seu aplicativo é reiniciado ou expandido, a imagem mais recente sempre será extraída. Se a imagem tiver sido alterada, as instâncias de aplicativo recém-iniciadas usarão a nova imagem, enquanto as instâncias antigas continuarão a usar a imagem antiga.

Evite não ser capaz de se conectar ao registro de contêiner em uma VNet

Se você implantou a instância em uma rede virtual, certifique-se de permitir o tráfego de rede para seu registro de contêiner no NSG ou no Firewall do Azure (se usado). Para obter mais informações, consulte Responsabilidades do cliente pela execução em VNet para adicionar as regras de segurança necessárias.

Instalar um APM na imagem manualmente

As etapas de instalação variam em diferentes APMs (Application Performance Monitors) e idiomas. As etapas a seguir são para New Relic com aplicativos Java. Você deve modificar o Dockerfile usando as seguintes etapas:

1. Baixe e instale o arquivo do agente na imagem adicionando o seguinte ao Dockerfile:

   ADD newrelic-agent.jar /opt/agents/newrelic/java/newrelic-agent.jar
   

2. Adicione as variáveis de ambiente exigidas pelo APM:

   ENV NEW_RELIC_APP_NAME=appName
   ENV NEW_RELIC_LICENSE_KEY=newRelicLicenseKey
   

3. Modifique o ponto de entrada da imagem adicionando: java -javaagent:/opt/agents/newrelic/java/newrelic-agent.jar

Para instalar os agentes para outros idiomas, consulte a documentação oficial dos outros agentes:

Nova Relíquia:

• Python: Instale o agente Python
• Node.js: Instalar o agente Node.js

Dynatrace:

• Python: Instrumente aplicações Python com OpenTelemetry
• Node.js: Aplicações de Node.js de instrumentos com OpenTelemetry

AppDynamics:

• Python: Instale o Agente Python
• Node.js: Instalando o Node.js Agent

Ver os registos de contentor

Para exibir os logs do console do seu aplicativo de contêiner, o seguinte comando da CLI pode ser usado:

az spring app logs \
    --resource-group <your-resource-group> \
    --name <your-app-name> \
    --service <your-service-name> \
    --instance <your-instance-name>

Para exibir os logs de eventos de contêiner do Azure Monitor, insira a consulta:

AppPlatformContainerEventLogs
| where App == "hw-20220317-1b"

Analise a sua imagem em busca de vulnerabilidades

Recomendamos que você use o Microsoft Defender for Cloud com ACR para evitar que suas imagens fiquem vulneráveis. Para obter mais informações, consulte Microsoft Defender for Cloud

Alternar entre a implantação do JAR e a implantação do contêiner

Você pode alternar o tipo de implantação de JAR para implantação de contêiner diretamente reimplantando usando o seguinte comando:

az spring app deploy \
    --resource-group <your-resource-group> \
    --name <your-app-name> \
    --container-image <your-container-image> \
    --service <your-service-name>

Ou inversamente:

az spring app deploy \
    --resource-group <your-resource-group> \
    --name <your-app-name> \
    --artifact-path <your-jar-file> \
    --service <your-service-name>

Criar outra implantação com uma implantação JAR existente

Você pode criar outra implantação usando uma implantação JAR existente usando o seguinte comando:

az spring app deployment create \
    --resource-group <your-resource-group> \
    --name <your-deployment-name> \
    --app <your-app-name> \
    --container-image <your-container-image> \
    --service <your-service-name>

CI/CD

A automação de implantações usando Tarefas de Pipelines do Azure ou Ações do GitHub agora é suportada. Para obter mais informações, consulte Automatizar implantações de aplicativos para aplicativos Azure Spring e Usar o Azure Spring Apps CI/CD com ações do GitHub

Próximos passos

• Como capturar lixeiras