Nasazení aplikace pro Azure App Service pomocí FTP/S

Článek
05/13/2021
4 min ke čtení

V tomto článku se dozvíte, jak pomocí FTP nebo FTPS nasadit webovou aplikaci, back-end mobilní aplikace nebo aplikaci API Azure App Service.

Koncový bod FTP/S pro vaši aplikaci je už aktivní. Pro povolení nasazení FTP/S není nutná žádná konfigurace.

Poznámka

Stránka centra pro vývoj (Classic) v Azure Portal, což je staré prostředí pro nasazení, bude zastaralá v březnu 2021. Tato změna nebude mít vliv na žádná existující nastavení nasazení v aplikaci a můžete pokračovat ve správě nasazení aplikace na stránce centra nasazení .

Získat přihlašovací údaje pro nasazení

Postupujte podle pokynů v tématu konfigurace přihlašovacích údajů nasazení pro Azure App Service ke zkopírování přihlašovacích údajů rozsahu aplikace nebo nastavení přihlašovacích údajů uživatele na obor. Můžete se připojit ke koncovému bodu FTP/S aplikace pomocí přihlašovacích údajů.
Zadejte uživatelské jméno FTP v následujícím formátu v závislosti na zvoleném oboru přihlašovacích údajů:

Rozsah aplikace Rozsah uživatele

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

V App Service se koncový bod FTP/S sdílí mezi aplikacemi. Vzhledem k tomu, že přihlašovací údaje oboru uživatele nejsou propojené s konkrétním prostředkem, je třeba, abyste předřadíte uživatelské jméno oboru uživatele s názvem aplikace, jak je uvedeno výše.

Rozsah aplikace	Rozsah uživatele
`<app-name>\$<app-name>`	`<app-name>\<deployment-user>`

Získat koncový bod FTP/S

Na stejné stránce pro správu aplikace, kam jste zkopírovali přihlašovací údaje nasazení ( > přihlašovací údaje FTP centra nasazení), zkopírujte koncový bod FTPS.

Spusťte příkaz AZ WebApp Deployment list-Publishing-Profiles . Následující příklad používá cestu JMES k extrakci koncových bodů FTP/S z výstupu.

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

Každá aplikace má dva koncové body FTP/S, jeden je pro čtení i zápis, zatímco druhý je jen pro čtení ( profileName obsahuje ReadOnly ) a je určený pro scénáře obnovení dat. Chcete-li nasadit soubory s protokolem FTP, zkopírujte adresu URL koncového bodu pro čtení i zápis.

Spusťte příkaz Get-AzWebAppPublishingProfile . Následující příklad extrahuje koncový bod FTP/S z výstupu XML.

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

Nasazení souborů do Azure

Z klienta FTP (například sady Visual Studio, Cyberducknebo WinSCP) použijte informace o připojení, které jste shromáždili pro připojení k vaší aplikaci.
Zkopírujte své soubory a příslušné adresářové struktury do adresáře /site/wwwroot v Azure (nebo adresáře /site/wwwroot/App_Data/Jobs/ pro WebJobs).
Vyhledejte adresu URL vaší aplikace a ověřte, že aplikace funguje správně.

Poznámka

Na rozdíl od nasazení založeného na Gitu a nasazení zipnepodporuje nasazení FTP automatizaci sestavení, jako je například:

obnovení závislosti (například nástroje NuGet, NPM, PIP a skladatel)
kompilace binárních souborů .NET
generování web.config ( příkladNode.js)

Vygenerujte tyto potřebné soubory ručně na místním počítači a pak je nasaďte společně s vaší aplikací.

Vyhovět FTPS

Pro zvýšení zabezpečení byste měli použít jenom protokol FTP přes protokol TLS/SSL. Pokud nepoužíváte nasazení FTP, můžete také zakázat protokol FTP i FTPS.

Na stránce prostředků vaší aplikace v Azure Portalv levém navigačním panelu vyberte Konfigurace > Obecné nastavení .
Pokud chcete zakázat nešifrované FTP, vyberte FTPS jenom ve stavu FTP. Pokud chcete úplně vypnout FTP i FTPS, vyberte disabled (zakázáno). Jakmile budete hotoví, klikněte na Uložit. Pokud používáte jenom FTPS, musíte vyhovět TLS 1,2 nebo vyššímu, a to tak, že přejdete do okna Nastavení TLS/SSL ve vaší webové aplikaci. TLS 1,0 a 1,1 nejsou podporované jenom pro FTPS.

Spusťte příkaz AZ WebApp config set s --ftps-state argumentem.

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

Možné hodnoty pro --ftps-state jsou AllAllowed (FTP a FTPS povoleny), Disabled (FTP a FTPS disabled) a FtpsOnly (jenom FTPS).

Spusťte příkaz set-AzWebApp s -FtpsState parametrem.

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

Možné hodnoty pro --ftps-state jsou AllAllowed (FTP a FTPS povoleny), Disabled (FTP a FTPS disabled) a FtpsOnly (jenom FTPS).

Co se stane s aplikací během nasazování?

Všechny oficiálně podporované metody nasazení mění soubory ve složce /home/site/wwwroot vaší aplikace. Tyto soubory se používají ke spuštění vaší aplikace. Nasazení proto může selhat z důvodu uzamčených souborů. Aplikace se také může chovat nepředvídatelně během nasazování, protože všechny soubory nejsou aktualizovány najednou. Toto chování je nežádoucí pro aplikaci pro zákazníky. Existuje několik způsobů, jak se těmto problémům vyhnout:

Spusťte aplikaci přímo z balíčku ZIP,aniž byste ji rozbalili.
Zastavte aplikaci nebo pro ní během nasazování povolte offline režim. Další informace najdete v tématu Řešení uzamčených souborů během nasazování.
Nasazení do pracovního slotu se zapnutým automatickým prohozením

Řešení potíží s nasazením FTP

Jak můžu řešit potíže s nasazením FTP?
Nedaří se mi FTP a publikovat můj kód. Jak můžu problém vyřešit?
Jak se můžu připojit k FTP v Azure App Service prostřednictvím pasivního režimu?

Jak můžu řešit potíže s nasazením FTP?

Prvním krokem pro řešení potíží s nasazením FTP je izolování problému s nasazením z běhového problému s aplikací.

K problému s nasazením obvykle dojde v případě, že do vaší aplikace nejsou nasazené žádné soubory nebo chybné soubory. Můžete řešit potíže pomocí šetření nasazení FTP nebo výběru alternativní cesty nasazení (například správy zdrojového kódu).

Problém běhové aplikace obvykle vede ke správné sadě souborů nasazených do vaší aplikace, ale nesprávnému chování aplikace. Můžete řešit problémy tím, že zaměříte chování kódu za běhu a prozkoumáte konkrétní cesty selhání.

K určení problému s nasazením nebo za běhu najdete informace v tématu nasazení vs. běhové chyby.

Nemůžu se připojit přes protokol FTP a publikovat kód. Jak můžu problém vyřešit?

Ověřte, zda jste zadali správný název hostitele a přihlašovací údaje. Ověřte také, že brána firewall neblokuje následující porty FTP v počítači:

Port připojení ovládacího prvku FTP: 21, 990
Port pro připojení dat FTP: 989, 10001-10300

Jak se můžu připojit k FTP v Azure App Service prostřednictvím pasivního režimu?

Azure App Service podporuje připojení prostřednictvím aktivního i pasivního režimu. Pasivní režim je preferovaný, protože počítače nasazení jsou obvykle za bránou firewall (v operačním systému nebo v rámci domácí nebo firemní sítě). Podívejte se na příklad v dokumentaci k WinSCP.