Uw app implementeren in Azure App Service ftp/s

Artikel
05/13/2021
5 minuten om te lezen

In dit artikel wordt beschreven hoe u FTP of FTPS kunt gebruiken om uw web-app, back-en-back-en-app voor mobiele apps of API-apps te implementeren Azure App Service.

Het FTP/S-eindpunt voor uw app is al actief. Er is geen configuratie nodig om FTP/S-implementatie in te kunnenschakelen.

Notitie

De pagina Development Center (klassiek) in de Azure Portal, de oude implementatie-ervaring, wordt in maart 2021 afgeschaft. Deze wijziging heeft geen invloed op bestaande implementatie-instellingen in uw app en u kunt app-implementatie blijven beheren op de pagina Implementatiecentrum.

Implementatiereferenties op halen

Volg de instructies in Implementatiereferenties configureren voor Azure App Service om de referenties voor het toepassingsbereik te kopiëren of de referenties voor het gebruikersbereik in te stellen. U kunt met beide referenties verbinding maken met het FTP/S-eindpunt van uw app.
Maak de FTP-gebruikersnaam in de volgende indeling, afhankelijk van uw keuze van referentiebereik:

Toepassingsbereik Gebruikersbereik

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

In App Service wordt het FTP/S-eindpunt gedeeld tussen apps. Omdat de referenties voor het gebruikersbereik niet zijn gekoppeld aan een specifieke resource, moet u de gebruikersnaam voor het gebruikersbereik voorbereiden met de app-naam, zoals hierboven wordt weergegeven.

Toepassingsbereik	Gebruikersbereik
`<app-name>\$<app-name>`	`<app-name>\<deployment-user>`

FTP/S-eindpunt op halen

Kopieer het FTPS-eindpunt op dezelfde beheerpagina vooruw app waar u de > implementatiereferenties (FTP-referenties voor het implementatiecentrum) hebt gekopieerd.

Voer de opdracht az webapp deployment list-publishing-profiles uit. In het volgende voorbeeld wordt een JMES-pad gebruikt om de FTP/S-eindpunten uit de uitvoer te extraheren.

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

Elke app heeft twee FTP/S-eindpunten, één is lezen/schrijven, terwijl de andere alleen-lezen is ( bevat ) en is voor scenario's voor profileName ReadOnly gegevensherstel. Als u bestanden wilt implementeren met FTP, kopieert u de URL van het eindpunt voor lezen/schrijven.

Voer de opdracht Get-AzWebAppPublishingProfile uit. In het volgende voorbeeld wordt het FTP/S-eindpunt uit de XML-uitvoer geëxtraheert.

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

Bestanden implementeren in Azure

Gebruik vanuit uw FTP-client (bijvoorbeeld Visual Studio, Cyberd cybersecurityof WinSCP) de verbindingsgegevensdie u hebt verzameld om verbinding te maken met uw app.
Kopieer uw bestanden en hun respectieve mapstructuur naar de map /site/wwwroot in Azure (of de map /site/wwwroot/App_Data/Jobs/ voor WebJobs).
Blader naar de URL van uw app om te controleren of de app correct wordt uitgevoerd.

Notitie

In tegenstelling tot Implementaties op basis van Git en Zip-implementatiebiedt FTP-implementatie geen ondersteuning voor buildautomatisering, zoals:

herstel van afhankelijkheden (zoals NuGet, NPM, PIP en Composer-automatiseringen)
compilatie van binaire .NET-bestanden
generatie van web.config (hier is een voorbeeldNode.js )

Genereer deze benodigde bestanden handmatig op uw lokale computer en implementeer ze vervolgens samen met uw app.

FTPS afdwingen

Voor verbeterde beveiliging moet u FTP alleen via TLS/SSL toestaan. U kunt ftp en FTPS ook uitschakelen als u geen FTP-implementatie gebruikt.

Selecteer op de resourcepagina van uw app in Azure Portalde optie > Configuratie Algemene instellingen in het linkernavigatievenster.
Als u niet-versleutelde FTP wilt uitschakelen, selecteert u FTPS alleen met de FTP-status. Als u zowel FTP als FTPS volledig wilt uitschakelen, selecteert u Uitgeschakeld. Klik op Opslaan als u klaar bent. Als u alleen FTPS gebruikt, moet u TLS 1.2 of hoger afdwingen door te navigeren naar de blade TLS/SSL-instellingen van uw web-app. TLS 1.0 en 1.1 worden alleen ondersteund met FTPS.

Voer de opdracht az webapp config set uit met het argument --ftps-state .

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

Mogelijke waarden voor --ftps-state zijn AllAllowed (FTP en FTPS ingeschakeld), Disabled (FTP en FTPs uitgeschakeld) en FtpsOnly (alleen FTPS).

Voer de opdracht Set-AzWebApp uit met de -FtpsState parameter .

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

Mogelijke waarden voor --ftps-state zijn AllAllowed (FTP en FTPS ingeschakeld), Disabled (FTP en FTPs uitgeschakeld) en FtpsOnly (alleen FTPS).

Wat gebeurt er met mijn app tijdens de implementatie?

Alle officieel ondersteunde implementatiemethoden brengen wijzigingen aan in de bestanden in de map /home/site/wwwroot van uw app. Deze bestanden worden gebruikt om uw app uit te voeren. De implementatie kan dus mislukken vanwege vergrendelde bestanden. De app gedraagt zich mogelijk ook onvoorspelbaar tijdens de implementatie, omdat de bestanden niet allemaal op hetzelfde moment worden bijgewerkt. Dit gedrag is ongewenst voor een klantgerichte app. Er zijn een aantal manieren om deze problemen te voorkomen:

Voer uw app rechtstreeks uit vanuit het ZIP-pakket, zonder deze uit te pakken.
Stop uw app of schakel de offlinemodus voor de app in tijdens de implementatie. Zie Deal with locked files during deployment (Omgaan met vergrendelde bestanden tijdens de implementatie) voor meer informatie.
Implementeren naar een staging-sleuf met automatisch wisselen ingeschakeld.

Problemen met FTP-implementatie oplossen

Hoe kan ik problemen met FTP-implementatie oplossen?
Ik kan ftp niet gebruiken en mijn code niet publiceren. Hoe kan ik het probleem oplossen?
Hoe kan ik verbinding maken met FTP in Azure App Service via de passieve modus?

Hoe kan ik problemen met FTP-implementatie oplossen?

De eerste stap voor het oplossen van problemen met FTP-implementatie is het isoleren van een implementatieprobleem van een runtimetoepassingsprobleem.

Een implementatieprobleem resulteert doorgaans in geen bestanden of verkeerde bestanden die in uw app zijn geïmplementeerd. U kunt problemen oplossen door uw FTP-implementatie te onderzoeken of een alternatief implementatiepad (zoals broncodebeheer) te selecteren.

Een probleem met een runtimetoepassing resulteert doorgaans in de juiste set bestanden die in uw app zijn geïmplementeerd, maar onjuist app-gedrag. U kunt problemen oplossen door u te richten op codegedrag tijdens runtime en specifieke foutpaden te onderzoeken.

Zie Deployment vs. runtime issues (Implementatie- versus runtimeproblemen)om een probleem met de implementatie of runtime vast te stellen.

Ik kan FTP niet gebruiken en mijn code niet publiceren. Hoe kan ik het probleem oplossen?

Controleer of u de juiste hostnaam en referenties hebt ingevoerd. Controleer ook of de volgende FTP-poorten op uw computer niet worden geblokkeerd door een firewall:

Verbindingspoort voor FTP-besturingselement: 21, 990
FTP-gegevensverbindingspoort: 989, 10001-10300

Hoe kan ik verbinding maken met FTP in Azure App Service via de passieve modus?

Azure App Service ondersteunt verbinding maken via zowel de modus Actief als passief. De passieve modus heeft de voorkeur omdat uw implementatiemachines zich meestal achter een firewall bevinden (in het besturingssysteem of als onderdeel van een thuisnetwerk of bedrijfsnetwerk). Zie een voorbeeld uit de WinSCP-documentatie.