Guia de início rápido: criar um aplicativo Java no Serviço de Aplicativo do Azure

O Serviço de Aplicativo do Azure fornece um serviço de hospedagem de aplicativo Web altamente escalável e auto-patching. Neste início rápido, você usa o plug-in Maven para Aplicativos Web do Serviço de Aplicativo do Azure para implantar um aplicativo Web Java em um servidor Tomcat Linux no Serviço de Aplicativo do Azure.

Se o Maven não for sua ferramenta de desenvolvimento preferida, confira artigos semelhantes para desenvolvedores Java:

• Gradle
• IntelliJ IDEIA
• Eclipse
• Código do Visual Studio

Pré-requisitos

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

• Execute os comandos neste início rápido usando o Azure Cloud Shell, um shell interativo que você pode usar por meio do navegador para trabalhar com os serviços do Azure. Para usar o Cloud Shell:

  1. Selecione o seguinte botão Iniciar o Cloud Shell ou vá para https://shell.azure.com abrir o Cloud Shell no seu navegador.

     

  2. Inicie sessão no Azure, se necessário, e certifique-se de que está no ambiente Bash do Cloud Shell.

  3. Selecione Copiar em um bloco de código, cole o código no Cloud Shell e execute-o.

Criar uma aplicação em Java

Execute o seguinte comando Maven no Cloud Shell para criar um novo aplicativo chamado helloworld:

mvn archetype:generate "-DgroupId=example.demo" "-DartifactId=helloworld" "-DarchetypeArtifactId=maven-archetype-webapp" "-DarchetypeVersion=1.4" "-Dversion=1.0-SNAPSHOT"

Em seguida, altere seu diretório de trabalho para a pasta do projeto executando cd helloworld.

Configurar o plugin Maven

O processo de implantação do Serviço de Aplicativo usa suas credenciais do Azure do Cloud Shell automaticamente. O plug-in Maven é autenticado com OAuth ou login de dispositivo. Para obter mais informações, veja Autenticação.

Execute o seguinte comando Maven para configurar a implantação definindo o sistema operacional do Serviço de Aplicativo, a versão Java e a versão do Tomcat.

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

1. Para Criar nova configuração de execução, digite Y e pressione Enter.
2. Para Definir valor para SO, digite 2 para Linux e pressione Enter.
3. Para Definir valor para javaVersion, digite 1 para Java 21 e pressione Enter.
4. Em Define value for webContainer, digite 1 para Tomcat 10.1 e pressione Enter.
5. Em Define value for pricingTier, digite 3 para P1V2 e pressione Enter.
6. Em Confirmar, digite Y e pressione Enter.

A saída deve ser semelhante ao seguinte código:

Please confirm webapp properties
AppName : helloworld-1745408005556
ResourceGroup : helloworld-1745408005556-rg
Region : centralus
PricingTier : P1V2
OS : Linux
Java Version: Java 21
Web server stack: Tomcat 10.1
Deploy to slot : false
Confirm (Y/N) [Y]: 
[INFO] Saving configuration to pom.
[INFO] ------------------------------------------------------------------------
[INFO] BUILD SUCCESS
[INFO] ------------------------------------------------------------------------
[INFO] Total time:  01:36 min
[INFO] Finished at: 2025-04-23T11:34:44Z
[INFO] ------------------------------------------------------------------------

Depois de confirmar suas escolhas, o plug-in adiciona o elemento plug-in e as configurações necessárias ao arquivo pom.xml do projeto, que configura seu aplicativo Web para ser executado no Serviço de Aplicativo.

A parte relevante do arquivo pom.xml deve ser semelhante ao exemplo a seguir.

<build>
    <plugins>
        <plugin>
            <groupId>com.microsoft.azure</groupId>
            <artifactId>>azure-webapp-maven-plugin</artifactId>
            <version>x.xx.x</version>
            <configuration>
                <schemaVersion>v2</schemaVersion>
                <resourceGroup>helloworld-1745408005556-rg</resourceGroup>
                <appName>helloworld-1745408005556</appName>
            ...
            </configuration>
        </plugin>
    </plugins>
</build>

Os valores para <appName> e <resourceGroup>, helloworld-1745408005556 e helloworld-1745408005556-rg para o aplicativo de demonstração, são usados posteriormente.

Você pode modificar as configurações do Serviço de Aplicativo diretamente no arquivo pom.xml .

• Para obter a lista completa de configurações, consulte Configurações comuns.
• Para configurações específicas do Serviço de Aplicativo, consulte Aplicativo Web do Azure: Detalhes de Configuração.

Implantar o aplicativo

Com toda a configuração pronta no arquivo pom.xml , você pode implantar seu aplicativo Java no Azure com o seguinte comando único.

mvn package azure-webapp:deploy

Depois de selecionar em uma lista de assinaturas disponíveis, o Maven implanta no Serviço de Aplicativo do Azure. Quando a implantação for concluída, seu aplicativo estará pronto.

Para esta demonstração, o URL é http://helloworld-1745408005556.azurewebsites.net. Quando você abre o URL com seu navegador da Web local, você verá o seguinte aplicativo:

Parabéns! Você implantou um aplicativo Java no Serviço de Aplicativo.

Limpeza de recursos

Você criou os recursos para este tutorial em um grupo de recursos do Azure. Se você não precisar mais deles, poderá excluir o grupo de recursos e todos os seus recursos executando o seguinte comando da CLI do Azure no Cloud Shell.

az group delete --name helloworld-1745408005556-rg --yes

O comando pode demorar um pouco para ser executado.

O Serviço de Aplicativo do Azure fornece um serviço de hospedagem de aplicativo Web altamente escalável e auto-patching. Neste início rápido, você usa o plug-in Maven para Aplicativos Web do Serviço de Aplicativo do Azure para implantar um aplicativo Web Java com um servidor Spring Boot, Quarkus ou Tomcat incorporado no Serviço de Aplicativo. Para obter mais informações, consulte azure-webapp-maven-plugin.

Se o Maven não for sua ferramenta de desenvolvimento preferida, confira artigos semelhantes para desenvolvedores Java:

• Gradle
• IntelliJ IDEIA
• Eclipse
• Código do Visual Studio

Pré-requisitos

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

• Execute os comandos neste início rápido usando o Azure Cloud Shell, um shell interativo que você pode usar por meio do navegador para trabalhar com os serviços do Azure. Para usar o Cloud Shell:

  1. Selecione o seguinte botão Iniciar o Cloud Shell ou vá para https://shell.azure.com abrir o Cloud Shell no seu navegador.

     

  2. Inicie sessão no Azure, se necessário, e certifique-se de que está no ambiente Bash do Cloud Shell.

  3. Selecione Copiar em um bloco de código, cole o código no Cloud Shell e execute-o.

Obter a aplicação de exemplo

Escolha a guia apropriada e siga as instruções para obter o aplicativo Web Spring Boot, Quarkus ou Tomcat incorporado de exemplo.

Bota de mola

Baixe e extraia o modelo de aplicativo Web padrão do Spring Boot ou clone-o executando o seguinte comando. A execução do comando spring boot new my-webappSpring CLI também clona o aplicativo Web.

git clone https://github.com/rd-1-2022/rest-service my-webapp

Em seguida, altere seu diretório de trabalho para a pasta do projeto executando cd my-webapp.

Quarkus

1. Gere um novo aplicativo Quarkus nomeado quarkus-hello-azure executando o seguinte comando Maven:

   mvn io.quarkus.platform:quarkus-maven-plugin:3.21.3:create \
       -DprojectGroupId=org.acme \
       -DprojectArtifactId=quarkus-hello-azure  \
       -Dextensions='resteasy-reactive'
   

2. Altere seu diretório de trabalho para a pasta do projeto executando cd quarkus-hello-azure.

Tomcat incorporado

1. Baixe e extraia o repositório embeddedTomcatExample ou clone-o localmente executando o seguinte git clone comando.

   git clone https://github.com/Azure-Samples/java-docs-embedded-tomcat
   

2. Altere seu diretório de trabalho para a pasta do projeto executando cd java-docs-embedded-tomcat.

3. Execute o aplicativo usando a classe Tomcat padrão. Veja Main.java no exemplo.

Configurar o plugin Maven

O processo de implantação do Serviço de Aplicativo usa suas credenciais do Azure do Cloud Shell automaticamente. O plug-in Maven é autenticado com OAuth ou login de dispositivo. Para obter mais informações, veja Autenticação.

Execute o seguinte comando Maven para configurar a implementação definindo o sistema operacional do Serviço de Aplicativo e a versão Java.

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

1. Para Criar nova configuração de execução, digite Y e pressione Enter.
2. Para Definir valor para SO, digite 2 para Linux e pressione Enter.
3. Para Definir o valor para javaVersion, digite 1 para Java 21 e, em seguida, pressione Enter.
4. Em Define value for pricingTier, digite 3 para P1v2 e pressione Enter.
5. Em Confirmar, digite Y e pressione Enter.

A saída deve ser semelhante ao seguinte código:

Please confirm webapp properties
AppName : <generated-app-name>
ResourceGroup : <generated-app-name>-rg
Region : centralus
PricingTier : P1v2
OS : Linux
Java Version: Java 21
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:  47.533 s
[INFO] Finished at: 2025-04-23T12:20:08Z
[INFO] ------------------------------------------------------------------------

Depois de confirmar suas escolhas, o plug-in adiciona o elemento plug-in e as configurações necessárias ao arquivo pom.xml do projeto, que configura seu aplicativo Web para ser executado no Serviço de Aplicativo.

A parte relevante do arquivo pom.xml deve ser semelhante ao exemplo a seguir.

<build>
    <plugins>
        <plugin>
            <groupId>com.microsoft.azure</groupId>
            <artifactId>>azure-webapp-maven-plugin</artifactId>
            <version>x.xx.x</version>
            <configuration>
                <schemaVersion>v2</schemaVersion>
                <resourceGroup>generated-app-name-rg</resourceGroup>
                <appName>generated-app-name</appName>
            ...
            </configuration>
        </plugin>
    </plugins>
</build>

Os valores para <appName> e <resourceGroup> são usados posteriormente.

Você pode modificar as configurações do Serviço de Aplicativo diretamente no arquivo pom.xml .

• Para obter a lista completa de configurações, consulte Configurações comuns.
• Para configurações específicas do Serviço de Aplicativo, consulte Aplicativo Web do Azure: Detalhes de Configuração.

Implantar o aplicativo

Com toda a configuração pronta em seu arquivo pom.xml , você pode implantar seu aplicativo Java no Azure.

Bota de mola

1. Crie o arquivo JAR usando o seguinte comando.

    mvn clean package
   

   Gorjeta

   O Spring Boot produz dois arquivos JAR com mvn package, mas o azure-webapp-maven-plugin seleciona o arquivo JAR certo para implantar automaticamente.

2. Implante o aplicativo no Azure usando o seguinte comando:

   mvn azure-webapp:deploy
   

   Depois de selecionar em uma lista de assinaturas disponíveis, o Maven implanta no Serviço de Aplicativo do Azure. Quando a implantação for concluída, seu aplicativo estará pronto e você verá a seguinte saída:

   [INFO] Successfully deployed the artifact to <URL>
   [INFO] ------------------------------------------------------------------------
   [INFO] BUILD SUCCESS
   [INFO] ------------------------------------------------------------------------
   [INFO] Total time:  02:20 min
   [INFO] Finished at: 2023-07-26T12:47:50Z
   [INFO] ------------------------------------------------------------------------
   

3. Abra o domínio padrão do seu aplicativo na página Visão geral no portal do Azure e acrescente /greeting à URL. Você deve ver o seguinte aplicativo:

   

Quarkus

1. Crie o arquivo JAR usando o seguinte comando.

   echo '%prod.quarkus.http.port=${PORT}' >> src/main/resources/application.properties
   mvn clean package -Dquarkus.package.jar.type=uber-jar
   

   Defina a porta Quarkus no arquivo application.properties para a PORT variável de ambiente no contêiner Java do Linux. Dquarkus.package.jar.type=uber-jar diz ao Maven para gerar um Uber-Jar, que inclui todas as dependências no arquivo JAR.

   Gorjeta

   O Quarkus produz dois ficheiros JAR com mvn package, mas azure-webapp-maven-plugin escolhe automaticamente o ficheiro JAR certo para desdobrar.

2. Implante o aplicativo no Azure usando o seguinte comando:

   mvn azure-webapp:deploy
   

   Depois de selecionar em uma lista de assinaturas disponíveis, o Maven implanta no Serviço de Aplicativo do Azure. Quando a implantação for concluída, seu aplicativo estará pronto e você verá a seguinte saída:

   [INFO] Successfully deployed the artifact to <URL>
   [INFO] ------------------------------------------------------------------------
   [INFO] BUILD SUCCESS
   [INFO] ------------------------------------------------------------------------
   [INFO] Total time:  02:20 min
   [INFO] Finished at: 2023-07-26T12:47:50Z
   [INFO] ------------------------------------------------------------------------
   

3. Abra o domínio padrão do seu aplicativo na Visão geral no portal do Azure e acrescente /hello à URL. Você deve ver o seguinte aplicativo:

   

Tomcat incorporado

1. Crie o arquivo JAR usando o seguinte comando.

   mvn clean package
   

   Para fazer com que o aplicativo seja implantado usando o plug-in azure-webapp-maven-plug-in e executado no Serviço de Aplicativo do Azure, o exemplo configura a package meta da seguinte maneira:

   • Cria um único arquivo uber JAR, que contém tudo o que o aplicativo precisa para ser executado.
   • Cria um JAR executável especificando a classe Tomcat como a classe de inicialização.
   • Substitui o artefato original pelo Uber-Jar para garantir que a etapa de implantação implante o arquivo correto.

2. Implante o aplicativo no Azure usando o seguinte comando:

   mvn azure-webapp:deploy
   

   Depois de selecionar em uma lista de assinaturas disponíveis, o Maven implanta no Serviço de Aplicativo do Azure. Quando a implantação for concluída, seu aplicativo estará pronto e você verá a seguinte saída:

   [INFO] Successfully deployed the artifact to <URL>
   [INFO] ------------------------------------------------------------------------
   [INFO] BUILD SUCCESS
   [INFO] ------------------------------------------------------------------------
   [INFO] Total time:  02:20 min
   [INFO] Finished at: 2023-07-26T12:47:50Z
   [INFO] ------------------------------------------------------------------------
   

3. Abra a URL do domínio padrão do seu aplicativo na Visão geral no portal do Azure. Você deve ver o seguinte aplicativo:

   

Parabéns! Você implantou um aplicativo Java no Serviço de Aplicativo.

Limpeza de recursos

Você criou os recursos para este tutorial em um grupo de recursos do Azure. Se você não precisar mais deles, poderá excluir o grupo de recursos e todos os seus recursos executando o seguinte comando da CLI do Azure no Cloud Shell.

az group delete --name <resource group name>  --yes

Por exemplo, execute az group delete --name quarkus-hello-azure-1690375364238-rg --yes. Esse comando pode demorar um pouco para ser executado.

O Serviço de Aplicativo do Azure fornece um serviço de hospedagem de aplicativo Web altamente escalável e auto-patching. Neste início rápido, você usa o plug-in Maven para Aplicativos Web do Serviço de Aplicativo do Azure para implantar um aplicativo Web Java em um servidor Linux JBoss EAP no Serviço de Aplicativo do Azure.

Se o Maven não for sua ferramenta de desenvolvimento preferida, confira artigos semelhantes para desenvolvedores Java:

• Gradle
• IntelliJ IDEIA
• Eclipse
• Código do Visual Studio

Pré-requisitos

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

• Execute os comandos neste início rápido usando o Azure Cloud Shell, um shell interativo que você pode usar por meio do navegador para trabalhar com os serviços do Azure. Para usar o Cloud Shell:

  1. Selecione o seguinte botão Iniciar o Cloud Shell ou vá para https://shell.azure.com abrir o Cloud Shell no seu navegador.

     

  2. Inicie sessão no Azure, se necessário, e certifique-se de que está no ambiente Bash do Cloud Shell.

  3. Selecione Copiar em um bloco de código, cole o código no Cloud Shell e execute-o.

Criar uma aplicação em Java

1. Clone o aplicativo de demonstração da Pet Store.

   git clone https://github.com/Azure-Samples/app-service-java-quickstart
   

2. Altere o diretório para o projeto concluído petstore-ee7 e crie-o.

   cd app-service-java-quickstart
   git checkout 20230308
   cd petstore-ee7
   mvn clean install
   

   Se vir uma mensagem sobre estar num estado detached HEAD, pode ignorá-la. Você não faz nenhuma confirmação do Git neste início rápido, portanto, o estado HEAD destacado é apropriado.

   Gorjeta

   O petstore-ee7 exemplo requer Java 11 ou mais recente. O booty-duke-app-service projeto de exemplo requer Java 17. Se a sua versão instalada do Java for inferior a 17, execute a compilação a partir do diretório petstore-ee7 em vez de no nível superior.

Configurar o plugin Maven

O processo de implantação do Serviço de Aplicativo usa suas credenciais do Azure do Cloud Shell automaticamente. O plug-in Maven é autenticado com OAuth ou login de dispositivo. Para obter mais informações, veja Autenticação.

Execute o seguinte comando Maven para configurar a implementação definindo o sistema operacional do Serviço de Aplicativo, a versão Java e a versão Jbosseap.

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

1. Para Criar nova configuração de execução, digite Y e pressione Enter.
2. Para Definir valor para SO, digite 2 para Linux e pressione Enter.
3. Em Definir valor para javaVersion, digite 2 para Java 17 e pressione a tecla Enter. Se você selecionar Java 21, não verá Jbosseap como uma opção mais tarde.
4. Para Define value for webContainer, digite 4 para Jbosseap 7 e pressione Enter.
5. Em Define value for pricingTier, digite 1 para P1v3 e pressione Enter.
6. Em Confirmar, digite Y e pressione Enter.

A saída deve ser semelhante ao seguinte código:

Please confirm webapp properties
AppName : petstoreee7-1745409173307
ResourceGroup : petstoreee7-1745409173307-rg
Region : centralus
PricingTier : P1v3
OS : Linux
Java Version: Java 17
Web server stack: Jbosseap 4
Deploy to slot : false
Confirm (Y/N) [Y]: 
[INFO] Saving configuration to pom.
[INFO] ------------------------------------------------------------------------
[INFO] BUILD SUCCESS
[INFO] ------------------------------------------------------------------------
[INFO] Total time:  01:36 min
[INFO] Finished at: 2025-04-23T11:54:22Z
[INFO] ------------------------------------------------------------------------

Depois de confirmar suas escolhas, o plug-in adiciona o elemento plug-in e as configurações necessárias ao arquivo pom.xml do projeto, que configura seu aplicativo Web para ser executado no Serviço de Aplicativo.

A parte relevante do arquivo pom.xml deve ser semelhante ao exemplo a seguir.

<build>
    <plugins>
        <plugin>
            <groupId>com.microsoft.azure</groupId>
            <artifactId>>azure-webapp-maven-plugin</artifactId>
            <version>x.xx.x</version>
            <configuration>
                <schemaVersion>v2</schemaVersion>
                <resourceGroup>petstoreee7-1745409173307-rg</resourceGroup>
                <appName>petstoreee7-1745409173307</appName>
            ...
            </configuration>
        </plugin>
    </plugins>
</build>

Os valores para <appName> e <resourceGroup>, petstoreee7-1745409173307 e petstoreee7-1745409173307-rg no aplicativo de demonstração, são usados posteriormente.

Você pode modificar as configurações do Serviço de Aplicativo diretamente no arquivo pom.xml .

• Para obter a lista completa de configurações, consulte Configurações comuns.
• Para configurações específicas do Serviço de Aplicativo, consulte Aplicativo Web do Azure: Detalhes de Configuração.

Implantar o aplicativo

Com toda a configuração pronta em seu arquivo pom.xml , você pode implantar seu aplicativo Java no Azure com o seguinte comando único.

# Disable testing, as it requires Wildfly to be installed locally.
mvn package azure-webapp:deploy -DskipTests

Depois de selecionar em uma lista de assinaturas disponíveis, o Maven implanta no Serviço de Aplicativo do Azure. Quando a implantação for concluída, seu aplicativo estará pronto.

Para este aplicativo de demonstração, o URL é http://petstoreee7-1745409173307.azurewebsites.net. Quando você abre o URL com seu navegador da Web local, você verá o seguinte aplicativo:

Parabéns! Você implantou um aplicativo Java no Serviço de Aplicativo.

Limpeza de recursos

Você criou os recursos para este tutorial em um grupo de recursos do Azure. Se você não precisar mais deles, poderá excluir o grupo de recursos e todos os seus recursos executando o seguinte comando da CLI do Azure no Cloud Shell.

az group delete --name petstoreee7-1745409173307-rg  --yes

O comando pode demorar um pouco para ser executado.

Conteúdo relacionado

• Tutorial: Criar um aplicativo Web Tomcat com o Serviço de Aplicativo do Azure no Linux e no MySQL
• Tutorial: Criar um aplicativo Web Java Spring Boot com o Serviço de Aplicativo do Azure no Linux e no Azure Cosmos DB
• Configurar a implantação contínua no Serviço de Aplicativo do Azure
• Preços do Serviço de Aplicativo do Azure no Linux
• Habilitar o log de diagnóstico para aplicativos no Serviço de Aplicativo do Azure
• Dimensionar um aplicativo no Serviço de Aplicativo do Azure
• Documentação do desenvolvedor do Azure para Java
• Implantar e configurar um aplicativo Java SE, Tomcat ou JBoss EAP no Serviço de Aplicativo do Azure
• Tutorial: Usar um domínio personalizado e um certificado gerenciado para proteger seu aplicativo