Compartilhar via

Implantar seu aplicativo no Serviço de Aplicativo do Azure usando FTP/S

Este artigo mostra como usar o FTP (File Transfer Protocol) ou o FTPS (File Transfer Protocol Secure) para implantar seu aplicativo Web, back-end de aplicativo móvel ou aplicativo de API no Serviço de Aplicativo do Azure. Nenhuma configuração é necessária para habilitar a implantação de aplicativos FTP ou FTPS. O endpoint FTP/S para seu aplicativo já está ativo.

Observação

Tanto as Credenciais de Publicação Básica do SCM quanto as Credenciais de Publicação Básica do FTP devem estar habilitadas para que a implantação por FTP/S funcione. Quando a autenticação básica está desabilitada, a implantação de FTP/S não funciona e você não pode exibir ou configurar credenciais FTP/S no Centro de Implantação do aplicativo.

Obter credenciais de implantação

Para obter credenciais para implantação, siga as instruções em Configurar credenciais de implantação para o Serviço de Aplicativo do Azure. Copie as credenciais de escopo do aplicativo para seu aplicativo ou defina e copie as credenciais de escopo do usuário. Você pode se conectar ao ponto de extremidade FTP/S do aplicativo usando qualquer conjunto de credenciais.

Para credenciais de escopo de aplicativo, o formato de nome de usuário FTP/S é <app-name>\$<app-name>. Para credenciais de escopo de usuário, o formato de nome de usuário FTP/S é <app-name>\<username>. Os pontos de extremidade FTP/S do Serviço de Aplicativo são compartilhados entre aplicativos e, como as credenciais no escopo do usuário não estão vinculadas a um recurso específico, você deve adicionar o nome do aplicativo antes do nome de usuário.

Obter o ponto de extremidade FTP/S

Para obter o endereço FTP/S:

Na página do portal do Azure para seu aplicativo, selecione Centro de Implantação em Implantação no menu de navegação à esquerda. Na guia Credenciais do FTPS, copie a URL do Ponto de Extremidade do FTPS.

Implantar arquivos no Azure

Para implantar arquivos no Azure com FTP/S:

  1. No cliente FTP/S, como Visual Studio, Cyberduck ou WinSCP, use suas informações de conexão para se conectar ao seu aplicativo.
  2. Copie seus arquivos e sua estrutura de diretório para o diretório /site/wwwroot no Azure ou no diretório /site/wwwroot/App_Data/Jobs/ para WebJobs.
  3. Navegue até a URL do aplicativo para verificar se ele está sendo executado corretamente.

Observação

Ao contrário da implantação local do Git e da implantação zip, a implantação de FTP/S não dá suporte à automação de build, como:

  • Restauração de dependências como automação NuGet, NPM, PIP e Composer.
  • Compilando binários do .NET.
  • Gerando um arquivo web.config .

Você deve gerar esses arquivos necessários manualmente em seu computador local e implantá-los com seu aplicativo. Para obter um Node.js web.config exemplo, consulte Usando um web.config personalizado para aplicativos node.

Aplicar FTPS

O FTPS é uma forma mais segura de FTP que usa TLS (Transport Layer Security) e SSL (Secure Sockets Layer). Para maior segurança, você deve impor FTPS sobre TLS/SSL. Você também pode desabilitar FTP e FTPS se não usar a implantação de FTP.

Para desabilitar FTP não criptografado:

  1. Na página do portal do Azure para seu aplicativo, selecione Configuração em Configurações no menu de navegação à esquerda.

  2. Na guia Configurações gerais da página Configuração , nas configurações da plataforma, selecione FTPS somente para o estado FTP. Ou para desabilitar o FTP e o FTPS inteiramente, selecione Desabilitado.

    Captura de tela que mostra a configuração do estado FTP apenas para FTPS.

  3. Se você selecionar somente FTPS, certifique-se de que o TLS 1.2 ou superior seja imposto para configurações mínimas de TLS de entrada. O TLS 1.0 e 1.1 não têm suporte apenas para FTPS.

  4. No início da página, selecione Salvar.

Solucionar problemas de implantação de FTP/S

O que acontece com meu aplicativo durante a implantação que pode causar falha ou comportamento imprevisível?

Métodos de implantação com suporte oficial fazem alterações nos arquivos na pasta /home/site/wwwroot usada para executar seu aplicativo. A implantação pode falhar devido a arquivos bloqueados. O aplicativo também poderá se comportar de forma imprevisível durante a implantação se os arquivos não forem todos atualizados ao mesmo tempo, o que é indesejável para um aplicativo voltado para o cliente.

Há algumas maneiras de evitar esses problemas.

Qual é a primeira etapa na solução de problemas de implantação de FTP/S?

A primeira etapa para solucionar problemas de implantação de FTP/S é distinguir entre problemas de implantação e problemas de aplicativo de runtime.

  • Uma questão de implantação geralmente resulta na ausência de arquivos ou na implantação de arquivos incorretos em seu aplicativo. Você pode solucionar problemas investigando sua implantação de FTP/S ou selecionando um caminho de implantação alternativo, como controle do código-fonte.

  • Um problema de aplicativo de runtime normalmente resulta nos arquivos corretos implantados em seu aplicativo, mas no comportamento incorreto do aplicativo. Você pode solucionar problemas focando no comportamento do código em runtime e investigando caminhos de falha específicos.

Para obter mais informações, consulte Problemas de implantação versus runtime.

Por que não posso usar FTP/S e publicar meu código?

Verifique se você inseriu o nome de host e as credenciais corretos. Verifique também se um firewall não está bloqueando as seguintes portas FTP/S em seu computador:

  • Portas de conexão de controle FTP/S: 21, 990
  • Portas de conexão de dados FTP/S: 989, 10001-10300

Como posso me conectar ao FTP/S no Serviço de Aplicativo do Azure por meio do modo passivo?

O Serviço de Aplicativo do Azure dá suporte à conexão por meio de modos ativos e passivos. O modo passivo é preferencial porque os computadores de implantação geralmente estão atrás de um firewall no sistema operacional ou como parte de uma rede doméstica ou comercial. Para obter um exemplo de uma conexão de modo passivo, consulte a página Conexão (caixa de diálogo Configurações avançadas do site).

Por que minha conexão falha ao tentar se conectar via FTPS usando criptografia explícita?

O FTPS permite estabelecer uma conexão de segurança TLS explícita ou implícita.

  • Se você se conectar com criptografia explícita, a conexão será estabelecida por meio da porta 21.
  • Se você se conectar com a criptografia implícita, a conexão será estabelecida por meio da porta 990.

O formato de URL usado pode afetar o êxito da conexão e depende do aplicativo cliente. O portal mostra a URL como ftps://, mas se a URL com a qual você se conecta começar ftp://, a conexão estará implícita na porta 21. Se a URL começar com ftps://, a conexão será implicitamente direcionada para a porta 990.

Certifique-se de não misturar as configurações, como tentar se conectar a ftps:// usando a porta 21. Essa configuração falha ao se conectar mesmo usando criptografia explícita, porque uma conexão explícita começa como uma conexão FTP simples antes do AUTH método.

Como posso determinar qual método foi usado para implantar meu aplicativo?

Você pode descobrir como um aplicativo foi implantado verificando as configurações do aplicativo em sua página do portal do Azure. Selecione variáveis de ambiente em Configurações no menu de navegação à esquerda. Na guia Configurações do aplicativo :

  • Se o aplicativo tiver sido implantado usando uma URL de pacote externo, a WEBSITE_RUN_FROM_PACKAGE configuração será exibida nas configurações do aplicativo com um valor de URL.
  • Se o aplicativo tiver sido implantado usando o ZIP deploy, a configuração WEBSITE_RUN_FROM_PACKAGE será exibida com um valor de 1.

Se você implantou o aplicativo usando o Azure DevOps, poderá ver o histórico de implantação no portal do Azure DevOps. Se você usou as Ferramentas Principais do Azure Functions, poderá ver o histórico de implantação no portal do Azure.