Implemente a sua aplicação para Serviço de Aplicações do Azure utilizando FTP/S

Artigo
09/27/2022
5 minutos para ler

Este artigo mostra-lhe como usar FTP ou FTPS para implementar a sua aplicação web, backend de aplicativos móveis ou app API para Serviço de Aplicações do Azure.

O ponto final FTP/S da sua aplicação já está ativo. Não é necessária nenhuma configuração para ativar a implantação FTP/S.

Nota

A página do Centro de Desenvolvimento (Clássico) no portal do Azure, que é a antiga experiência de implantação, será depreciada em março de 2021. Esta alteração não afetará quaisquer definições de implementação existentes na sua aplicação, podendo continuar a gerir a implementação de aplicações na página Do Centro de Implementação .

Obtenha credenciais de implantação

Siga as instruções na Configurar credenciais de implantação para Serviço de Aplicações do Azure copiar as credenciais de aplicação ou definir as credenciais de âmbito do utilizador. Pode ligar-se ao ponto final FTP/S da sua aplicação utilizando ambas as credenciais.
Criar o nome de utilizador FTP no seguinte formato, dependendo da sua escolha de âmbito credencial:

Âmbito de aplicação Âmbito de utilização

<app-name>\$<app-name> <app-name>\<deployment-user>

Em Serviço de Aplicações, o ponto final FTP/S é partilhado entre aplicações. Uma vez que as credenciais de alcance do utilizador não estão ligadas a um recurso específico, é necessário preparar o nome de utilizador do âmbito do utilizador com o nome da aplicação, tal como mostrado acima.

Âmbito de aplicação	Âmbito de utilização
`<app-name>\$<app-name>`	`<app-name>\<deployment-user>`

Obtenha o ponto final FTP/S

Na mesma página de gestão da sua aplicação onde copiou as credenciais de implementação (Deployment Center>FTP Credentials), copie o ponto final FTPS.

Executar o comando de perfis de lista de publicações de listas de webapp az . O exemplo a seguir utiliza uma consulta JMESPath para extrair os pontos finais FTP/S da saída.

az webapp deployment list-publishing-profiles --name <app-name> --resource-group <group-name> --query "[?ends_with(profileName, 'FTP')].{profileName: profileName, publishUrl: publishUrl}"

Cada aplicação tem dois pontos finais FTP/S, uma é de leitura-escrita, enquanto a outra é apenas de leitura (profileName contém ReadOnly) e destina-se a cenários de recuperação de dados. Para implementar ficheiros com FTP, copie o URL do ponto final de leitura-escrita.

Executar o comando Get-AzWebAppPublishingProfile . O exemplo a seguir extrai o ponto final FTP/S da saída XML.

$xml = [xml](Get-AzWebAppPublishingProfile -Name <app-name> -ResourceGroupName <group-name> -OutputFile null)
$xml.SelectNodes("//publishProfile[@publishMethod=`"FTP`"]/@publishUrl").value

Implementar ficheiros para o Azure

Do seu cliente FTP (por exemplo, Visual Studio, Cyberduck ou WinSCP), utilize as informações de ligação que recolheu para ligar à sua aplicação.
Copie os seus ficheiros e a sua respetiva estrutura de diretório para o diretório /site/wwwroot em Azure (ou o /site/wwwroot/App_Data/Jobs/Diretório para WebJobs).
Navegue no URL da sua aplicação para verificar se a aplicação está a funcionar corretamente.

Nota

Ao contrário das implementações baseadas em Git e da implementação zip, a implementação ftp não suporta automação de construção, tais como:

restaurações de dependência (tais como automações NuGet, NPM, PIP e Compositor)
compilação de binários .NET
geração de web.config (aqui está um exemploNode.js)

Gere estes ficheiros necessários manualmente na sua máquina local e, em seguida, desloque-os em conjunto com a sua aplicação.

Impor FTPS

Para uma maior segurança, deve permitir ftp apenas em TLS/SSL. Também pode desativar tanto o FTP como o FTPS se não utilizar a implementação FTP.

Na página de recursos da sua aplicação em portal do Azure, selecione Configurações>Gerais a partir da navegação à esquerda.
Para desativar o FTP não encriptado, selecione FTPS apenas no estado FTP. Para desativar totalmente o FTP e o FTPS, selecione Desativado. Quando terminar, clique em Guardar. Se utilizar apenas o FTPS, tem de impor o TLS 1.2 ou superior navegando para a lâmina de definições TLS/SSL da sua aplicação web. TLS 1.0 e 1.1 não são suportados apenas com FTPS.

Executar o comando de configuração az webapp com o --ftps-state argumento.

az webapp config set --name <app-name> --resource-group <group-name> --ftps-state FtpsOnly

Os valores --ftps-state possíveis são AllAllowed (FTP e FTPS ativados), Disabled (FTP e FTPs desativados) e FtpsOnly (apenas FTPS).

Executar o comando Set-AzWebApp com o -FtpsState parâmetro.

Set-AzWebApp -Name <app-name> -ResourceGroupName <group-name> -FtpsState FtpsOnly

Os valores --ftps-state possíveis são AllAllowed (FTP e FTPS ativados), Disabled (FTP e FTPs desativados) e FtpsOnly (apenas FTPS).

O que acontece com a minha aplicação durante a implementação?

Todos os métodos de implementação oficialmente suportados fazem alterações nos ficheiros na pasta /home/site/wwwroot da sua aplicação. Estes ficheiros são usados para executar a sua aplicação. Para que a implementação possa falhar por causa de ficheiros bloqueados. A aplicação também pode comportar-se de forma imprevisível durante a implementação, uma vez que os ficheiros não estão todos atualizados ao mesmo tempo. Este comportamento é indesejável para uma aplicação virada para o cliente. Há algumas formas de evitar estas questões:

Execute a sua aplicação diretamente a partir do pacote ZIP, sem desembalá-la.
Pare a sua aplicação ou ative o modo offline durante a sua implementação. Para obter mais informações, consulte Lidar com ficheiros bloqueados durante a implementação.
Desloque-se para uma ranhura de paragem com troca automática ligada.

Resolução de problemas implantação FTP

Como posso resolver a implantação do FTP?
I'm not able to FTP and publish my code. Como posso resolver o problema?
Como posso ligar-me à FTP em Serviço de Aplicações do Azure via modo passivo?

Como posso resolver a implantação do FTP?

O primeiro passo para a resolução de problemas da implantação da FTP é isolar um problema de implantação de um problema de aplicação de tempo de funcionamento.

Um problema de implementação normalmente resulta em nenhum ficheiro ou ficheiros errados implantados na sua aplicação. Pode resolver problemas investigando a sua implantação FTP ou selecionando uma trajetória de implantação alternativa (como controlo de origem).

Um problema de aplicação de tempo de execução normalmente resulta no conjunto certo de ficheiros implantados na sua aplicação, mas comportamento incorreto da aplicação. Pode resolver problemas focando-se no comportamento do código em tempo de execução e investigando caminhos específicos de falha.

Para determinar um problema de implementação ou tempo de execução, consulte problemas de implementação vs. tempo de execução.

I'm not able to FTP and publish my code. Como posso resolver o problema?

Verifique se inseriu o nome de anfitrião e credenciais corretos. Verifique também se as seguintes portas FTP da sua máquina não estão bloqueadas por uma firewall:

Porta de ligação de controlo FTP: 21.990
Porta de ligação de dados FTP: 989, 10001-10300

Como posso ligar-me à FTP em Serviço de Aplicações do Azure via modo passivo?

Serviço de Aplicações do Azure suporta a ligação através do modo Ativo e Passivo. O modo passivo é preferido porque as suas máquinas de implantação estão geralmente por trás de uma firewall (no sistema operativo ou como parte de uma rede doméstica ou empresarial). Veja um exemplo da documentação winSCP.