Implantar um Aplicativo Web Quarkus no Serviço de Aplicativo do Azure com o Maven

Artigo
04/29/2024

Neste início rápido, você usará o plug-in Maven para Aplicativos Web do Serviço de Aplicativo do Azure para implantar um aplicativo Quarkus no Serviço de Aplicativo do Azure no Linux. Deverá escolher a implementação Java SE em vez de ficheiros Tomcat e WAR se quiser consolidar as dependências, o runtime e a configuração da sua aplicação num único artefacto implementável.

Se não tiver uma subscrição do Azure, crie uma conta gratuita antes de começar.

Pré-requisitos

A CLI do Azure, localmente ou através do Azure Cloud Shell.
Um Java Development Kit (JDK) suportado. Para obter mais informações sobre os JDKs disponíveis para uso ao desenvolver no Azure, consulte Suporte a Java no Azure e Azure Stack.
Apache Maven, versão 3.

A maneira mais simples e fácil de obter o plug-in Maven implantando seu aplicativo Quarkus é usando a CLI do Azure.

Inicie sessão na sua conta do Azure com a CLI do Azure:

az login

Siga as instruções para concluir o processo de início de sessão.

Criar aplicativo de exemplo a partir do MicroProfile Starter

Nesta seção, você criará um aplicativo Quarkus e o testará localmente.

Criar projeto base Java SE 8

Abra um navegador da Web e navegue até o site MicroProfile Starter .

Forneça os seguintes valores para os campos indicados.

Campo	Value
groupId	com.microsoft.azure.samples.quarkus
artifactId	quarkus-hello-azure
Versão do MicroProfile	MP 3,2
Versão Java SE	Java 8
Tempo de execução do MicroProfile	Quarkus
Exemplos de especificações	Métricas, OpenAPI

Selecione DOWNLOAD para baixar o projeto.
Descompacte o arquivo morto; Por exemplo:
```
unzip Quarkus-hello-azure.zip
```

Criar projeto base Java SE 11

Para criar o projeto base Java 11, use o seguinte comando:

mvn io.quarkus:quarkus-maven-plugin:2.6.1.Final:create \
  -DprojectGroupId=com.microsoft.azure.samples.quarkus \
  -DprojectArtifactId=quarkus-hello-azure  \
  -DclassName="com.microsoft.azure.samples.quarkus.App" \
  -Dpath="/hello"

Execute o aplicativo no ambiente local

Mude o diretório para o projeto concluído. Por exemplo:
```
cd quarkus-hello-azure/
```
Construir e executar o projeto usando Maven; Por exemplo:
```
mvn quarkus:dev
```
Teste o aplicativo Web navegando até ele localmente usando um navegador da Web. Por exemplo, pode utilizar o seguinte comando se tiver o comando curl disponível:

Para o projeto Java SE 8:
```
curl http://localhost:8080/data/hello
```
Para o projeto Java SE 11:
```
curl localhost:8080/hello
```
Você verá a seguinte mensagem exibida: Hello World ou hello

Configurar o Plug-in do Maven para o Serviço de Aplicações do Azure

Nesta seção, você configurará o arquivo de pom.xml do projeto Quarkus para que o Maven possa implantar o aplicativo no Serviço de Aplicativo do Azure no Linux.

Abra o arquivo pom.xml em um editor de código.

<build> Na seção do arquivo pom.xml, insira a seguinte <plugin> entrada dentro da <plugins> tag após maven-surefire-plugin.

<plugin>
  <groupId>com.microsoft.azure</groupId>
  <artifactId>azure-webapp-maven-plugin</artifactId>
  <version>2.5.0</version>
</plugin>

Para configurar a implantação, execute o seguinte comando Maven:

mvn azure-webapp:config

Selecione as seguintes opções quando solicitado:

Campo de entrada	Valor de entrada/seleção
Escolher uma subscrição	Introduza o ID da sua subscrição.
Defina o valor para OS(Padrão: Linux):	2. Linux
Defina value for javaVersion(Default: Java 8):	2. Java 11
Definir valor para pricingTier(Padrão: P1v2):	9. P1v2
Confirme (S/N)	S

Este comando produz uma saída semelhante ao exemplo a seguir:

[INFO] Scanning for projects...
[INFO]
[INFO] ------< com.microsoft.azure.samples.quarkus:quarkus-hello-azure >-------
[INFO] Building quarkus-hello-azure 1.0-SNAPSHOT
[INFO] --------------------------------[ jar ]---------------------------------
[INFO]
[INFO] --- azure-webapp-maven-plugin:2.5.0:config (default-cli) @ quarkus-hello-azure ---
[INFO] Auth type: OAUTH2
Username: abc@xyz.com
Available subscriptions:
*  1: Subscription1(xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxx)
   2: Subscription2(yyyyyyyy-yyyy-yyyy-yyyy-yyyyyyyy)
Please choose a subscription [xxx]: 1
[INFO] Subscription: Subscription1(xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxx)
Define value for OS [Linux]:
  1: Windows
* 2: Linux
  3: Docker
Enter your choice: 2
Define value for javaVersion [Java 8]:
* 1: Java 8
  2: Java 11
  3: Java 17
Enter your choice: 2
Define value for pricingTier [P1v2]:
   1: B1
   2: B2
   3: B3
   4: D1
   5: EP1
   6: EP2
   7: EP3
   8: F1
*  9: P1v2
  10: P1v3
  11: P2v2
  12: P2v3
  13: P3v2
  14: P3v3
  15: S1
  16: S2
  17: S3
  18: Y1
Enter your choice: 9
Please confirm webapp properties
Subscription Id : xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxx
AppName : quarkus-hello-azure-1601011883156
ResourceGroup : quarkus-hello-azure-1601011883156-rg
Region : centralus
PricingTier : P1v2
OS : Linux
Java : Java 11
Web server stack: Java SE
Deploy to slot : false
Confirm (Y/N) [Y]:
[INFO] Saving configuration to pom.
[INFO] ------------------------------------------------------------------------
[INFO] BUILD SUCCESS
[INFO] ------------------------------------------------------------------------
[INFO] Total time:  16.502 s
[INFO] Finished at: 2020-09-25T14:31:34+09:00
[INFO] ------------------------------------------------------------------------

Adicione a <appSettings> seção à <configuration> seção de PORT, WEBSITES_PORTe WEBSITES_CONTAINER_START_TIME_LIMIT. Sua entrada XML para azure-webapp-maven-plugin será semelhante ao exemplo a seguir:

   <plugin>
     <groupId>com.microsoft.azure</groupId>
     <artifactId>azure-webapp-maven-plugin</artifactId>
     <version>2.5.0</version>
     <configuration>
       <schemaVersion>V2</schemaVersion>
       <resourceGroup>microprofile</resourceGroup>
       <appName>quarkus-hello-azure-1591836715762</appName>
       <pricingTier>P1v2</pricingTier>
       <region>centralus</region>
       <runtime>
         <os>linux</os>
         <javaVersion>java 11</javaVersion>
         <webContainer>java SE</webContainer>
       </runtime>
       <appSettings>
         <property>
           <name>PORT</name>
           <value>8080</value>
         </property>
         <property>
           <name>WEBSITES_PORT</name>
           <value>8080</value>
         </property>
         <property>
           <name>WEBSITES_CONTAINER_START_TIME_LIMIT</name>
           <value>600</value>
         </property>
       </appSettings>
       <deployment>
         <resources>
           <resource>
             <directory>${project.basedir}/target</directory>
             <includes>
               <include>*.jar</include>
             </includes>
           </resource>
         </resources>
       </deployment>
     </configuration>
   </plugin>

Adicione a seguinte entrada ao arquivo src/main/resources/application.properties para criar o jar Uber (FAT).
```
quarkus.package.type=uber-jar
```

Implementar a aplicação no Azure

Depois de definir todas as configurações nas seções anteriores deste artigo, você estará pronto para implantar seu aplicativo Web no Azure. Para fazê-lo, siga os seguintes passos:

Se você fez alterações no arquivo pom.xml , reconstrua o arquivo JAR usando o seguinte comando:
```
mvn clean package
```
Implante seu aplicativo Web no Azure usando o seguinte comando:
```
mvn azure-webapp:deploy
```

Se a implantação for bem-sucedida, você verá a seguinte saída:

[INFO] Successfully deployed the artifact to https://quarkus-hello-azure-1591836715762.azurewebsites.net
[INFO] ------------------------------------------------------------------------
[INFO] BUILD SUCCESS
[INFO] ------------------------------------------------------------------------
[INFO] Total time:  02:20 min
[INFO] Finished at: 2020-06-11T10:06:51+09:00
[INFO] ------------------------------------------------------------------------

O Maven implantará seu aplicativo Web no Azure. Se o aplicativo Web ou o plano do aplicativo Web ainda não existir, ele será criado para você. Pode levar alguns minutos até que o aplicativo Web esteja visível na URL mostrada na saída. Navegue até o URL em um navegador da Web. Você deve ver a tela a seguir.

Captura de tela do navegador da Web mostrando a página inicial do Quarkus.

Quando seu aplicativo Web tiver sido implantado, você poderá gerenciá-lo por meio do portal do Azure.

Seu aplicativo Web será listado no grupo de recursos de microperfil .

Você pode acessar seu aplicativo Web selecionando Procurar na página Visão geral do seu aplicativo Web. Verifique se a implantação foi bem-sucedida e está em execução.

Confirmar o fluxo de log do Serviço de Aplicativo em execução

Você pode ver (ou "cauda") os logs do Serviço de Aplicativo em execução. Todas as chamadas no console.log código do site são exibidas no terminal.

az webapp log tail 
    --resource-group microprofile \
    --name quarkus-hello-azure-1601011883156

Clean up resources (Limpar recursos)

Quando os recursos do Azure já não forem necessários, limpe os recursos implementados ao eliminar o grupo de recursos.

No portal do Azure, selecione Grupo de recursos no menu à esquerda.
Insira o microperfil no campo Filtrar por nome, o grupo de recursos criado neste tutorial deve ter esse prefixo.
Selecione o grupo de recursos criado neste tutorial.
Selecione Eliminar grupo de recursos no menu superior.

Próximos passos

Para saber mais sobre o MicroProfile e o Azure, continue para o MicroProfile no centro de documentação do Azure.

MicroProfile no Azure

Recursos adicionais

Para obter mais informações sobre as várias tecnologias mencionadas neste artigo, consulte os seguintes artigos:

Maven Plugin for Azure Web Apps (Plug-in do Maven para Aplicações Web do Azure)
Criar um principal de serviço do Azure com a CLI do Azure 2.0
Referência para as Definições do Maven

Partilhar via

Implantar um Aplicativo Web Quarkus no Serviço de Aplicativo do Azure com o Maven

Pré-requisitos

Criar aplicativo de exemplo a partir do MicroProfile Starter

Criar projeto base Java SE 8

Criar projeto base Java SE 11

Execute o aplicativo no ambiente local

Configurar o Plug-in do Maven para o Serviço de Aplicações do Azure

Implementar a aplicação no Azure

Confirmar o fluxo de log do Serviço de Aplicativo em execução

Clean up resources (Limpar recursos)

Próximos passos

Recursos adicionais

Comentários

Recursos adicionais

Partilhar via

Implantar um Aplicativo Web Quarkus no Serviço de Aplicativo do Azure com o Maven

Pré-requisitos

Iniciar sessão na CLI do Azure

Criar aplicativo de exemplo a partir do MicroProfile Starter

Criar projeto base Java SE 8

Criar projeto base Java SE 11

Execute o aplicativo no ambiente local

Configurar o Plug-in do Maven para o Serviço de Aplicações do Azure

Implementar a aplicação no Azure

Confirmar o fluxo de log do Serviço de Aplicativo em execução

Clean up resources (Limpar recursos)

Próximos passos

Recursos adicionais

Comentários

Recursos adicionais