Distribuera din app till Azure App Service FTP/S

Artikel
05/13/2021
4 minuter för att läsa

Den här artikeln visar hur du använder FTP eller FTPS för att distribuera din webbapp, serverdel för mobilappar eller API-app för att Azure App Service.

FTP/S-slutpunkten för din app är redan aktiv. Ingen konfiguration krävs för att aktivera FTP/S-distribution.

Anteckning

Sidan Development Center (klassisk) i Azure Portal, som är den gamla distributionsupplevelsen, kommer att bli inaktuell i mars 2021. Den här ändringen påverkar inte befintliga distributionsinställningar i din app och du kan fortsätta att hantera appdistributionen på sidan Distributionscenter.

Hämta autentiseringsuppgifter för distribution

Följ anvisningarna i Konfigurera autentiseringsuppgifter för Azure App Service att kopiera autentiseringsuppgifterna för programomfånget eller ange autentiseringsuppgifter för användaromfång. Du kan ansluta till FTP/S-slutpunkten för din app med båda autentiseringsuppgifterna.
Skapa FTP-användarnamnet i följande format, beroende på ditt val av omfång för autentiseringsuppgifter:

Programomfång Användaromfång

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

I App Service delas FTP/S-slutpunkten mellan appar. Eftersom autentiseringsuppgifterna för användaromfång inte är länkade till en specifik resurs måste du lägga till användarnamnet för användaromfånget med appnamnet som visas ovan.

Programomfång	Användaromfång
`<app-name>\$<app-name>`	`<app-name>\<deployment-user>`

Hämta FTP/S-slutpunkt

På samma hanteringssida för din app där du kopierade autentiseringsuppgifterna för distribution (Deployment Center > FTP-autentiseringsuppgifter) kopierar du FTPS-slutpunkten.

Kör kommandot az webapp deployment list-publishing-profiles. I följande exempel används en JMES-sökväg för att extrahera FTP/S-slutpunkterna från utdata.

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

Varje app har två FTP/S-slutpunkter, en är skrivskyddade, medan den andra är skrivskyddade ( innehåller ) och är profileName ReadOnly för dataåterställningsscenarier. Om du vill distribuera filer med FTP kopierar du URL:en för slutpunkten för läsning och skrivning.

Kör kommandot Get-AzWebAppPublishingProfile. I följande exempel extraheras FTP/S-slutpunkten från XML-utdata.

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

Distribuera filer till Azure

Från FTP-klienten (till exempel Visual Studio, Cyberdattackeller WinSCP) använder du anslutningsinformationen som du samlade in för att ansluta till din app.
Kopiera dina filer och deras respektive katalogstruktur till katalogen /site/wwwroot i Azure (eller katalogen /site/wwwroot/App_Data/Jobs/för WebJobs).
Bläddra till appens URL för att kontrollera att appen körs korrekt.

Anteckning

Till skillnad från Git-baserade distributioner och Zip-distributionstöder FTP-distribution inte byggautomatisering, till exempel:

beroendeåterställningar (till exempel Automatiseringar av NuGet, NPM, PIP och Composer)
kompilering av .NET-binärfiler
generering av web.config (här är ett Node.js exempel)

Generera de nödvändiga filerna manuellt på den lokala datorn och distribuera dem sedan tillsammans med din app.

Framtvinga FTPS

För ökad säkerhet bör du endast tillåta FTP via TLS/SSL. Du kan också inaktivera både FTP och FTPS om du inte använder FTP-distribution.

På appens resurssida i den Azure Portaldu Allmänna konfigurationsinställningar > i det vänstra navigeringsfönstret.
Om du vill inaktivera okrypterad FTP väljer du ENDAST FTPS i FTP-tillstånd. Om du vill inaktivera både FTP och FTPS helt väljer du Inaktiverad. När det är klart klickar du på Spara. Om du använder endast FTPS måste du framtvinga TLS 1.2 eller senare genom att navigera till bladet TLS/SSL-inställningar för webbappen. TLS 1.0 och 1.1 stöds inte med endast FTPS.

Kör kommandot az webapp config set med --ftps-state argumentet .

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

Möjliga värden för --ftps-state är AllAllowed (FTP och FTPS aktiverat), (FTP och Disabled FTPs inaktiverade) och FtpsOnly (endast FTPS).

Kör kommandot Set-AzWebApp med -FtpsState parametern .

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

Möjliga värden för --ftps-state är AllAllowed (FTP och FTPS aktiverat), (FTP och Disabled FTPs inaktiverade) och FtpsOnly (endast FTPS).

Vad händer med min app under distributionen?

Alla distributionsmetoder som stöds officiellt gör ändringar i filerna i mappen /home/site/wwwroot i din app. De här filerna används för att köra din app. Distributionen kan därför misslyckas på grund av låsta filer. Appen kan också bete sig oförutsägbart under distributionen eftersom alla filer inte uppdateras samtidigt. Det här beteendet är oönskat för en kundriktad app. Det finns några sätt att undvika dessa problem:

Kör appen direkt från ZIP-paketetutan att packa upp den.
Stoppa appen eller aktivera offlineläge för den under distributionen. Mer information finns i Hantera låsta filer under distributionen.
Distribuera till en mellanlagringsplats med automatisk växling aktiverat.

Felsöka FTP-distribution

Hur felsöker jag FTP-distribution?
Jag kan inte ANVÄNDA FTP och publicera min kod. Hur kan jag lösa problemet?
Hur kan jag ansluta till FTP i Azure App Service via passivt läge?

Hur felsöker jag FTP-distribution?

Det första steget vid felsökning av FTP-distribution är att isolera ett distributionsproblem från ett körningsprogramproblem.

Ett distributionsproblem resulterar vanligtvis i att inga filer eller fel filer distribueras till din app. Du kan felsöka genom att undersöka FTP-distributionen eller välja en alternativ distributionssökväg (till exempel källkontroll).

Ett körningsprogramproblem resulterar vanligtvis i rätt uppsättning filer som distribueras till din app, men felaktigt appbeteende. Du kan felsöka genom att fokusera på kodbeteende vid körning och undersöka specifika felsökvägar.

Information om hur du fastställer ett distributions- eller körningsproblem finns i Distribution jämfört med körningsproblem.

Jag kan inte använda FTP och publicera min kod. Hur kan jag lösa problemet?

Kontrollera att du har angett rätt värdnamn och autentiseringsuppgifter. Kontrollera också att följande FTP-portar på datorn inte blockeras av en brandvägg:

Anslutningsport för FTP-kontroll: 21, 990
FTP-dataanslutningsport: 989, 10001-10300

Hur ansluter jag till FTP i Azure App Service via passivt läge?

Azure App Service stöder anslutning via både aktivt och passivt läge. Passivt läge är att föredra eftersom dina distributionsdatorer vanligtvis finns bakom en brandvägg (i operativsystemet eller som en del av ett hem- eller företagsnätverk). Se ett exempel i WinSCP-dokumentationen.