Início Rápido: Criar um aplicativo Java no Serviço de Aplicativo do Azure no WindowsQuickstart: Create a Java app on Azure App Service on Windows

Observação

Este artigo implanta um aplicativo no Serviço de Aplicativo no Windows.This article deploys an app to App Service on Windows. Para implantar o Serviço de Aplicativo no Linux, confira Criar um aplicativo Web Java no Linux.To deploy to App Service on Linux, see Create Java web app on Linux.

O Serviço de Aplicativo do Azure fornece um serviço de hospedagem na Web altamente escalonável e com aplicação automática de patches.Azure App Service provides a highly scalable, self-patching web hosting service. Este início rápido mostra como usar a CLI do Azure com o Plug-in do Maven para o Serviço de Aplicativo do Azure para implantar um arquivo WAR (Arquivo Web) Java.This quickstart shows how to use the Azure CLI with the Maven Plugin for Azure App Service to deploy a Java web archive (WAR) file.

Observação

A mesma coisa também pode ser feita usando IDEs populares, como o IntelliJ e Eclipse.The same thing can also be done using popular IDEs like IntelliJ and Eclipse. Confira nossos documentos semelhantes em Início Rápido: Azure Toolkit for IntelliJ ou Início Rápido: Azure Toolkit for Eclipse.Check out our similar documents at Azure Toolkit for IntelliJ Quickstart or Azure Toolkit for Eclipse Quickstart.

Aplicativo de exemplo em execução no Serviço de Aplicativo do Azure

Se você não tiver uma assinatura do Azure, crie uma conta gratuita antes de começar.If you don't have an Azure subscription, create a free account before you begin.

Usar o Azure Cloud ShellUse Azure Cloud Shell

O Azure hospeda o Azure Cloud Shell, um ambiente de shell interativo que pode ser usado por meio do navegador.Azure hosts Azure Cloud Shell, an interactive shell environment that you can use through your browser. É possível usar o bash ou o PowerShell com o Cloud Shell para trabalhar com os serviços do Azure.You can use either Bash or PowerShell with Cloud Shell to work with Azure services. É possível usar os comandos pré-instalados do Cloud Shell para executar o código neste artigo sem precisar instalar nada no seu ambiente local.You can use the Cloud Shell preinstalled commands to run the code in this article without having to install anything on your local environment.

Para iniciar o Azure Cloud Shell:To start Azure Cloud Shell:

OpçãoOption Exemplo/LinkExample/Link
Selecione Experimente no canto superior direito de um bloco de código.Select Try It in the upper-right corner of a code block. Selecionar Experimente não copia automaticamente o código para o Cloud Shell.Selecting Try It doesn't automatically copy the code to Cloud Shell. Exemplo de “Experimente” no Azure Cloud Shell
Acesse https://shell.azure.com ou selecione o botão Iniciar o Cloud Shell para abri-lo no navegador.Go to https://shell.azure.com, or select the Launch Cloud Shell button to open Cloud Shell in your browser. Inicie o Cloud Shell em uma nova janelaLaunch Cloud Shell in a new window
Clique no botão Cloud Shell na barra de menus no canto superior direito do portal do Azure.Select the Cloud Shell button on the top-right menu bar in the Azure portal. Botão Cloud Shell no portal do Azure

Para executar o código neste artigo no Azure Cloud Shell:To run the code in this article in Azure Cloud Shell:

  1. Inicie o Cloud Shell.Start Cloud Shell.

  2. Clique no botão Copiar no bloco de código para copiá-lo.Select the Copy button on a code block to copy the code.

  3. Cole o código na sessão do Cloud Shell ao pressionar Ctrl+Shift+V no Windows e no Linux ou Cmd+Shift+V no macOS.Paste the code into the Cloud Shell session by selecting Ctrl+Shift+V on Windows and Linux or by selecting Cmd+Shift+V on macOS.

  4. Pressione Enter para executar o código.Select Enter to run the code.

Criar um aplicativo JavaCreate a Java app

Execute o seguinte comando do Maven no prompt do Cloud Shell para criar um aplicativo chamado helloworld:Execute the following Maven command in the Cloud Shell prompt to create a new app named helloworld:

mvn archetype:generate -DgroupId=example.demo -DartifactId=helloworld -DarchetypeArtifactId=maven-archetype-webapp

Configurar o plug-in do MavenConfigure the Maven plugin

Para implantar do Maven, use o editor de códigos no Cloud Shell para abrir arquivo de projeto pom.xml no diretório helloworld.To deploy from Maven, use the code editor in the Cloud Shell to open up the project pom.xml file in the helloworld directory.

code pom.xml

Em seguida, adicione a seguinte definição de plug-in ao elemento <build> do arquivo pom.xml.Then add the following plugin definition inside the <build> element of the pom.xml file.

<plugins>
    <!--*************************************************-->
    <!-- Deploy to Tomcat in App Service Windows         -->
    <!--*************************************************-->
    <plugin>
        <groupId>com.microsoft.azure</groupId>
        <artifactId>azure-webapp-maven-plugin</artifactId>
        <version>1.8.0</version>
        <configuration>
            <!-- Specify v2 schema -->
            <schemaVersion>v2</schemaVersion>
            <!-- App information -->
            <subscriptionId>SUBSCRIPTION_ID</subscriptionId>
            <resourceGroup>RESOURCEGROUP_NAME</resourceGroup>
            <appName>WEBAPP_NAME</appName>
            <region>REGION</region>
            <!-- Java Runtime Stack for App Service on Windows-->
            <runtime>
                <os>windows</os>
                <javaVersion>1.8</javaVersion>
                <webContainer>tomcat 9.0</webContainer>
            </runtime>
            <deployment>
                <resources>
                    <resource>
                        <directory>${project.basedir}/target</directory>
                        <includes>
                            <include>*.war</include>
                        </includes>
                    </resource>
                </resources>
            </deployment>
        </configuration>
    </plugin>
</plugins>

Observação

Neste artigo, estamos trabalhando apenas com aplicativos Java empacotados em arquivos WAR.In this article we are only working with Java apps packaged in WAR files. O plug-in também oferece suporte a aplicativos Web JAR, visite Implantar um arquivo JAR do Java SE para o Serviço de Aplicativo no Linux para experimentá-lo.The plugin also supports JAR web applications, visit Deploy a Java SE JAR file to App Service on Linux to try it out.

Atualize os seguintes espaços reservados na configuração do plug-in:Update the following placeholders in the plugin configuration:

PlaceholderPlaceholder DESCRIÇÃODescription
SUBSCRIPTION_ID A ID exclusiva da assinatura em que você deseja implantar seu aplicativo.The unique ID of the subscription you want to deploy your app to. A ID da assinatura padrão pode ser encontrada no Cloud Shell ou na CLI usando o comando az account show.Default subscription's ID can be found from the Cloud Shell or CLI using the az account show command. Para todas as assinaturas disponíveis, use o comando az account list.For all the available subscriptions, use the az account list command.
RESOURCEGROUP_NAME Nome do novo grupo de recursos no qual criar o aplicativo.Name for the new resource group in which to create your app. Ao colocar todos os recursos para um aplicativo em um grupo, você pode gerenciá-los juntos.By putting all the resources for an app in a group, you can manage them together. Por exemplo, excluir o grupo de recursos excluiria todos os recursos associados ao aplicativo.For example, deleting the resource group would delete all resources associated with the app. Atualize esse valor com um novo nome de grupo de recursos exclusivo, por exemplo, myResourcesGroup.Update this value with a unique new resource group name, for example, myResourceGroup. Você usará esse nome de grupo de recursos para limpar todos os recursos do Azure em uma seção posterior.You will use this resource group name to clean up all Azure resources in a later section.
WEBAPP_NAME O nome do aplicativo fará parte do nome do host do aplicativo quando implantado no Azure (NOME_APLICATIVO_WEB.azurewebsites.net).The app name will be part of the host name for the app when deployed to Azure (WEBAPP_NAME.azurewebsites.net). Atualize esse valor com um nome exclusivo para o novo aplicativo do Serviço de Aplicativo, que hospedará o aplicativo Java, por exemplo, contoso.Update this value with a unique name for the new App Service app, which will host your Java app, for example contoso.
REGION Uma região do Azure na qual o aplicativo está hospedado, por exemplo, westus2.An Azure region where the app is hosted, for example westus2. Você pode obter uma lista de regiões do Cloud Shell ou da CLI usando o comando az account list-locations.You can get a list of regions from the Cloud Shell or CLI using the az account list-locations command.

Implantar o aplicativoDeploy the app

Implante seu aplicativo Java no Azure usando o seguinte comando:Deploy your Java app to Azure using the following command:

mvn package azure-webapp:deploy

Após a conclusão da implantação, navegue até o aplicativo implantado usando a URL a seguir no navegador da Web, por exemplo, http://<webapp>.azurewebsites.net/.Once deployment has completed, browse to the deployed application using the following URL in your web browser, for example http://<webapp>.azurewebsites.net/.

Aplicativo de exemplo em execução no Serviço de Aplicativo do Azure

Parabéns!Congratulations! Você implantou seu primeiro aplicativo Java no Serviço de Aplicativo no Windows.You've deployed your first Java app to App Service on Windows.

Limpar recursosClean up resources

Nas etapas anteriores, você criou os recursos do Azure em um grupo de recursos.In the preceding steps, you created Azure resources in a resource group. Se você acha que não precisará desses recursos no futuro, exclua o grupo de recursos executando o seguinte comando no Cloud Shell:If you don't expect to need these resources in the future, delete the resource group by running the following command in the Cloud Shell:

az group delete --name myResourceGroup

Esse comando pode demorar um pouco para ser executado.This command may take a minute to run.

Próximas etapasNext steps