Implantar arquivos no Serviço de Aplicativo do Azure

Este artigo mostra como implantar seu código como um pacote ZIP, WAR, JAR ou EAR para o Serviço de Aplicativo do Azure. Ele também mostra como implantar arquivos individuais no Serviço de Aplicativo, separados do pacote de aplicativos.

Pré-requisitos

Para concluir as etapas neste artigo, crie um aplicativo do Serviço de Aplicativo ou use um aplicativo criado para outro tutorial.

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

Criar um pacote ZIP do projeto

Importante

Ao criar o pacote ZIP para implantação, não inclua o diretório raiz. Inclua apenas os arquivos e diretórios no diretório raiz. Se você baixar um repositório do GitHub como arquivo ZIP, não poderá implantar esse arquivo diretamente no App Service. O GitHub adiciona diretórios aninhados no nível superior, o que não funciona com o App Service.

Em uma janela do terminal local, navegue até o diretório raiz do projeto do aplicativo.

Esse diretório deve conter o arquivo de entrada para seu aplicativo Web, como index.html, index.phpe app.js. Ele também pode conter arquivos de gerenciamento de pacotes, comoproject.json, composer.json, package.jsone bower.jsonrequirements.txt.

Se você não quiser que o Serviço de Aplicativo execute a automação de implantação para você, execute todas as tarefas de build. Por exemplo: npm, , bower, gulp, composere pip. Verifique se você tem todos os arquivos necessários para executar o aplicativo. Esta etapa será necessária se desejar executar o pacote diretamente.

Criar um arquivo zip de tudo em seu projeto. Para projetos dotnet, adicione tudo no diretório de saída do comando dotnet publish, excluindo o próprio diretório de saída. Por exemplo, insira o seguinte comando em seu terminal para criar um pacote ZIP que inclua o conteúdo do diretório atual:

# Bash
zip -r <file-name>.zip .

# PowerShell
Compress-Archive -Path * -DestinationPath <file-name>.zip

Implantar um pacote ZIP

Quando você implanta um pacote ZIP, o Serviço de Aplicativo descompacta seu conteúdo no caminho padrão para seu aplicativo: D:\home\site\wwwroot para Windows e /home/site/wwwroot para Linux.

Essa implantação do pacote ZIP usa o mesmo serviço Kudu que alimenta implementações baseadas em integração contínua. O Kudu dá suporte para a seguinte funcionalidade para a implantação de um pacote ZIP:

• Exclusão de arquivos que sobraram de uma implantação anterior
• Opção para ativar o processo de build padrão, que inclui a restauração do pacote
• Personalização da implantação, incluindo a execução de scripts de implantação
• Logs de implantação
• Um limite de tamanho de pacote de 2.048 megabytes

Observação

Os arquivos no pacote ZIP só serão copiados se seus timestamps não corresponderem ao que já está implantado.

Implantar com a interface do usuário de implantação ZIP no Kudu

1. Abra seu aplicativo no portal do Azure e selecione Ferramentas de Desenvolvimento>Ferramentas Avançadas, depois selecione Ir.
2. No Kudu, selecione Ferramentas>Implantação por push do Zip.
3. Carregue o pacote ZIP criado em Criar um pacote ZIP do projeto. Arraste-o para a área do explorador de arquivos na página da Web.

Quando a implantação está em andamento, um ícone no canto superior direito mostra a porcentagem de progresso. A página também exibe mensagens para a operação abaixo da área do Explorador de Arquivos . Quando a implantação for concluída, a última mensagem deverá dizer "Implantação bem-sucedida".

Esse endpoint não funciona para o Serviço de Aplicativo no Linux atualmente. Considere usar o FTP ou a API de implantação de ZIP em vez disso.

Implantar no Kudu sem usar a interface de implantação do tipo ZIP

CLI do Azure

Implante um pacote ZIP em seu aplicativo Web usando o az webapp deploy comando. O comando da CLI usa a API de publicação do Kudu para implantar os arquivos e pode ser totalmente personalizado.

O exemplo a seguir envia um pacote ZIP por push para seu site. Especifique o caminho para seu pacote ZIP local para --src-path.

az webapp deploy --resource-group <group-name> --name <app-name> --src-path <zip-package-path>

Esse comando reinicia o aplicativo depois de implantar o pacote ZIP.

Azure PowerShell

O exemplo a seguir usa Publish-AzWebapp para carregar o pacote ZIP. Substitua os marcadores de posição para o grupo de recursos, o nome do aplicativo e o caminho do pacote.

Publish-AzWebApp -ResourceGroupName Default-Web-WestUS -Name MyApp -ArchivePath <zip-package-path> 

API do Kudu

O exemplo a seguir usa a ferramenta cURL (URL do cliente) para implantar um pacote ZIP. Se você escolher a autenticação básica, forneça as credenciais de implantação em <username> e <password>.

# Microsoft Entra authentication
TOKEN=$(az account get-access-token --query accessToken | tr -d '"')

curl -X POST \
     -H "Authorization: Bearer $TOKEN" \
     -T @"<zip-package-path>" \
     "https://<URL>/api/publish?type=zip"

# Basic authentication
curl -X POST \
     -u '<username>:<password>' \
     -T "<zip-package-path>" \
     "https://<URL>/api/publish?type=zip"

Observação

Obtenha a URL do Kudu no portal do Azure: abra seu aplicativo e selecione Ferramentas de Desenvolvimento, >Ferramentas Avançadas, e então selecione Go para abrir a URL do Kudu.

Modelo de ARM

Os modelos do ARM (modelos do Azure Resource Manager) só dão suporte a implantações de pacotes hospedados remotamente.

Habilitar a automação de build para implantação ZIP

Por padrão, o mecanismo de implantação assume que um pacote ZIP está pronto para ser executado no estado em que se encontra e não executa nenhuma automação de compilação. Para habilitar a mesma automação de build usada em uma implantação do Git, defina a configuração do SCM_DO_BUILD_DURING_DEPLOYMENT aplicativo. Execute o seguinte comando no Azure Cloud Shell:

az webapp config appsettings set --resource-group <group-name> --name <app-name> --settings SCM_DO_BUILD_DURING_DEPLOYMENT=true

Para obter mais informações, consulte Documentação do Kudu.

Implantar pacotes WAR, JAR ou EAR

Você pode implantar seu pacote WAR, JAR ou EAR no Serviço de Aplicativo para executar seu aplicativo Web Java usando a CLI do Azure, o PowerShell ou a API de publicação do Kudu.

O processo de implantação mostrado aqui coloca o pacote no compartilhamento de conteúdo do aplicativo com a convenção de nomenclatura e a estrutura de diretórios corretas. Para obter mais informações, confira Referência da API de publicação do Kudu. Recomendamos essa abordagem. Se você implantar pacotes WAR, JAR ou EAR usando FTP ou Implantação da Web, poderá ver falhas desconhecidas devido a erros no nome ou na estrutura.

CLI do Azure

Implante um pacote WAR no Tomcat ou JBoss EAP usando o az webapp deploy comando. Especifique o caminho para seu pacote Java local como --src-path.

az webapp deploy --resource-group <group-name> --name <app-name> --src-path ./<package-name>.war

O comando da CLI usa a API de publicação do Kudu para implantar o pacote e pode ser totalmente personalizado.

Azure PowerShell

O exemplo a seguir usa Publish-AzWebapp para carregar o arquivo WAR. Substitua os espaços reservados para o grupo de recursos, o nome do aplicativo e o caminho do pacote. O Azure PowerShell dá suporte apenas a arquivos WAR e JAR.

Publish-AzWebapp -ResourceGroupName <group-name> -Name <app-name> -ArchivePath <package-path>

API do Kudu

O exemplo a seguir usa a ferramenta cURL para implantar um arquivo WAR, JAR ou EAR. Substitua os espaços reservados <caminho do arquivo> e <tipo de pacote> (war, jar, ou ear). Se você escolher a autenticação básica, forneça as credenciais de implantação em <username> e <password>.

# Microsoft Entra authentication
TOKEN=$(az account get-access-token --query accessToken | tr -d '"')

curl -X POST \
     -H "Authorization: Bearer $TOKEN" \
     -T @"<file-path>" \
     "https://<URL>/api/publish?type=<package-type>"

# Basic authentication
curl -X POST \
     -u <username>:<password> \
     -T @"<file-path>" \
     "https://<URL>/api/publish?type=<package-type>"

Observação

Obtenha a URL do Kudu no portal do Azure: abra seu aplicativo e selecione Ferramentas de Desenvolvimento>Ferramentas Avançadas, depois selecione Ir para abrir a URL do Kudu.

Para obter mais informações, confira Referência da API de publicação do Kudu.

Modelo de ARM

Os modelos do ARM só dão suporte a implantações de pacotes hospedados remotamente.

Implantar arquivos individuais

CLI do Azure

Implante um script de inicialização, biblioteca e arquivo estático em seu aplicativo Web usando o az webapp deploy comando com o --type parâmetro.

Se você implantar um script de inicialização dessa forma, o Serviço de Aplicativo usará automaticamente seu script para iniciar o aplicativo.

O comando da CLI usa a API de publicação do Kudu para implantar os arquivos. O comando pode ser totalmente personalizado.

Implantar um script de inicialização

az webapp deploy --resource-group <group-name> --name <app-name> --src-path scripts/startup.sh --type=startup

Implantar um arquivo de biblioteca

az webapp deploy --resource-group <group-name> --name <app-name> --src-path driver.jar --type=lib

Implantar um arquivo estático

az webapp deploy --resource-group <group-name> --name <app-name> --src-path config.json --type=static

Azure PowerShell

Não há suporte. Confira as guias CLI do Azure ou API do Kudu.

API do Kudu

Implantar um script de inicialização

O exemplo a seguir usa a ferramenta cURL para implantar um arquivo de inicialização no seu aplicativo. Substitua o espaço reservado <startup-file-path>. Se você escolher a autenticação básica, forneça as credenciais de implantação em <username> e <password>.

# Microsoft Entra authentication
TOKEN=$(az account get-access-token --query accessToken | tr -d '"')

curl -X POST \
     -H "Authorization: Bearer $TOKEN" \
     -T @"<startup-file-path>" \
     "https://<URL>/api/publish?type=startup"

# Basic authentication
curl -X POST \
     -u <username>:<password> \
     -T @"<startup-file-path>" \
     "https://<URL>/api/publish?type=startup"

Observação

Obtenha a URL do Kudu no portal do Azure: abra seu aplicativo e selecione Ferramentas de Desenvolvimento>Ferramentas Avançadas, depois selecione Ir para abrir a URL do Kudu.

Implantar um arquivo de biblioteca

O exemplo a seguir usa a ferramenta cURL para implantar um arquivo de biblioteca no aplicativo. Substitua o marcador <lib-file-path>. Se você escolher a autenticação básica, forneça as credenciais de implantação em <username> e <password>.

# Microsoft Entra authentication
TOKEN=$(az account get-access-token --query accessToken | tr -d '"')

curl -X POST \
     -H "Authorization: Bearer $TOKEN" \
     -T @"<lib-file-path>" \
     "https://<URL>/api/publish?type=lib&path=/home/site/deployments/tools/my-lib.jar"

# Basic authentication
curl -X POST \
     -u <username>:<password> \
     -T @"<lib-file-path>" \
     "https://<URL>/api/publish?type=lib&path=/home/site/deployments/tools/my-lib.jar"

Observação

Obtenha a URL do Kudu no portal do Azure: abra seu aplicativo e selecione Ferramentas de Desenvolvimento>Ferramentas Avançadas, então selecione Ir para abrir a URL do Kudu.

Implantar um arquivo estático

O exemplo a seguir usa a ferramenta cURL para implantar um arquivo de configuração no aplicativo. Substitua o espaço reservado <config-file-path>. Se você escolher a autenticação básica, forneça as credenciais de implantação em <username> e <password>.

# Microsoft Entra authentication
TOKEN=$(az account get-access-token --query accessToken | tr -d '"')

curl -X POST \
     -H "Authorization: Bearer $TOKEN" \
     -T @"<config-file-path>" \
     "https://<URL>/api/publish?type=static&path=/home/site/deployments/tools/my-config.json"

# Basic authentication
curl -X POST \
     -u <username>:<password> \
     -T @"<config-file-path>" \
     "https://<URL>/api/publish?type=static&path=/home/site/deployments/tools/my-config.json"

Observação

Obtenha a URL do Kudu no portal do Azure: abra seu aplicativo e selecione Ferramentas de Desenvolvimento>Ferramentas Avançadas, depois selecione Ir para abrir a URL do Kudu.

Modelo de ARM

Os modelos do ARM só dão suporte a implantações de pacotes hospedados remotamente.

Implantar em aplicativos protegidos pela rede

Dependendo da configuração de rede do aplicativo Web, o acesso direto ao aplicativo do seu ambiente de desenvolvimento pode ser bloqueado. (Consulte Implantação em sites protegidos pela rede e Implantação em sites protegidos pela rede, parte 2.) Em vez de enviar o pacote ou arquivo diretamente para o aplicativo Web, você pode publicá-lo em um sistema de armazenamento acessível a partir do aplicativo Web e disparar o aplicativo para efetuar pull do ZIP do local de armazenamento.

A URL remota pode ser qualquer local acessível publicamente, mas é melhor usar um contêiner de armazenamento de blobs com uma chave SAS (assinatura de acesso compartilhado) para protegê-la.

CLI do Azure

Use o comando az webapp deploy como faria nas outras seções, mas use --src-url em vez de --src-path. O exemplo a seguir usa o parâmetro --src-url para especificar a URL de um arquivo ZIP hospedado em uma conta de Armazenamento do Microsoft Azure.

az webapp deploy --resource-group <group-name> --name <app-name> --src-url "https://storagesample.blob.core.windows.net/sample-container/myapp.zip?sv=2021-10-01&sb&sig=slk22f3UrS823n4kSh8Skjpa7Naj4CG3 --type zip

Azure PowerShell

Não há suporte. Confira as guias para CLI do Azure, API do Kudu ou modelo do ARM.

API do Kudu

Invoque a API de publicação do Kudu como faria nas outras seções. Em vez de carregar um arquivo, passe um objeto JSON com packageUri no corpo da solicitação. Os exemplos a seguir usam este método para especificar a URL de um arquivo ZIP hospedado em uma conta de Armazenamento do Microsoft Azure. O tipo ainda é especificado como uma string de consulta. Se você escolher a autenticação básica, forneça as credenciais de implantação em <username> e <password>.

# Microsoft Entra authentication
TOKEN=$(az account get-access-token --query accessToken | tr -d '"')

curl -X POST \
     -H "Authorization: Bearer $TOKEN" \
     -H "Content-Type: application/json" \
     -d '{"packageUri": "https://storagesample.blob.core.windows.net/sample-container/myapp.zip?sv=2021-10-01&sb&sig=slk22f3UrS823n4kSh8Skjpa7Naj4CG3"}' \
     "https://<URL>/api/publish?type=zip"

# Basic authentication
curl -X POST \
     -u '<username>:<password>' \
     -H "Content-Type: application/json" \
     -d '{"packageUri": "https://storagesample.blob.core.windows.net/sample-container/myapp.zip?sv=2021-10-01&sb&sig=slk22f3UrS823n4kSh8Skjpa7Naj4CG3"}' \
     "https://<URL>/api/publish?type=zip"

Observação

Obtenha a URL do Kudu no portal do Azure: abra seu aplicativo e selecione Ferramentas de Desenvolvimento>Ferramentas Avançadas, depois selecione Ir para abrir a URL do Kudu.

Modelo de ARM

Adicione o seguinte JSON ao modelo do ARM. Substitua o espaço reservado <app-name>.

{
    "type": "Microsoft.Web/sites/extensions",
    "apiVersion": "2021-03-01",
    "name": "onedeploy",
    "dependsOn": [
        "[resourceId('Microsoft.Web/Sites', <app-name>')]"
    ],
    "properties": {
        "packageUri": "<zip-package-uri>",
        "type": "<type>",
        "path": "<target-path>"
    }
}

Use a referência a seguir para ajudá-lo a configurar as propriedades:

Propriedade	Descrição	Obrigatório
packageUri	O URI do pacote ou arquivo. Para obter mais informações, consulte Microsoft.Web sites/extensions 'onedeploy'.	Sim
type	Consulte o parâmetro type na Referência da API de publicação do Kudu.	Sim
path	Consulte o parâmetro target-path na Referência da API de publicação do Kudu.	Não

Referência da API de publicação do Kudu

A API do Kudu publish permite que você especifique os mesmos parâmetros do comando da CLI que os parâmetros de consulta de URL. Para autenticar com a API REST do Kudu, recomendamos a autenticação por token, mas você também pode usar a autenticação básica com as credenciais de implantação do seu aplicativo.

A tabela a seguir mostra os parâmetros de consulta disponíveis, os valores permitidos e as descrições.

Chave	Valores permitidos	Descrição	Obrigatório	Tipo
type	war|jar|ear|lib|startup|static|zip	Esse é o tipo do artefato que está sendo implantado. Ele define o caminho de destino padrão e informa ao aplicativo Web como a implantação deve ser tratada. type=zip: implante um pacote ZIP descompactando o conteúdo para /home/site/wwwroot. O parâmetro target-path é opcional. type=war: implantar um pacote WAR. Por padrão, o pacote WAR é implantado em /home/site/wwwroot/app.war. O caminho de destino pode ser especificado com target-path. type=jar: implantar um pacote JAR em /home/site/wwwroot/app.jar. O parâmetro target-path é ignorado. type=ear: implante um pacote EAR em /home/site/wwwroot/app.ear. O parâmetro target-path é ignorado. type=lib: implante um arquivo de biblioteca JAR. Por padrão, o arquivo é implantado em /home/site/libs. O caminho de destino pode ser especificado com target-path. type=static: implante um arquivo estático, como um script. Por padrão, o arquivo é implantado em /home/site/wwwroot. type=startup: implante um script que o Serviço de Aplicativo usa automaticamente como o script de inicialização para seu aplicativo. Por padrão, o script é implantado no D:\home\site\scripts\<name-of-source> para o Windows e no home/site/wwwroot/startup.sh para o Linux. O caminho de destino pode ser especificado com target-path.	Sim	Cadeia de caracteres
restart	true|false	Por padrão, a API reinicia o aplicativo após a operação de implantação (restart=true). Ao implantar vários artefatos, você pode impedir reinicializações em todos, exceto na implantação final, definindo restart=false.	Não	Booliano
clean	true|false	Especifica se o destino da implantação deve ser limpo (excluído) antes de implantar o artefato.	Não	Booliano
ignorestack	true|false	A API de publicação usa a variável de ambiente WEBSITE_STACK para escolher os padrões seguros, dependendo da pilha de linguagens do site. Definir esse parâmetro como false desabilita qualquer padrão específico de linguagem.	Não	Booliano
target-path	Um caminho absoluto	O caminho absoluto para implantar o artefato. Por exemplo, /home/site/deployments/tools/driver.jar ou /home/site/scripts/helper.sh.	Não	Cadeia de caracteres

Conteúdo relacionado

Para cenários mais avançados de implantação, tente implantação no Azure com Git. Implantação baseada em Git no Azure permite o controle de versão, restauração do pacote, MSBuild e muito mais.

• Kudu: implantação a partir de um arquivo zip
• Referência de variáveis de ambiente e configurações de aplicativo