Implantar e configurar um aplicativo Tomcat, JBoss ou Java SE no Serviço de Aplicativo do Azure

Este artigo mostra a configuração de implementação e tempo de execução mais comum para aplicativos Java no Serviço de Aplicativo. Se você nunca usou o Serviço de Aplicativo do Azure, leia primeiro o início rápido do Java. Perguntas gerais sobre o uso do Serviço de Aplicativo que não são específicas do desenvolvimento Java são respondidas nas Perguntas frequentes do Serviço de Aplicativo.

O Serviço de Aplicativo do Azure executa aplicativos Web Java em um serviço totalmente gerenciado em três variantes:

• Java SE - Pode executar um aplicativo implantado como um pacote JAR que contém um servidor incorporado (como Spring Boot, Dropwizard, Quarkus ou um com um servidor Tomcat ou Jetty incorporado).
• Tomcat - O servidor Tomcat integrado pode executar um aplicativo implantado como um pacote WAR.
• JBoss EAP - Suportado apenas para aplicativos Linux nos níveis de preços Premium v3 e Isolated v2. O servidor JBoss EAP integrado pode executar um aplicativo implantado como um pacote WAR ou EAR.

Mostrar versão do Java

az webapp config show --resource-group <resource-group-name> --name <app-name> --query linuxFxVersion

az webapp list-runtimes --os linux | grep "JAVA\|TOMCAT\|JBOSSEAP"

az webapp config show --name <app-name> --resource-group <resource-group-name> --query "[javaVersion, javaContainer, javaContainerVersion]"

az webapp list-runtimes --os windows | grep java

Para obter mais informações sobre o suporte à versão, consulte Política de suporte ao tempo de execução do idioma do Serviço de Aplicativo.

Implantando seu aplicativo

Build Tools

Maven

Com o plug-in Maven para Aplicativos Web do Azure, você pode preparar seu projeto Maven Java para o Aplicativo Web do Azure facilmente com um comando na raiz do projeto:

mvn com.microsoft.azure:azure-webapp-maven-plugin:2.13.0:config

Este comando adiciona um plug-in e uma azure-webapp-maven-plugin configuração relacionada, solicitando que você selecione um Aplicativo Web do Azure existente ou crie um novo. Durante a configuração, ele tenta detetar se seu aplicativo deve ser implantado em Java SE, Tomcat ou (somente Linux) JBoss EAP. Em seguida, você pode implantar seu aplicativo Java no Azure usando o seguinte comando:

mvn package azure-webapp:deploy

Aqui está um exemplo de configuração em pom.xml:

<plugin> 
  <groupId>com.microsoft.azure</groupId>  
  <artifactId>azure-webapp-maven-plugin</artifactId>  
  <version>2.11.0</version>  
  <configuration>
    <subscriptionId>111111-11111-11111-1111111</subscriptionId>
    <resourceGroup>spring-boot-xxxxxxxxxx-rg</resourceGroup>
    <appName>spring-boot-xxxxxxxxxx</appName>
    <pricingTier>B2</pricingTier>
    <region>westus</region>
    <runtime>
      <os>Linux</os>      
      <webContainer>Java SE</webContainer>
      <javaVersion>Java 17</javaVersion>
    </runtime>
    <deployment>
      <resources>
        <resource>
          <type>jar</type>
          <directory>${project.basedir}/target</directory>
          <includes>
            <include>*.jar</include>
          </includes>
        </resource>
      </resources>
    </deployment>
  </configuration>
</plugin> 

Gradle

1. Configure o plug-in Gradle para Aplicativos Web do Azure adicionando o plug-in ao seu build.gradle:

   plugins {
     id "com.microsoft.azure.azurewebapp" version "1.10.0"
   }
   

2. Configure os detalhes do seu aplicativo Web. Os recursos correspondentes do Azure são criados se não existirem. Aqui está um exemplo de configuração, para obter detalhes, consulte este documento.

   azurewebapp {
       subscription = '<your subscription id>'
       resourceGroup = '<your resource group>'
       appName = '<your app name>'
       pricingTier = '<price tier like 'P1v2'>'
       region = '<region like 'westus'>'
       runtime {
         os = 'Linux'
         webContainer = 'Tomcat 10.0' // or 'Java SE' if you want to run an executable jar
         javaVersion = 'Java 17'
       }
       appSettings {
           <key> = <value>
       }
       auth {
           type = 'azure_cli' // support azure_cli, oauth2, device_code and service_principal
       }
   }
   

3. Implante com um comando.

   gradle azureWebAppDeploy
   

IDEs

O Azure fornece uma experiência de desenvolvimento perfeita do Java App Service em IDEs Java populares, incluindo:

• VS Code: Java Web Apps com Visual Studio Code
• IntelliJ IDEA:Criar um aplicativo Web Hello World para o Serviço de Aplicativo do Azure usando o IntelliJ
• Eclipse:Criar um aplicativo Web Hello World para o Serviço de Aplicativo do Azure usando o Eclipse

Kudu API

Não implante seu .war ou .jar usando FTP. A ferramenta FTP foi projetada para carregar scripts de inicialização, dependências ou outros arquivos de tempo de execução. Não é a escolha ideal para implantar aplicativos Web.

Reescrever ou redirecionar URL

Para reescrever ou redirecionar URL, use um dos reescritores de URL disponíveis, como UrlRewriteFilter.

Registro em log e depuração de aplicativos

Relatórios de desempenho, visualizações de tráfego e verificações de integridade estão disponíveis para cada aplicativo por meio do portal do Azure. Para obter mais informações, consulte Visão geral do diagnóstico do Serviço de Aplicativo do Azure.

Transmitir registos de diagnóstico em fluxo

az webapp log config --name <app-name> --resource-group <resource-group-name> --docker-container-logging filesystem

az webapp log tail --name <app-name> --resource-group <resource-group-name>

az webapp log config --resource-group <resource-group-name> --name <app-name> --docker-container-logging filesystem --level Verbose

az webapp log tail --resource-group <resource-group-name> --name <app-name>

Para obter mais informações, consulte Transmitir logs no Cloud Shell.

Acesso ao console SSH no Linux

Para abrir uma sessão SSH direta com o seu contentor, a sua aplicação deve estar em execução.

Cole o seguinte URL no browser e substitua <app-name> pelo nome da aplicação:

https://<app-name>.scm.azurewebsites.net/webssh/host

Se ainda não estiver autenticado, é necessário fazê-lo com a sua subscrição do Azure para se ligar. Uma vez autenticado, pode ver uma shell no browser, na qual pode executar comandos dentro do seu contentor.

Para abrir uma sessão SSH remota a partir do computador local, veja Abrir sessão SSH a partir da shell remota.

Ferramentas de solução de problemas do Linux

As imagens Java incorporadas são baseadas no sistema operacional Alpine Linux . Use o gerenciador de apk pacotes para instalar quaisquer ferramentas ou comandos de solução de problemas.

Criador de perfis Java

Todos os tempos de execução Java no Serviço de Aplicativo do Azure vêm com o JDK Flight Recorder para criar o perfil de cargas de trabalho Java. Você pode usá-lo para registrar eventos da JVM, do sistema e do aplicativo e solucionar problemas em seus aplicativos.

Para saber mais sobre o Java Profiler, visite a documentação do Azure Application Insights.

Gravador de voo

Todos os tempos de execução Java no Serviço de Aplicativo vêm com o Java Flight Recorder. Você pode usá-lo para registrar eventos da JVM, do sistema e do aplicativo e solucionar problemas em seus aplicativos Java.

078990bbcd11:/home# jcmd
Picked up JAVA_TOOL_OPTIONS: -Djava.net.preferIPv4Stack=true
147 sun.tools.jcmd.JCmd
116 /home/site/wwwroot/app.jar

jcmd 116 JFR.start name=MyRecording settings=profile duration=30s filename="/home/jfr_example.jfr"

az webapp config appsettings set -g <your_resource_group> -n <your_app_name> --settings JAVA_OPTS=-XX:StartFlightRecording=disk=true,name=continuous_recording,dumponexit=true,maxsize=1024m,maxage=1d

jcmd <pid> JFR.dump name=continuous_recording filename="/home/recording1.jfr"

jcmd <pid> JFR.start name=TimedRecording settings=profile duration=30s filename="C:\home\timed_recording_example.JFR"

Analise .jfr arquivos

Use FTPS para baixar seu arquivo JFR para sua máquina local. Para analisar o arquivo JFR, baixe e instale o Java Mission Control. Para obter instruções sobre o Java Mission Control, consulte a documentação do JMC e as instruções de instalação.

Registo de aplicações

Se seu aplicativo usa Logback ou Log4j para rastreamento, você pode encaminhar esses rastreamentos para revisão no Azure Application Insights usando as instruções de configuração da estrutura de log em Explore Java trace logs in Application Insights.

Personalização e ajuste

O Serviço de Aplicativo do Azure dá suporte ao ajuste e à personalização prontos para uso por meio do portal do Azure e da CLI. Analise os seguintes artigos para obter informações sobre a configuração de aplicativos Web não específicos do Java:

• Definir definições da aplicação
• Configurar um domínio personalizado
• Configurar ligações TLS/SSL
• Adicionar uma CDN
• Configurar o site do Kudu

Copiar conteúdo do aplicativo localmente

Defina a configuração JAVA_COPY_ALL do aplicativo para true copiar o conteúdo do aplicativo para o trabalhador local do sistema de arquivos compartilhado. Essa configuração ajuda a resolver problemas de bloqueio de arquivos.

Definir opções de tempo de execução Java

Para definir a memória alocada ou outras opções de tempo de execução da JVM, crie uma configuração de aplicativo nomeada JAVA_OPTS com as opções. O Serviço de Aplicativo passa essa configuração como uma variável de ambiente para o tempo de execução do Java quando ele é iniciado.

Para definir a configuração do aplicativo a partir do plug-in Maven, adicione tags de configuração/valor na seção do plug-in do Azure. O exemplo a seguir define um tamanho de heap Java mínimo e máximo específico:

<appSettings>
    <property>
        <name>JAVA_OPTS</name>
        <value>-Xms1024m -Xmx1024m</value>
    </property>
</appSettings>

Os desenvolvedores que executam um único aplicativo com um slot de implantação em seu plano do Serviço de Aplicativo podem usar as seguintes opções:

• Instâncias B1 e S1: -Xms1024m -Xmx1024m
• Instâncias B2 e S2: -Xms3072m -Xmx3072m
• Instâncias B3 e S3: -Xms6144m -Xmx6144m
• Instâncias P1v2: -Xms3072m -Xmx3072m
• Instâncias P2v2: -Xms6144m -Xmx6144m
• Instâncias P3v2: -Xms12800m -Xmx12800m
• Instâncias P1v3: -Xms6656m -Xmx6656m
• Instâncias P2v3: -Xms14848m -Xmx14848m
• Instâncias P3v3: -Xms30720m -Xmx30720m
• Instâncias I1: -Xms3072m -Xmx3072m
• Instâncias I2: -Xms6144m -Xmx6144m
• Instâncias I3: -Xms12800m -Xmx12800m
• Instâncias I1v2: -Xms6656m -Xmx6656m
• Instâncias I2v2: -Xms14848m -Xmx14848m
• Instâncias I3v2: -Xms30720m -Xmx30720m

Ao ajustar as configurações de heap de aplicativos, revise os detalhes do plano do Serviço de Aplicativo e leve em consideração as necessidades de vários aplicativos e slots de implantação para encontrar a alocação ideal de memória.

Ativar soquetes da Web

Ative o suporte para soquetes da Web no portal do Azure nas configurações do aplicativo para o aplicativo. Você precisa reiniciar o aplicativo para que a configuração entre em vigor.

Ative o suporte a soquete da Web usando a CLI do Azure com o seguinte comando:

az webapp config set --name <app-name> --resource-group <resource-group-name> --web-sockets-enabled true

Em seguida, reinicie o aplicativo:

az webapp stop --name <app-name> --resource-group <resource-group-name>
az webapp start --name <app-name> --resource-group <resource-group-name>

Definir codificação de caracteres padrão

No portal do Azure, em Configurações do Aplicativo para o aplicativo Web, crie uma nova configuração de aplicativo nomeada JAVA_OPTS com valor -Dfile.encoding=UTF-8.

Como alternativa, você pode definir a configuração do aplicativo usando o plug-in do Serviço de Aplicativo Maven. Adicione o nome da configuração e as tags de valor na configuração do plugin:

<appSettings>
    <property>
        <name>JAVA_OPTS</name>
        <value>-Dfile.encoding=UTF-8</value>
    </property>
</appSettings>

robots933456 nos registos

Pode ver a seguinte mensagem nos registos do contentor:

2019-04-08T14:07:56.641002476Z "-" - - [08/Apr/2019:14:07:56 +0000] "GET /robots933456.txt HTTP/1.1" 404 415 "-" "-"

Pode ignorar esta mensagem. /robots933456.txt é um caminho de URL fictício que o Serviço de Aplicações utiliza para verificar se o contentor consegue satisfazer pedidos. Uma resposta 404 indica simplesmente que o caminho não existe, mas permite que o Serviço de Aplicações saiba que o contentor está em bom estado de funcionamento e pronto para responder aos pedidos.

Escolhendo uma versão de tempo de execução Java

O Serviço de Aplicativo permite que os usuários escolham a versão principal da JVM, como Java 8 ou Java 11, e a versão do patch, como 1.8.0_232 ou 11.0.5. Você também pode optar por ter a versão do patch atualizada automaticamente à medida que novas versões secundárias ficam disponíveis. Na maioria dos casos, os aplicativos de produção devem usar versões JVM de patch fixo. Isso evita interrupções imprevistas durante uma atualização automática da versão do patch. Todos os aplicativos Web Java usam JVMs de 64 bits e não são configuráveis.

Se você optar por fixar a versão secundária, precisará atualizar periodicamente a versão secundária da JVM no aplicativo. Para garantir que seu aplicativo seja executado na versão secundária mais recente, crie um slot de preparo e incremente a versão secundária no slot de preparo. Depois de confirmar que o aplicativo é executado corretamente na nova versão secundária, você pode trocar os slots de preparação e produção.

<Connector port="${port.http}" address="127.0.0.1" maxHttpHeaderSize="16384" compression="on" URIEncoding="UTF-8" connectionTimeout="${site.connectionTimeout}" maxThreads="${catalina.maxThreads}" maxConnections="${catalina.maxConnections}" protocol="HTTP/1.1" redirectPort="8443"/>

az webapp config appsettings set --resource-group myResourceGroup --name myApp --settings WEBSITE_TOMCAT_CONNECTION_TIMEOUT=120000

az webapp config appsettings set --resource-group myResourceGroup --name myApp --settings WEBSITE_CATALINA_MAXTHREADS=100

az webapp config appsettings set --resource-group myResourceGroup --name myApp --settings WEBSITE_CATALINA_MAXCONNECTIONS=5000

<Host appBase="${site.appbase}" xmlBase="${site.xmlbase}" unpackWARs="${site.unpackwars}" workDir="${site.tempdir}" errorReportValveClass="com.microsoft.azure.appservice.AppServiceErrorReportValve" name="localhost" autoDeploy="true">

<Valve prefix="site_access_log.${catalina.instance.name}" pattern="%h %l %u %t &quot;%r&quot; %s %b %D %{x-arr-log-id}i" directory="${site.logdir}/http/RawLogs" maxDays="${site.logRetentionDays}" className="org.apache.catalina.valves.AccessLogValve" suffix=".txt"/>

Próximos passos

Visite o Centro de Desenvolvedores do Azure para Java para encontrar inícios rápidos, tutoriais e documentação de referência Java do Azure.

• FAQ do Serviço de Aplicações no Linux
• Referência de variáveis de ambiente e configurações de aplicativo