App Service'te yerel paylaşım olarak Azure Storage bağlama

Azure Storage, Microsoft'un modern veri depolama senaryoları için bulut depolama çözümüdür. Azure Storage, buluttaki veri nesneleri için yüksek oranda kullanılabilir, yüksek oranda ölçeklenebilir, dayanıklı ve güvenli depolama sunar. Bu kılavuzda, Azure Storage Dosyalarının Azure App Service'daki Windows kodunda (noncontainer) ağ paylaşımı olarak nasıl bağlanacakları gösterilmektedir.

Azure Storage, App Service için Azure Files Paylaşımları ve Premium Dosya Paylaşımları destekler. Azure Storage, App Service için varsayılan depolama alanı değildir. Ayrı faturalandırılır. Azure Storage'i bir ARM şablonunda da yapılandırabilirsiniz.

Özel olarak bağlanan depolamanın avantajlarından bazıları şunlardır:

• App Service uygulamanız için kalıcı depolamayı yapılandırın ve depolamayı ayrı olarak yönetin.
• Video ve görüntü gibi statik içerikleri App Service uygulamanızda kullanıma hazır hale getirin.
• Azure Dosya paylaşımlarına uygulama günlüğü dosyaları yazın veya eski uygulama günlüklerini arşivleyin.
• İçeriği birden çok uygulamada veya diğer Azure hizmetleriyle paylaşın.

Windows kodu için aşağıdaki özellikler desteklenir:

• Anahtar kasası, özel uç noktalar ve hizmet uç noktaları ile, sanal ağ tümleştirmesini kullandığınızda depolama hesaplarına güvenli erişim sağlanır.
• Azure Files (okuma/yazma).
• Uygulama başına en fazla beş bağlama noktası.
• /mounts/<path-name> kullanarak Azure Storage dosya paylaşımlarını bağlayın.

Azure depolamayı uygulamanıza bağlamaya ilişkin üç seçenek şunlardır:

Bağlama seçeneği	Kullanım
Temel	Azure portalını kullanarak depolamayı bağlarken bu seçeneği belirleyin. Depolama hesabı hizmet uç noktalarını, private uç noktalarını veya Azure Key Vault kullanmadığı sürece temel seçeneği kullanabilirsiniz. Bu durumda portal sizin için erişim anahtarını alır ve depolar.
Erişim Tuşu	Azure CLI kullanarak depolamayı bağlamayı planlıyorsanız bir erişim anahtarı almanız gerekir. Depolama hesabı hizmet uç noktaları, private uç noktaları veya Azure Key Vault kullanmıyorsa bu seçeneği belirleyin.
Key Vault	Erişim anahtarı gerektiren Azure CLI kullanarak depolamayı bağlamayı planlarken de bu seçeneği kullanın. Erişim anahtarlarını güvenli bir şekilde depolamak ve almak için Azure Key Vault kullanırken bu seçeneği belirleyin. Azure Key Vault Azure App Service gibi diğer Azure hizmetlerini izleme, yönetme ve tümleştirme özelliğiyle uygulama gizli dizilerini merkezi ve güvenli bir şekilde depolamanın avantajlarına sahiptir.

Önkoşullar

Basic

• App Service'te var olan Windows kodu uygulaması.
• Azure dosya paylaşımı.
• Azure Dosya paylaşımına yüklenen dosyalar.

Erişim Anahtarı

• App Service'te var olan Windows kodu uygulaması.
• Azure dosya paylaşımı.
• Azure Dosya paylaşımına yüklenen Dosyalar.

Key Vault

• App Service'te var olan Windows kodu uygulaması.
• Azure dosya paylaşımı.
• Azure Dosya paylaşımına yüklenen Dosyalar.
• Azure Storage ile yapılandırılması gereken vault erişim ilkesi ve bir secret kullanan bir Azure Key Vault örneği.

Sınırlamalar

• Depolama güvenlik duvarı yalnızca sanal ağ tümleştirmesi kullandığınızda özel uç noktalar ve hizmet uç noktaları aracılığıyla desteklenir.
• Azure blobları, App Service'e dağıtılan Windows kod uygulamaları için Azure depolama bağlamalarını yapılandırdığınızda desteklenmez.
• Bağlı depolamaya FTP/FTPS erişimi desteklenmez. Azure Storage Explorer kullanın.
• /mounts, mounts/name1/name2, /ve /mounts/name.ext/ değerlerinin özel olarak bağlanmış depolamaya eşlenmesi desteklenmez. Özel depolamayı web uygulamanıza bağlamak için yalnızca /mounts/pathname kullanabilirsiniz.
• Depolama bağlamaları yedeklemelere dahil değildir. Azure Storage hesaplarını yedeklemek için en iyi yöntemleri izlediğiden emin olun.
• Uygulamanıza sanal ağ tümleştirmesi eklediğinizde, bağlı sürücü sanal ağınızdaki bir IP adresini değil, bir RFC1918 IP adresini kullanır.

Montaja hazırlanma

Basic

Portal sizin için erişim anahtarını aldığından ve depoladığı için ek adım gerekmez.

Erişim Anahtarı

Erişim anahtarını depolama hesabınızdan almanız gerekir.

Key Vault

Key Vault erişimini kullanarak depolamayı bağlamadan önce, Key Vault gizli bilgilerini almanız ve uygulamanızda uygulama ayarı olarak eklemeniz gerekir.

1. Azure portalında "Key Vault"a gidin. Nesneleri>Gizliler'i seçin. Gizli Dizi Tanımlayıcısını panoya kopyalayın.

   

2. Uygulamanıza geri dönün ve anahtar kasası başvurusunu izleyerek Gizli Dizi Tanımlayıcısı'nı kullanarak bir uygulama ayarı oluşturun.

   Örnek uygulama ayarı değeri: @Microsoft.KeyVault(SecretUri=https://mykeyvault.vault.azure.net/secrets/mykeyvaultsecret/aaaaaaaa0b0b1c1c2d2d333333333333)

Artık depolama hesabınıza erişmek için Key Vault kullanmaya hazırsınız.

Depolamayı Windows koduna bağlama

Azure portalı

Azure portalını kullanarak depolamayı Windows koda bağlamak için:

1. Azure portalında uygulamaya gidin.

2. Sol gezinti bölmesinde Ayarlar>Yapılandırması'nı seçin. Path eşlemeleri öğesini seçin ve ardından Yeni Azure Storage Bağlama'i seçin.

3. Depolama bağlamasını aşağıdaki tabloya göre yapılandırın. İşiniz bittiğinde Tamamseçin.

   Setting	Tanım
   İsim	Disk bağlama yapılandırmasının adı. Boşluk kullanmayın.
   Yapılandırma seçenekleri	Hesap, özel uç noktaları veya Azure Key Vault kullanmıyorsa Basic seçeneğini seçin. Aksi takdirde Gelişmiş'i seçin.
   Depolama hesapları	Azure Depolama hesabı. bir Azure Files paylaşımı içermelidir.
   Paylaşım adı	Dosyalar paylaşmak için bağlanacak.
   Depolama erişimi	Azure Key Vault için Key vault reference öğesini seçin. Aksi takdirde El ile giriş'i seçin.
   Erişim anahtarı (Yalnızca gelişmiş)	Depolama hesabınız için erişim anahtarı .
   Bağlama yolu	Uygulama hizmetinizde bağlamak istediğiniz dizin. Yalnızca /mounts/pathname desteklenir.
   Uygulama ayarları	Azure Key Vault gizlisi içeren uygulama ayarını seçin.
   Dağıtım yuvası ayarı	Seçildiğinde, depolama bağlama ayarları dağıtım yuvalarına da uygulanır.

Azure portalı

1. Azure portalında uygulamaya gidin.

2. Sol gezinti bölmesinde Ayarlar>Yapılandırması'nı seçin. Path eşlemeleri öğesini seçin ve ardından Yeni Azure Storage Bağlama'i seçin.

3. Depolama bağlamasını aşağıdaki tabloya göre yapılandırın. İşiniz bittiğinde Tamamseçin.

   Setting	Tanım
   İsim	Disk bağlama yapılandırmasının adı. Boşluk kullanmayın.
   Yapılandırma seçenekleri	Gelişmiş'i seçin.
   Depolama hesapları	Azure Depolama hesabı.
   Depolama türü	Bağlamak istediğiniz depolama alanına göre türü seçin. Azure Blobları yalnızca salt okunur erişimi destekler.
   Depolama kapsayıcısı veya Paylaşım adı	Dosya paylaşımı veya bağlanacak Bloblar kapsayıcısı.
   Depolama erişimi	El ile giriş'i seçin.
   Erişim anahtarı	Depolama hesabınızın erişim anahtarını girin.
   Bağlama yolu	Linux kapsayıcısının içindeki, Azure Storage'a bağlanacak dizin. veya / kullanmayın.
   Dağıtım yuvası ayarı	Seçildiğinde, depolama bağlama ayarları dağıtım yuvalarına da uygulanır.

Azure portalı

1. Azure portalında uygulamaya gidin.

2. Sol gezinti bölmesinde Ayarlar>Yapılandırması'nı seçin. Path eşlemeleri öğesini seçin ve ardından Yeni Azure Storage Bağlama'i seçin.

3. Depolama bağlamasını aşağıdaki tabloya göre yapılandırın. İşiniz bittiğinde Tamamseçin.

   Setting	Tanım
   İsim	Disk bağlama yapılandırmasının adı. Boşluk kullanmayın.
   Yapılandırma seçenekleri	Depolama hesabı hizmet uç noktaları, private uç noktaları veya Azure Key Vault kullanmıyorsa Basic öğesini seçin. Aksi takdirde Gelişmiş'i seçin.
   Depolama hesapları	Azure Depolama hesabı.
   Depolama türü	Bağlamak istediğiniz depolama alanına göre türü seçin. Azure Blobları yalnızca salt okunur erişimi destekler.
   Depolama kapsayıcısı veya Paylaşım adı	Dosya paylaşımı veya bağlanacak Bloblar kapsayıcısı.
   Depolama erişimi	Anahtar kasası başvurusu'na tıklayın.
   Uygulama ayarları	Azure Key Vault gizli anahtarını içeren mevcut uygulama ayarını seçin.
   Bağlama yolu	Linux kapsayıcısının içindeki, Azure Storage'a bağlanacak dizin. veya / kullanmayın.
   Dağıtım yuvası ayarı	İşaretlendiğinde, depolama bağlama ayarları dağıtım yuvalarına da uygulanır.

4. Depolama bağlamasına erişmek için Key Vault uygulamasına erişim sağlayın.

Azure CLI

Depolamayı bağlamak için Azure CLI kullanmak için depolama erişim anahtarını sağlamanız gerekir.

Azure CLI

az webapp config storage-account add komutunu kullanın. Örneğin:

az webapp config storage-account add --resource-group <group-name> --name <app-name> --custom-id <custom-id> --storage-type AzureFiles --share-name <share-name> --account-name <storage-account-name> --access-key "<access-key>" --mount-path <mount-path-directory>

Aşağıdaki komutu çalıştırarak depolamanızın bağlandığını doğrulayın:

az webapp config storage-account list --resource-group <resource-group> --name <app-name>

Azure CLI

Azure CLI şu anda depolamayı Key Vault erişimi kullanarak bağlamayı desteklememektedir. Bunun yerine Azure portalını kullanın.

Note

Depolama bağlaması eklediğinizde, düzenlediğinizde veya sildiğinizde uygulama yeniden başlatılır.

En iyi yöntemler

• Azure Storage bağlamaları, statik içerik sunmak için sanal dizin olarak yapılandırılabilir. Sanal dizini yapılandırmak için sol gezinti bölmesinde Ayarlar>Yapılandırması'nı seçin. Ardından Yol eşlemeleri'ni ve ardından Yeni sanal uygulama veya dizin'i seçin. Physical path değerini Azure Storage bağlamada tanımlanan Mount yolu olarak ayarlayın.

• Gecikme sorunlarını önlemek için uygulamayı ve Azure Storage hesabını aynı bölgeye yerleştirin. Uygulama ve Azure Storage hesabı aynı bölgede olduğunda Azure Storage güvenlik duvarı yapılandırması App Service IP adreslerinden erişim izni verirseniz, bu IP kısıtlamaları kabul edilmez.

• Azure Storage hesabında, uygulamadaki depolamayı bağlamak için kullandığınız erişim anahtarını yeniden oluşturmaktan kaçının. Depolama hesabı iki anahtar içerir. Azure App Hizmetleri bir Azure depolama hesabı anahtarı depolar. Anahtar yeniden oluşturma sırasında depolama bağlamasının uygulamada kullanılabilir durumda kaldığından emin olmak için adım adım bir yaklaşım kullanın. Örneğin, uygulamanızda depolama bağlamayı yapılandırmak için key1 kullandığınız varsayılır:

  1. Anahtar2'i yeniden üretin.
  2. Yeniden oluşturulan anahtar2'yı kullanmak için depolama bağlama yapılandırmasında erişim anahtarını güncelleyin.
  3. Anahtar1'i yeniden üretin.

• Bir Azure Storage hesabı, kapsayıcıyı veya paylaşımı silerseniz, olası hata senaryolarını önlemek için uygulamadaki ilgili depolama bağlama yapılandırmasını kaldırın.

• Bağlı Azure Storage hesabı Standart veya Premium performans katmanı olabilir. Uygulama kapasitesi ve aktarım hızı gereksinimlerine göre depolama hesabı için uygun performans katmanını seçin. Dosyalar için ölçeklenebilirlik ve performans hedeflerine bakın.

• Uygulamanız birden çok örneğe ölçekleniyorsa, tüm örnekler aynı eklenmiş Azure Storage hesabına bağlanır. Performans sorunlarını ve aktarım hızı sorunlarını önlemek için depolama hesabı için uygun performans katmanını seçin.

• SQLite gibi yerel veritabanları için veya dosya tanıtıcılarını ve kilitlerini kullanan diğer uygulama ve bileşenler için depolama bağlamaları kullanmanızı önermeyiz.

• Depolama hesabı uygulamaya bağlandığında depolama yük devretmesini başlatırsanız, uygulama yeniden başlatılana kadar veya depolama bağlaması kaldırılıp yeniden eklenene kadar bağlantı gerçekleşmez.

• Sanal ağ tümleştirmesi ile Azure Files kullanırken 445 numaralı bağlantı noktasının açık olduğundan emin olun. Ayrıca, uygulama ayarının WEBSITE_CONTENTOVERVNET olarak 1ayarlandığından emin olun.

• Bağlı Azure Storage hesabı Standart veya Premium performans katmanı olabilir. Uygulama kapasitesi ve aktarım hızı gereksinimlerine göre depolama hesabı için uygun performans katmanını seçin. Dosyalar için ölçeklenebilirlik ve performans hedeflerine bakın.

Sonraki adım

.NET uygulamalarını Azure App Service

Azure Storage, Microsoft'un modern veri depolama senaryoları için bulut depolama çözümüdür. Azure Storage, buluttaki veri nesneleri için yüksek oranda kullanılabilir, yüksek oranda ölçeklenebilir, dayanıklı ve güvenli depolama sunar. Bu kılavuz, App Service'teki bir Windows kapsayıcısında Azure Storage dosyalarının, ağ paylaşımı olarak nasıl bağlanacağını göstermektedir.

Azure Storage Azure Files Shares ve Premium Files Shares'ı destekler. Azure Storage, App Service için varsayılan depolama alanı değildir. Ayrı faturalandırılır. Azure Storage'i bir ARM şablonunda da yapılandırabilirsiniz.

Özel olarak bağlanan depolamanın avantajlarından bazıları şunlardır:

• App Service uygulamanız için kalıcı depolamayı yapılandırın ve depolamayı ayrı olarak yönetin.
• Video ve görüntü gibi statik içerikleri App Service uygulamanızda kullanıma hazır hale getirin.
• Azure Dosya paylaşımlarına uygulama günlüğü dosyaları yazın veya eski uygulama günlüğünü arşivleyin.
• İçeriği birden çok uygulamada veya diğer Azure hizmetleriyle paylaşın.
• Windows kapsayıcısına, yalıtılmış olanlar da dahil, Azure Depolama'yı bağlayın. Daha fazla bilgi için bkz. App Service ortamı v3.

Windows kapsayıcıları için aşağıdaki özellikler desteklenir:

• Sanal ağ tümleştirmesini kullanırken anahtar kasası, özel uç noktalar ve hizmet uç noktalarını kullanarak depolama hesaplarına güvenli erişim.
• Azure Files (okuma/yazma).
• Uygulama başına en fazla beş bağlama noktası.
• Sürücü harfi atamaları (C: ile Z:).

Azure depolamayı uygulamanıza bağlamaya ilişkin üç seçenek şunlardır:

Bağlama seçeneği	Kullanım
Temel	Azure portalını kullanarak depolamayı bağlarken bu seçeneği belirleyin. Depolama hesabı hizmet uç noktalarını, private uç noktalarını veya Azure Key Vault kullanmadığı sürece temel seçeneği kullanabilirsiniz. Bu durumda portal sizin için erişim anahtarını alır ve depolar.
Erişim Tuşu	Azure CLI kullanarak depolamayı bağlamayı planlıyorsanız bir erişim anahtarı almanız gerekir. Depolama hesabı hizmet uç noktaları, özel uç noktaları veya Azure Key Vault kullanmıyorsa bu seçeneği belirtin.
Key Vault	Erişim anahtarı gerektiren Azure CLI kullanarak depolamayı bağlamayı planlarken de bu seçeneği kullanın. Erişim anahtarlarını güvenli bir şekilde depolamak ve almak için Azure Key Vault kullanırken bu seçeneği belirleyin. Azure Key Vault Azure App Service gibi diğer Azure hizmetlerini izleme, yönetme ve tümleştirme özelliğiyle uygulama gizli dizilerini merkezi ve güvenli bir şekilde depolamanın avantajlarına sahiptir.

Önkoşullar

Basic

• App Service'te var olan Windows kapsayıcı uygulaması.
• Azure dosya paylaşımı.
• Azure Dosya paylaşımına yüklenen Dosyalar.

Erişim Anahtarı

• App Service'te var olan Windows kapsayıcı uygulaması.
• Azure dosya paylaşımı.
• Azure Dosya paylaşımına yüklenen Dosyalar.

Key Vault

• App Service'te var olan Windows kapsayıcı uygulaması.
• Azure dosya paylaşımı.
• Azure Dosya paylaşımına yüklenen Dosyalar.
• Azure Storage ile yapılandırılması gereken vault erişim ilkesi ve bir secret kullanan bir Azure Key Vault örneği.

Sınırlamalar

• Azure blobları desteklenmez.
• Depolama güvenlik duvarı yalnızca sanal ağ tümleştirmesi kullandığınızda özel uç noktalar ve hizmet uç noktaları aracılığıyla desteklenir.
• Bağlanan depolamaya FTP/FTPS erişimi desteklenmez (Azure Storage Explorer kullanın).
• [C-Z]:\, [C-Z]:\home, /ve /home ile özel olarak bağlanan depolamanın eşlenmesi desteklenmez.
• Uygulamanızı yedeklerken depolama bağlamaları yedeklenmez. Azure Storage hesaplarını yedeklemek için en iyi yöntemleri izlediğinden emin olun.
• Uygulamanıza sanal ağ tümleştirmesi eklediğinizde, bağlı sürücü sanal ağınızdaki bir IP adresini değil, bir RFC1918 IP adresini kullanır.

Montaja hazırlanma

Basic

Portal sizin için erişim anahtarını aldığından ve depoladığı için ek adım gerekmez.

Erişim Anahtarı

Erişim anahtarını depolama hesabınızdan almanız gerekir.

Key Vault

Key Vault erişimini kullanarak depolamayı bağlamadan önce, Key Vault gizli bilgilerini almanız ve uygulamanızda uygulama ayarı olarak eklemeniz gerekir.

1. Azure portalında "Key Vault"a gidin. Nesneleri>Gizliler'i seçin. Gizli Dizi Tanımlayıcısını panoya kopyalayın.

   

2. Uygulamanıza geri dönün ve anahtar kasası referansını takip ederek, Gizli Tanımlayıcı kullanarak bir uygulama ayarı oluşturun.

   Örnek uygulama ayarı değeri: @Microsoft.KeyVault(SecretUri=https://mykeyvault.vault.azure.net/secrets/mykeyvaultsecret/aaaaaaaa0b0b1c1c2d2d333333333333)

Artık depolama hesabınıza erişmek için Key Vault kullanmaya hazırsınız.

Depolamayı Windows kapsayıcıya bağlama

Azure portalı

Azure portalını kullanarak depolamayı bir Windows kapsayıcısına bağlamak için:

1. Azure portalında uygulamaya gidin.

2. Sol gezinti bölmesinde Ayarlar>Yapılandırması'nı seçin. Path eşlemeleri öğesini seçin ve ardından Yeni Azure Storage Bağlama'i seçin.

3. Depolama bağlamasını aşağıdaki tabloya göre yapılandırın. İşiniz bittiğinde Tamamseçin.

   Setting	Tanım
   İsim	Disk bağlama yapılandırmasının adı. Boşluk kullanmayın.
   Yapılandırma seçenekleri	Temel'i seçin.
   Depolama hesapları	Azure Depolama hesabı. bir Azure Files paylaşımı içermelidir.
   Paylaşım adı	Dosyalar paylaşmak için bağlanacak.
   Bağlama yolu	Bağlamak istediğiniz Windows kapsayıcınızın içindeki dizin. Kök dizinini ([C-Z]:* veya /) ya da home dizinini ([C-Z]:\home* veya /home) kullanmayın.
   Dağıtım yuvası ayarı	Seçildiğinde, depolama bağlama ayarları dağıtım yuvalarına da uygulanır.

Azure portalı

1. Azure portalında uygulamaya gidin.

2. Sol gezinti bölmesinde Ayarlar>Yapılandırması'nı seçin. Path eşlemeleri öğesini seçin ve ardından Yeni Azure Storage Bağlama'i seçin.

3. Depolama bağlamasını aşağıdaki tabloya göre yapılandırın. İşiniz bittiğinde Tamamseçin.

   Setting	Tanım
   İsim	Disk bağlama yapılandırmasının adı. Boşluk kullanmayın.
   Yapılandırma seçenekleri	Gelişmiş'i seçin.
   Depolama hesapları	Azure Depolama hesabı. bir Azure Files paylaşımı içermelidir.
   Paylaşım adı	Dosyalar paylaşmak için bağlanacak.
   Erişim anahtarı (Yalnızca gelişmiş)	Depolama hesabınız için erişim anahtarı .
   Bağlama yolu	Bağlamak istediğiniz Windows kapsayıcınızın içindeki dizin. Kök dizinini ([C-Z]:* veya /) ya da home dizinini ([C-Z]:\home* veya /home) kullanmayın.
   Uygulama ayarları	Azure Key Vault gizlisi içeren uygulama ayarını seçin.
   Dağıtım yuvası ayarı	Seçildiğinde, depolama bağlama ayarları dağıtım yuvalarına da uygulanır.

Azure portalı

1. Azure portalında uygulamaya gidin.

2. Sol gezinti bölmesinde Ayarlar>Yapılandırması'nı seçin. Path eşlemeleri öğesini seçin ve ardından Yeni Azure Storage Bağlama'i seçin.

3. Depolama bağlamasını aşağıdaki tabloya göre yapılandırın. İşiniz bittiğinde Tamamseçin.

   Setting	Tanım
   İsim	Disk bağlama yapılandırmasının adı. Boşluk kullanmayın.
   Yapılandırma seçenekleri	Depolama hesabı hizmet uç noktalarını, private uç noktalarını veya Azure Key Vault kullanmıyorsa Basic öğesini seçin. Aksi takdirde Gelişmiş'i seçin.
   Depolama hesapları	Azure Depolama hesabı.
   Depolama türü	Bağlamak istediğiniz depolama alanına göre türü seçin. Azure Blobları yalnızca salt okunur erişimi destekler.
   Depolama kapsayıcısı veya Paylaşım adı	Dosya paylaşımı veya bağlanacak Bloblar kapsayıcısı.
   Depolama erişimi	Anahtar kasası başvurusu'na tıklayın.
   Uygulama ayarları	Azure Key Vault sırrıyla yapılandırılmış mevcut uygulama ayarını seçin.
   Bağlama yolu	Linux kapsayıcısının içindeki, Azure Storage'a bağlanacak dizin. veya / kullanmayın.
   Dağıtım yuvası ayarı	Seçildiğinde, depolama bağlama ayarları dağıtım yuvalarına da uygulanır.

4. Depolama bağlamasına erişmek için Key Vault uygulamasına erişim sağlayın.

Azure CLI

Azure CLI kullanarak depolamayı bağlamak için depolama erişim anahtarını sağlamanız gerekir.

Azure CLI

az webapp config storage-account add komutunu kullanın. Örneğin:

az webapp config storage-account add --resource-group <group-name> --name <app-name> --custom-id <custom-id> --storage-type AzureFiles --share-name <share-name> --account-name <storage-account-name> --access-key "<access-key>" --mount-path <mount-path-directory>

• Windows kapsayıcılar için --storage-type değerini AzureFiles olarak ayarlayın.
• mount-path-directory veya [C-Z]:\path\to\dir olarak biçimlendirin.

Depolamanızın bağlandığını doğrulamak için aşağıdaki komutu çalıştırın:

az webapp config storage-account list --resource-group <resource-group> --name <app-name>

Azure CLI

Azure CLI şu anda depolamayı Key Vault erişimiyle bağlamayı desteklememektedir. Bunun yerine portalı kullanın.

Note

Depolama bağlaması ekleme, düzenleme veya silme işlemi uygulamayı yeniden başlatır.

En iyi yöntemler

• Gecikme sorunlarını önlemek için uygulamayı ve Azure Storage hesabını aynı bölgeye yerleştirin. Uygulama ve Azure Storage hesabı aynı bölgede olduğunda Azure Storage güvenlik duvarı yapılandırması App Service IP adreslerinden erişim izni verirseniz, bu IP kısıtlamaları kabul edilmez.

• Azure Storage hesabında, uygulamadaki depolamayı bağlamak için kullandığınız erişim anahtarını yeniden oluşturmaktan kaçının. Depolama hesabı iki anahtar içerir. Azure App Service bir Azure depolama hesabı anahtarı depolar. Anahtar yeniden oluşturma sırasında depolama bağlamasının uygulamada kullanılabilir durumda kaldığından emin olmak için adım adım bir yaklaşım kullanın. Örneğin, uygulamanızda depolama bağlamayı yapılandırmak için key1 kullandığınız varsayılır:

  1. Anahtar2'i yeniden üretin.
  2. Yeniden oluşturulan anahtar2'yı kullanmak için depolama bağlama yapılandırmasında erişim anahtarını güncelleyin.
  3. Anahtar1'i yeniden üretin.

• Bir Azure Storage hesabı, kapsayıcıyı veya paylaşımı silerseniz, olası hata senaryolarını önlemek için uygulamadaki ilgili depolama bağlama yapılandırmasını kaldırın.

• Bağlı Azure Storage hesabı Standart veya Premium performans katmanı olabilir. Uygulama kapasitesi ve aktarım hızı gereksinimlerine göre depolama hesabı için uygun performans katmanını seçin. Dosyalar için ölçeklenebilirlik ve performans hedeflerine bakın.

• Uygulamanız birden çok örneğe ölçekleniyorsa, tüm örnekler aynı eklenmiş Azure Storage hesabına bağlanır. Performans sorunlarını ve aktarım hızı sorunlarını önlemek için depolama hesabı için uygun performans katmanını seçin.

• SQLite gibi yerel veritabanları veya dosya tanıtıcıları ve kilitleri kullanan diğer uygulamalar ve bileşenler için depolama bağlamaları kullanmayın.

• Sanal ağ tümleştirmesi ile Azure Files kullanırken 445 numaralı bağlantı noktasının açık olduğundan emin olun.

• Depolama hesabı uygulamaya bağlandığında depolama yük devretmesini başlatırsanız, uygulama yeniden başlatılana kadar veya depolama bağlaması kaldırılıp yeniden eklenene kadar bağlantı gerçekleşmez.

Sonraki adım

Özel bir kapsayıcı kullanarak özel yazılımı Azure App Service'e taşıyın

Note

NFS desteği artık App Service on Linux için kullanılabilir.

Bu kılavuzda, Azure Storage'ın yerleşik bir Linux kapsayıcısında veya App Service'teki özel bir Linux kapsayıcısında ağ paylaşımı olarak nasıl bağlanacağı gösterilmektedir. Azure Storage, Microsoft'un modern veri depolama senaryoları için bulut depolama çözümüdür. Azure Storage, buluttaki veri nesneleri için yüksek oranda kullanılabilir, yüksek oranda ölçeklenebilir, dayanıklı ve güvenli depolama sunar. Azure Storage, App Service için varsayılan depolama alanı değildir. Ayrı faturalandırılır. Azure Storage'i bir ARM şablonunda da yapılandırabilirsiniz.

Özel olarak bağlanan depolamanın avantajlarından bazıları şunlardır:

• App Service uygulamanız için kalıcı depolamayı yapılandırın ve depolamayı ayrı olarak yönetin.
• Video ve görüntü gibi statik içerikleri App Service uygulamanızda kullanıma hazır hale getirin.
• Azure Dosya paylaşımlarına uygulama günlüğü dosyaları yazın veya eski uygulama günlüğünü arşivleyin.
• İçeriği birden çok uygulamada veya diğer Azure hizmetleriyle paylaşın.
• Azure Files NFS ve Azure Files SMB destekler.
• Azure Blob'ları destekler (salt okunur).
• Uygulama başına en fazla beş bağlama noktasını destekler.

Özel olarak bağlanan depolamanın sınırlamaları şunlardır:

• Depolama güvenlik duvarı yalnızca sanal ağ tümleştirmesi kullandığınızda hizmet uç noktaları ve özel uç noktalar aracılığıyla desteklenir.
• Özel olarak bağlanan depolamaya FTP/FTPS erişimi desteklenmez. Azure Storage Explorer kullanın.
• Desteklenen tek kimlik doğrulaması aracı depolama hesabı paylaşılan erişim anahtarlarıdır. Entra ID ve RBAC Rolleri desteklenmez.
• Azure CLI, Azure PowerShell ve Azure SDK desteği önizleme aşamasındadır.
• Özel monte edilen depolamayı / veya /home ile eşleştirmek desteklenmez.
• Depolama bağlamasını /tmp veya alt dizinlerine eşlemeyin. Bu eylem, uygulama başlatma sırasında zaman aşımına neden olabilir.
• Azure Storage Docker Compose senaryolarında desteklenmez.
• Depolama bağlamaları yedeklemelere dahil değildir. Azure Storage hesaplarını yedeklemek için en iyi yöntemleri izlediğinden emin olun.
• NFS desteği yalnızca App Service on Linux için kullanılabilir. NFS, Windows kodu ve Windows kapsayıcıları için desteklenmez. Web uygulamasının ve depolama hesabının NFS için aynı sanal ağda yapılandırılması gerekir. Dosya paylaşımı için kullanılan depolama hesabının Premium performans katmanı ve Hesap Türü olarak Dosya depolaması olmalıdır. Azure Key Vault, NFS protokolü kullanılırken geçerli değildir.
• Uygulamanıza sanal ağ tümleştirmesi eklediğinizde, bağlı sürücü sanal ağınızdaki bir IP adresini değil, bir RFC1918 IP adresini kullanır.

Montaj seçenekleri

Depolamayı uygulamaya bağlamanız gerekir. Azure depolama için üç bağlama seçeneği şunlardır:

Bağlama seçeneği	Kullanım
Temel	Azure portalını kullanarak depolamayı bağlamak için bu seçeneği belirleyin. Depolama hesabı hizmet uç noktalarını, private uç noktalarını veya Azure Key Vault kullanmadığı sürece temel seçeneği kullanabilirsiniz. Bu durumda portal sizin için erişim anahtarını alır ve depolar.
Erişim Tuşu	Azure CLI kullanarak depolamayı bağlamayı planlıyorsanız bir erişim anahtarı almanız gerekir. Depolama hesabı hizmet uç noktaları, özel uç noktaları veya Azure Key Vault kullanmıyorsa bu seçeneği belirtin.
Key Vault	Erişim anahtarı gerektiren Azure CLI kullanarak depolamayı bağlamayı planlarken de bu seçeneği kullanın. Erişim anahtarlarını güvenli bir şekilde depolamak ve almak için Azure Key Vault kullanırken bu seçeneği belirleyin. Azure Key Vault Azure App Service gibi diğer Azure hizmetlerini izleme, yönetme ve tümleştirme özelliğiyle uygulama gizli dizilerini merkezi ve güvenli bir şekilde depolamanın avantajlarına sahiptir.

Önkoşullar

Basic

• Mevcut bir App Service on Linux uygulaması.
• Azure Storage hesabı.
• Azure dosya paylaşımı ve dizini.

Erişim Anahtarı

• Mevcut bir App Service on Linux uygulaması.
• Azure Storage hesabı.
• Azure dosya paylaşımı ve dizini.

Key Vault

• Mevcut bir App Service on Linux uygulaması.
• Azure Storage hesabı.
• Azure dosya paylaşımı ve dizini.
• Azure Storage ile yapılandırılması gereken vault erişim ilkesi ve bir secret kullanan bir Azure Key Vault örneği.

Montaja hazırlanma

Basic

Portal sizin için erişim anahtarını aldığından ve depoladığı için ek adım gerekmez.

Erişim Anahtarı

Erişim anahtarını depolama hesabınızdan almanız gerekir.

Key Vault

Key Vault erişimini kullanarak depolamayı bağlamadan önce, Key Vault gizli bilgilerini almanız ve uygulamanızda uygulama ayarı olarak eklemeniz gerekir.

1. Azure portalında "Key Vault"a gidin. Nesneleri>Gizliler'i seçin. Gizli Dizi Tanımlayıcısını panoya kopyalayın.

   

2. Uygulamanıza döndüğünüzde, anahtar kasası başvurusunu izleyerek Secret Identifier'ı kullanarak bir uygulama ayarı oluşturun.

   Örnek uygulama ayarı değeri: @Microsoft.KeyVault(SecretUri=https://mykeyvault.vault.azure.net/secrets/mykeyvaultsecret/aaaaaaaa0b0b1c1c2d2d333333333333)

Artık depolama hesabınıza erişmek için Key Vault kullanmaya hazırsınız.

Depolamayı Linux kapsayıcısına bağlama

Depolamayı bağlama yönteminiz, depolama erişim seçeneğiniz ve portalı mı yoksa Azure CLI mi kullandığınıza bağlıdır.

Azure portalı

1. Azure portalında uygulamaya gidin.

2. Sol gezinti bölmesinde Ayarlar>Yapılandırması'nı seçin. Path eşlemeleri öğesini seçin ve ardından Yeni Azure Storage Bağlama'i seçin.

3. Depolama bağlamasını aşağıdaki tabloya göre yapılandırın. İşiniz bittiğinde Tamamseçin.

   Setting	Tanım
   İsim	Disk bağlama yapılandırmasının adı. Boşluk kullanmayın.
   Yapılandırma seçenekleri	Depolama hesabı hizmet uç noktaları, private uç noktaları veya Azure Key Vault kullanmıyorsa Basic öğesini seçin. Aksi takdirde Gelişmiş'i seçin.
   Depolama hesapları	Azure Depolama hesabı.
   Depolama türü	Bağlamak istediğiniz depolama alanına göre türü seçin. Azure Blobları yalnızca salt okunur erişimi destekler.
   Depolama kapsayıcısı veya Paylaşım adı	Dosya paylaşımı veya bağlanacak Bloblar kapsayıcısı.
   Bağlama yolu	Azure Storage bağlamak için Linux kapsayıcısının içindeki dizin. veya / kullanmayın.
   Dağıtım yuvası ayarı	İşaretlendiğinde, depolama bağlama ayarları dağıtım yuvalarına da uygulanır.

Azure portalı

1. Azure portalında uygulamaya gidin.

2. Sol gezinti bölmesinde Ayarlar>Yapılandırması'nı seçin. Path eşlemeleri öğesini seçin ve ardından Yeni Azure Storage Bağlama'i seçin.

3. Depolama bağlamasını aşağıdaki tabloya göre yapılandırın. İşiniz bittiğinde Tamamseçin.

   Setting	Tanım
   İsim	Disk bağlama yapılandırmasının adı. Boşluk kullanmayın.
   Yapılandırma seçenekleri	Gelişmiş'i seçin.
   Depolama hesapları	Azure Storage hesabı.
   Depolama türü	Bağlamak istediğiniz depolama alanına göre türü seçin. Azure Blobları yalnızca salt okunur erişimi destekler.
   Depolama kapsayıcısı veya Paylaşım adı	Dosya paylaşımı veya bağlanacak Bloblar kapsayıcısı.
   Depolama erişimi	El ile giriş'i seçin.
   Erişim anahtarı	Depolama hesabınızın erişim anahtarını girin.
   Bağlama yolu	Azure Storage'a bağlanmak üzere Linux kapsayıcı içindeki dizin. veya / kullanmayın.
   Dağıtım yuvası ayarı	Seçildiğinde, depolama bağlama ayarları dağıtım yuvalarına da uygulanır.

Azure portalı

1. Azure portalında uygulamaya gidin.

2. Sol gezinti bölmesinde Ayarlar>Yapılandırması'nı seçin. Path eşlemeleri öğesini seçin ve ardından Yeni Azure Storage Bağlama'i seçin.

3. Depolama bağlamasını aşağıdaki tabloya göre yapılandırın. İşiniz bittiğinde Tamamseçin.

   Setting	Tanım
   İsim	Disk bağlama yapılandırmasının adı. Boşluk kullanmayın.
   Yapılandırma seçenekleri	Gelişmiş'i seçin.
   Depolama hesapları	Azure Depolama hesabı.
   Depolama türü	Bağlamak istediğiniz depolama alanına göre türü seçin. Azure Blobları yalnızca salt okunur erişimi destekler.
   Depolama kapsayıcısı veya Paylaşım adı	Dosya paylaşımı veya bağlanacak Bloblar kapsayıcısı.
   Depolama erişimi	Anahtar kasası başvurusu'na tıklayın.
   Uygulama ayarları	Azure Key Vault sırrıyla yapılandırılmış mevcut uygulama ayarını seçin.
   Bağlama yolu	Linux kapsayıcısının içindeki, Azure Storage'a bağlanacak dizin. veya / kullanmayın.
   Dağıtım yuvası ayarı	Seçildiğinde, depolama bağlama ayarları dağıtım yuvalarına da uygulanır.

4. Depolama bağlamasına erişmek için Key Vault uygulamasına erişim sağlayın.

Azure CLI

Depolamayı bağlamak için Azure CLI kullanmak için depolama erişim anahtarını sağlamanız gerekir.

Azure CLI

az webapp config storage-account add komutunu kullanın. Örneğin:

az webapp config storage-account add --resource-group <group-name> --name <app-name> --custom-id <custom-id> --storage-type AzureFiles --share-name <share-name> --account-name <storage-account-name> --access-key "<access-key>" --mount-path <mount-path-directory>

• --storage-typeveya AzureBlobolabilirAzureFiles. AzureBlob salt okunurdur.
• --mount-path, Linux kapsayıcısı içinde Azure Storage'a bağlanacak olan dizindir. kök dizinini kullanmayın /.

Aşağıdaki komutu çalıştırarak depolamanızın bağlandığını doğrulayın:

az webapp config storage-account list --resource-group <resource-group> --name <app-name>

Azure CLI

Azure CLI şu anda depolamayı Key Vault erişimi kullanarak bağlamayı desteklememektedir. Bunun yerine portalı kullanın.

Note

Depolama bağlaması ekleme, düzenleme veya silme işlemi uygulamayı yeniden başlatır.

Bağlı depolamayı doğrulayın

uygulama için Azure Storage başarıyla bağlandığını doğrulamak için:

1. Kapsayıcıda bir SSH oturumu açın.

2. SSH terminalinde aşağıdaki komutu yürütür:

   df –h 
   

3. Depolama paylaşımının takılı olup olmadığını denetleyin. Eğer mevcut değilse, depolama paylaşımını bağlama ile ilgili bir sorun vardır.

4. Aşağıdaki komutu kullanarak depolama bağlamasının gecikme süresini veya genel erişilebilirliğini denetleyin:

   tcpping Storageaccount.file.core.windows.net 
   

Depolama bağlama sistem durumu denetimleri ve otomatik kurtarma

Azure App Service, bağlı Azure Storage birimlerinin (Azure Files veya Azure Blob) erişilebilir ve yanıt vermeye devam etmesini sağlayan yerleşik bir sistem durumu denetimi mekanizması içerir. Bu sistem, eski veya bağlantısı kesilmiş depolama bağlamalarından kaynaklanan uygulama kilitlenmelerini önlemeye yardımcı olur.

Sistem sağlık denetimi nasıl çalışır?

1. Düzenli G/Ç testi
   App Service, __lastCheckTime.txt adlı bir işaretçi dosyasında düzenli aralıklarla dosya G/Ç işlemlerini gerçekleştirir.

   • Konum:LogFiles Bağlı yolun altındaki bir alt dizin (örneğin, /mount/path/LogFiles/__lastCheckTime.txt).
   • Davranış:
     • Bu dosyada bir okuma işlemi denendi.
     • Dosyanın mevcut olması gerekmez; "dosya bulunamadı" başarılı bir denetim olarak değerlendirilir.

2. Sıklık
   Denetim varsayılan olarak her 5 saniyede bir çalışır.

3. Hata işleme

   • Başarısız olan veya zaman aşımına uğrayan her bir kontrol, başarısız ping sayacını arttırır.
   • Hatalar yapılandırılan eşiği aştığında:
     • Azure Files: 18 başarısız ping
     • Azure Blob: 15 başarısız ping
   • Bağlama noktası Hatalı olarak işaretlenir ve App Service, paylaşım bağlantısını geri yüklemek için uygulamayı otomatik olarak yeniden başlatır.

Uygulama Ayarları aracılığıyla yapılandırma

Aşağıdaki uygulama ayarlarını kullanarak sistem durumu denetimi davranışını özelleştirebilirsiniz.

Depolama türü	Ayarın adı	Varsayılan değer	Tanım
Azure Files	WEBSITE_BYOS_FILES_HEALTH_CHECK_FREQUENCY	5	Sağlık denetimleri arasındaki saniye cinsinden aralık.
Azure Files	WEBSITE_BYOS_FILES_MAX_FAILED_PINGS	18	Birimi hatalı olarak işaretlemeden önce ardışık hata sayısı.
Azure Files	WEBSITE_BYOS_FILES_AUTO_RECOVERY_ENABLED	true	false Otomatik kurtarma mantığını devre dışı bırakmak için olarak ayarlayın.
Azure Blob	WEBSITE_BYOS_BLOB_HEALTH_CHECK_FREQUENCY	5	Sağlık denetimleri arasındaki saniye cinsinden aralık.
Azure Blob	WEBSITE_BYOS_BLOB_MAX_FAILED_PINGS	15	Birimi hatalı olarak işaretlemeden önce ardışık hata sayısı.
Azure Blob	WEBSITE_BYOS_BLOB_AUTO_RECOVERY_ENABLED	true	false Otomatik kurtarma mantığını devre dışı bırakmak için olarak ayarlayın.
Azure Blob	WEBSITE_BYOS_BLOB_DIRECT_IO	false	Etkinleştirilirse, tüm işlemler doğrudan uzak depolamayı sorgular ve önbelleğe alma atlanır. Bu ayar uygulama düzeyinde uygulanır ve bu nedenle uygulama tarafından bağlanan tüm blob paylaşımlarını etkiler.

Notes

• Otomatik kurtarma, yanıt vermeyen depolama yollarından kaynaklanan uzun süre çalışan uygulama kilitlenmelerini önlemeye yardımcı olur.
• Belirli bağlama davranışıyla ilgili sorunları gidermediğiniz sürece otomatik kurtarmayı devre dışı bırakmayın.

En iyi yöntemler

Performance

• Gecikme sorunlarını önlemek için uygulamayı ve Azure Storage hesabını aynı bölgeye yerleştirin. Uygulama ve Azure Storage hesabı aynı bölgede olduğunda Azure Storage güvenlik duvarı yapılandırması App Service IP adreslerinden erişim izni verirseniz, bu IP kısıtlamaları kabul edilmez.

• Bağlı Azure Storage hesabı Standart veya Premium performans katmanı olabilir. Uygulama kapasitesi ve aktarım hızı gereksinimlerine göre depolama hesabı için uygun performans katmanını seçin. Depolama türüne karşılık gelen ölçeklenebilirlik ve performans hedeflerine bakın: Dosyalar ve Bloblar.

• Uygulamanız birden çok örneğe ölçekleniyorsa, tüm örnekler aynı eklenmiş Azure Storage hesabına bağlanır. Performans sorunlarını ve aktarım hızı sorunlarını önlemek için depolama hesabı için uygun performans katmanını seçin.

Güvenlik

• Azure Storage hesabında, uygulamadaki depolamayı bağlamak için kullandığınız erişim anahtarını yeniden oluşturmaktan kaçının. Depolama hesabı iki anahtar içerir. Azure App Hizmetleri bir Azure depolama hesabı anahtarı depolar. Anahtar yeniden oluşturma sırasında depolama bağlamasının uygulamada kullanılabilir durumda kaldığından emin olmak için adım adım bir yaklaşım kullanın. Örneğin, uygulamanızda depolama bağlamayı yapılandırmak için key1 kullandığınız varsayılır:

  1. Anahtar2'i yeniden üretin.
  2. Yeniden oluşturulan anahtar2'yı kullanmak için depolama bağlama yapılandırmasında erişim anahtarını güncelleyin.
  3. Anahtar1'i yeniden üretin.

Yapılandırma

• Değişikliklerin dosyaları hızla değiştirmesini, eklemesini veya kaldırmasını beklediğiniz gerçek zamanlı bir dosya sistemi kullanmanız gerekiyorsa, depolamayı bağlarken depolama türü olarak Azure Files kullanın. Dosyalar statik olduğunda ve değişmelerini beklemiyorsanız Azure Blob kullanın.

Sorun giderme

• Özel kapsayıcıdaki bağlama dizini boş olmalıdır. Örneğin /home altında bir dizin belirtirseniz, Azure Storage bağlandığında bu yolda depolanan tüm içerik silinir. Mevcut bir uygulamanın dosyalarını geçirirseniz başlamadan önce uygulamanın ve içeriğinin yedeğini alın.
• NFS paylaşımını bağlarken, depolama hesabında Güvenli Aktarım Gerekli'nin devre dışı bırakıldığından emin olmanız gerekir. Bu ayar etkinleştirildiğinde App Service NFS paylaşımlarını bağlamayı desteklemez. Güvenlik önlemi olarak 2049 numaralı bağlantı noktasını ve sanal ağ tümleştirmesini ve özel uç noktaları kullanır.
• Bir Azure Storage hesabı, kapsayıcıyı veya paylaşımı silerseniz, olası hata senaryolarını önlemek için uygulamadaki ilgili depolama bağlama yapılandırmasını kaldırın.
• SQLite gibi yerel veritabanları veya dosya tanıtıcıları ve kilitleri kullanan diğer uygulamalar ve bileşenler için depolama bağlamaları kullanmayın.
• Sanal ağ tümleştirmesi kullanılırken aşağıdaki bağlantı noktalarının açık olduğundan emin olun: Azure Files: 80 ve 445. Azure Blobları: 80 ve 443.
• Depolama hesabı uygulamaya bağlandığında depolama yük devretmesini başlatırsanız, uygulama yeniden başlatılana kadar veya depolama bağlaması kaldırılıp yeniden eklenene kadar bağlantı gerçekleşmez.

İlgili içerik

• Özel bir kapsayıcı yapılandırın
• Video: Azure Storage'ı yerel paylaşım olarak nasıl bağlarsınız