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

Artigo
01/10/2025

Neste início rápido, você usará o Plug-in do Maven para os Aplicativos Web do Serviço de Aplicativo do Azure a fim de implantar um aplicativo KumuluzEE no Serviço de Aplicativo do Azure no Linux. Você escolhe a implantação Java SE em vez dos arquivos Tomcat e WAR quando quiser consolidar as dependências, execução e configuração do aplicativo em um único artefato de implantação.

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

Pré-requisitos

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

A maneira mais simples e fácil de obter o plug-in do Maven implantando seu aplicativo KumuluzEE é usando a CLI do Azure. Entre em sua conta do Azure usando a CLI do Azure:

az login

Siga as instruções para concluir o processo de entrada.

Criar um aplicativo de exemplo do MicroProfile Starter

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

Criar projeto base do Java SE 8

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

Insira ou selecione os valores de campo de acordo com os da tabela a seguir:

Campo	Valor
groupId	com.microsoft.azure.samples.kumuluzee
artifactId	kumuluzEE-hello-azure
Versão do MicroProfile	MP 3.2
Versão do Java SE	Java 8
MicroProfile Runtime	KumuluzEE
Exemplos de especificações	Métricas, OpenAPI

Selecione BAIXAR para baixar o projeto.
Descompacte o arquivo usando o seguinte comando:
```
unzip kumuluzEE-hello-azure.zip
```

Executar o aplicativo em um ambiente local

Altere o diretório para o projeto concluído usando o seguinte comando:
```
cd kumuluzEE-hello-azure/
```
Crie o projeto usando o Maven usando o seguinte comando:
```
mvn clean package
```
Execute o aplicativo usando o seguinte comando:
```
java -jar target/kumuluzEE-hello-azure.jar
```
Teste o aplicativo Web navegando até ele localmente usando um navegador da Web. Por exemplo, você poderá usar o seguinte comando se tiver curl disponível:
```
curl http://localhost:8080/data/hello
```
Você deverá ver a seguinte mensagem exibida: Hello World.

Configurar o plug-in do Maven para o Serviço de Aplicativo do Azure

Nesta seção, você configurará o projeto KumuluzEE pom.xml arquivo 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.

Na seção <build> do arquivo pom.xml, insira a seguinte entrada <plugin> dentro da marca <plugins>:

<build>
  <finalName>kumuluzEE-hello-azure</finalName>
  <plugins>
    <plugin>
      <groupId>com.microsoft.azure</groupId>
      <artifactId>azure-webapp-maven-plugin</artifactId>
      <version>1.10.0</version>
    </plugin>
  </plugins>
</build>

Configure a implantação executando o seguinte comando Maven:

mvn azure-webapp:config

Selecione as seguintes opções quando solicitado:

Campo de entrada	Valor de entrada/seleção
Definir valor para o sistema operacional(Padrão: Linux):	1. linux
Definir valor para javaVersion(Padrão: Java 8):	2. Java 8
Confirmar (Y/N)	y

Esse comando produz uma saída semelhante ao seguinte exemplo:

[INFO] Scanning for projects...
[INFO]
[INFO] ----< com.microsoft.azure.samples.kumuluzee:kumuluzEE-hello-azure >-----
[INFO] Building kumuluzEE-hello-azure 1.0-SNAPSHOT
[INFO] --------------------------------[ jar ]---------------------------------
[INFO]
[INFO] --- azure-webapp-maven-plugin:1.10.0:config (default-cli) @ kumuluzEE-hello-azure ---
1. linux [*]
2. windows
3. docker
Enter index to use: 1
Define value for javaVersion(Default: Java 8):
1. Java 11
2. Java 8 [*]
Enter index to use: 2
Please confirm webapp properties
AppName : kumuluzEE-hello-azure-1601006602397
ResourceGroup : kumuluzEE-hello-azure-1601006602397-rg
Region : westeurope
PricingTier : PremiumV2_P1v2
OS : Linux
RuntimeStack : JAVA 8-jre8
Deploy to slot : false
Confirm (Y/N)? : y
[INFO] Saving configuration to pom.
[INFO] ------------------------------------------------------------------------
[INFO] BUILD SUCCESS
[INFO] ------------------------------------------------------------------------
[INFO] Total time:  44.223 s
[INFO] Finished at: 2020-09-25T13:04:02+09:00
[INFO] ------------------------------------------------------------------------

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

<plugin>
  <groupId>com.microsoft.azure</groupId>
  <artifactId>azure-webapp-maven-plugin</artifactId>
  <version>1.10.0</version>
  <configuration>
    <schemaVersion>V2</schemaVersion>
    <resourceGroup>microprofile</resourceGroup>
    <appName>kumuluzEE-hello-azure-1601006602397</appName>
    <pricingTier>P1v2</pricingTier>
    <region>japaneast</region>
    <runtime>
      <os>linux</os>
      <javaVersion>jre8</javaVersion>
      <webContainer>jre8</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>

Implantar o aplicativo 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 fazer isso, use as seguintes etapas:

No prompt de comando ou na janela do terminal que você estava usando anteriormente, recompile o arquivo JAR usando o Maven, se você fez alterações no arquivo pom.xml, usando o seguinte comando:
```
mvn clean package
```
Implante seu aplicativo Web no Azure usando o seguinte comando Maven:
```
mvn azure-webapp:deploy
```

Caso a implantação tenha sido bem-sucedida, você verá o seguinte resultado:

[INFO] Successfully deployed the artifact to https://kumuluzee-hello-azure-1601006602397.azurewebsites.net
[INFO] ------------------------------------------------------------------------
[INFO] BUILD SUCCESS
[INFO] ------------------------------------------------------------------------
[INFO] Total time:  01:23 min
[INFO] Finished at: 2020-09-25T13:13:14+09:00
[INFO] ------------------------------------------------------------------------

O Maven implanta seu aplicativo Web no Azure. Se o aplicativo Web ou o plano de 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é a URL em um navegador da Web. Você deverá ver a seguinte tela:

Captura de tela do navegador da Web mostrando a primeira página do KumuluzEE.

Depois que seu aplicativo web for implantado, você poderá gerenciá-lo por meio do portal do Azure . Seu aplicativo Web está listado no grupo de recursos microperfil.

Você pode acessar seu aplicativo web selecionando Navegar na página de Visão Geral para o seu aplicativo web. Verifique se a implantação foi bem-sucedida e se está em execução.

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

Você pode usar o comando a seguir para exibir - ou tail - os logs dos Serviços de Aplicativos em execução. Todas as chamadas para console.log no código do site são exibidas no terminal.

az webapp log tail \
    --resource-group microprofile \
    --name kumuluzEE-hello-azure-1601006602397

Limpar recursos

Quando os recursos do Azure não forem mais necessários, limpe os recursos implantados excluindo o grupo de recursos.

No portal do Azure, escolha Grupo de recursos do menu.
Insira 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 Excluir grupo de recursos no menu.

Próximas etapas

Para saber mais sobre o MicroProfile e o Azure, prossiga 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 discutidas neste artigo, consulte os seguintes artigos:

Compartilhar via

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

Pré-requisitos

Criar um aplicativo de exemplo do MicroProfile Starter

Criar projeto base do Java SE 8

Executar o aplicativo em um ambiente local

Configurar o plug-in do Maven para o Serviço de Aplicativo do Azure

Implantar o aplicativo no Azure

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

Limpar recursos

Próximas etapas

Recursos adicionais

Comentários

Recursos adicionais

Compartilhar via

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

Pré-requisitos

Entrar na CLI do Azure

Criar um aplicativo de exemplo do MicroProfile Starter

Criar projeto base do Java SE 8

Executar o aplicativo em um ambiente local

Configurar o plug-in do Maven para o Serviço de Aplicativo do Azure

Implantar o aplicativo no Azure

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

Limpar recursos

Próximas etapas

Recursos adicionais

Comentários

Recursos adicionais