Uygulamanızı FTP/S kullanarak Azure App Service dağıtma

Makale
05/13/2021
Okumak için 4 dakika

Bu makalede, Azure App Serviceiçin Web uygulamanızı, mobil uygulama arka ucunu veya API uygulamanızı DAĞıTMAK üzere FTP veya FTPS 'nin nasıl kullanılacağı gösterilmektedir.

Uygulamanızın FTP/S uç noktası zaten etkin. FTP/S dağıtımını etkinleştirmek için yapılandırma gerekmez.

Not

Eski dağıtım deneyimi olan Azure portal Geliştirme Merkezi (klasik) sayfası mart, 2021 ' de kullanım dışı olacaktır. Bu değişiklik uygulamanızdaki mevcut dağıtım ayarlarını etkilemez ve Dağıtım Merkezi sayfasında uygulama dağıtımını yönetmeye devam edebilirsiniz.

Dağıtım kimlik bilgilerini al

Uygulama kapsamı kimlik bilgilerini kopyalamak veya kullanıcı kapsamı kimlik bilgilerini ayarlamak için Azure App Service dağıtım kimlik bilgilerini yapılandırma bölümündeki yönergeleri izleyin. Kimlik bilgilerini kullanarak uygulamanızın FTP/S uç noktasına bağlanabilirsiniz.
Aşağıdaki biçimde, kimlik bilgisi kapsamı seçiminize bağlı olarak FTP Kullanıcı adını aşağıdaki biçimde oluşturur:

Uygulama kapsamı Kullanıcı kapsamı

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

App Service, FTP/S uç noktası uygulamalar arasında paylaşılır. Kullanıcı kapsamı kimlik bilgileri belirli bir kaynakla bağlantılı olmadığından, yukarıda gösterildiği gibi, kullanıcı kapsamı kullanıcı adını uygulama adıyla sonuna eklemeniz gerekir.

Uygulama kapsamı	Kullanıcı kapsamı
`<app-name>\$<app-name>`	`<app-name>\<deployment-user>`

FTP/S uç noktası al

Uygulamanızın dağıtım kimlik bilgilerini (Dağıtım Merkezi > FTP kimlik bilgileri) kopyaladığınız Yönetim sayfasında, FTPS uç noktası' nı kopyalayın.

Az WebApp Deployment List-Publishing-Profiles komutunu çalıştırın. Aşağıdaki örnek, çıktısından FTP/S uç noktalarını ayıklamak için bir Jmes yolu kullanır.

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

Her uygulamanın iki FTP/S uç noktası vardır, diğeri salt okunurdur ( profileName içerir ReadOnly ) ve veri kurtarma senaryolarında olur. FTP ile dosya dağıtmak için okuma-yazma uç noktasının URL 'sini kopyalayın.

Get-AzWebAppPublishingProfile komutunu çalıştırın. Aşağıdaki örnek, XML çıktısından FTP/S uç noktasını ayıklar.

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

Azure 'a dosya dağıtma

FTP istemcinizden (örneğin, Visual Studio, siduckveya WinSCP), uygulamanıza bağlanmak için topladığınız bağlantı bilgilerini kullanın.
Dosyalarınızı ve ilgili dizin yapılarını Azure 'daki /site/Wwwroot dizinine (veya WebJobs için /site/Wwwroot/App_Data/Jobs/ dizininden) kopyalayın.
Uygulamanın düzgün çalıştığını doğrulamak için uygulamanızın URL 'sine gidin.

Not

Git tabanlı dağıtımların ve ZIP dağıtımınınaksine, FTP dağıtımı derleme Otomasyonu 'nu desteklemez, örneğin:

bağımlılık geri yüklemeleri (NuGet, NPM, PI ve besteci tahminleri gibi)
.NET ikili dosyalarının derlenmesi
web.config oluşturma ( Node.js bir örnek)

Bu gerekli dosyaları yerel makinenizde el ile oluşturun ve ardından uygulamanızla birlikte dağıtın.

FTPS 'yi zorla

Gelişmiş güvenlik için yalnızca TLS/SSL üzerinden FTP 'ye izin vermeniz gerekir. FTP dağıtımını kullanmıyorsanız hem FTP hem de FTPS 'yi devre dışı bırakabilirsiniz.

Uygulamanızın kaynak sayfasında, Azure Portal' de, > sol gezinmede yapılandırma genel ayarları ' nı seçin.
Şifrelenmemiş FTP 'yi devre dışı bırakmak için, FTPS ' yi yalnızca FTP durumunda seçin. Hem FTP hem de FTPS 'yi tamamen devre dışı bırakmak için devre dışı seçeneğini belirleyin İşlemi tamamladıktan sonra Kaydet’e tıklayın. Yalnızca FTPS kullanıyorsanız, Web uygulamanızın TLS/SSL ayarları dikey penceresine giderek TLS 1,2 veya üstünü zorlayabilmeniz gerekir. TLS 1,0 ve 1,1 yalnızca FTPS ile desteklenmez.

Bu bağımsız değişkenle az WebApp config Set komutunu çalıştırın --ftps-state .

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

İçin olası değerler --ftps-state AllAllowed (FTP ve FTPS etkin), Disabled (FTP ve FTPS devre dışı) ve FtpsOnly (yalnızca FTPS).

Parametresiyle set-AzWebApp komutunu çalıştırın -FtpsState .

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

İçin olası değerler --ftps-state AllAllowed (FTP ve FTPS etkin), Disabled (FTP ve FTPS devre dışı) ve FtpsOnly (yalnızca FTPS).

Dağıtım sırasında uygulamama ne olur?

Resmi olarak desteklenen tüm dağıtım yöntemleri, uygulamanın /home/site/wwwroot klasöründeki dosyalarda değişiklik yapın. Bu dosyalar, uygulamalarınızı çalıştırmak için kullanılır. Bu nedenle, kilitli dosyalar nedeniyle dağıtım başarısız olabilir. Dosyaların hepsi aynı anda güncelleştirilmez olduğundan, uygulama dağıtım sırasında tahmin edilemez şekilde davranabilirsiniz. Bu davranış, müşteriye yönelik bir uygulama için istenmeyen bir davranıştır. Bu sorunlardan kaçınmanın birkaç yolu vardır:

Paketinden çıkarmadan, uygulamanızıdoğrudan ZIP paketinden çalıştırın.
Dağıtım sırasında uygulamayı durdurun veya çevrimdışı modu etkinleştirin. Daha fazla bilgi için bkz. Dağıtım sırasında kilitli dosyalarla ilgilenin.
Otomatik değiştirme açık bir hazırlama yuvasına dağıtın.

FTP dağıtımı sorunlarını giderme

FTP dağıtımı ile ilgili sorunları nasıl giderebilirim?
Kodumu FTP ve yayınlayamıyorum. Sorunu nasıl çözebilirim?
Pasif mod aracılığıyla Azure App Service FTP 'ye nasıl bağlanabilirim?

FTP dağıtımı ile ilgili sorunları nasıl giderebilirim?

FTP dağıtımında sorun gidermeye yönelik ilk adım, bir çalışma zamanı uygulama sorunundan bir dağıtım sorununu yalıtmaya yöneliktir.

Dağıtım sorunu genellikle uygulamanıza hiçbir dosya veya yanlış dosya dağıtılmasına neden olur. FTP dağıtımınızı inceleyerek veya alternatif bir dağıtım yolu (örneğin, kaynak denetimi) seçerek sorun giderebilirsiniz.

Çalışma zamanı uygulama sorunu genellikle uygulamanıza dağıtılan doğru dosya kümesine, ancak yanlış uygulama davranışına neden olur. Çalışma zamanında kod davranışına odaklanarak ve belirli hata yollarını inceleyerek sorun gidermeye devam edebilirsiniz.

Bir dağıtımı veya çalışma zamanı sorununu anlamak için bkz. dağıtım ve çalışma zamanı sorunları.

FTP kullanamıyorum ve kodumu yayımlayamıyorum. Sorunu nasıl çözebilirim?

Doğru ana bilgisayar adını ve kimlik bilgilerinigirdiğinizden emin olun. Ayrıca, makinenizde bulunan aşağıdaki FTP bağlantı noktalarının bir güvenlik duvarı tarafından engellenmediğinden emin olun:

FTP denetim bağlantı noktası: 21, 990
FTP veri bağlantısı bağlantı noktası: 989, 10001-10300

Pasif mod aracılığıyla Azure App Service FTP 'ye nasıl bağlanabilirim?

Azure App Service hem etkin hem de Pasif mod aracılığıyla bağlanmayı destekler. Dağıtım makineleriniz genellikle bir güvenlik duvarının arkasında (işletim sisteminde veya bir ev veya iş ağının parçası olarak) olduğundan Pasif mod tercih edilir. WinSCP belgelerinden bir örnekgörüntüleyin.