App Service uygulamasını yapılandırma

Bu makalede web uygulamaları, mobil arka uç veya API uygulaması için genel ayarları yapılandırma açıklanmaktadır. Azure İşlevleri için Azure İşlevleri için Uygulama Ayarları Başvurusu'na bakın.

Uygulama ayarlarını yapılandırma

Azure App Service'te uygulama ayarları, uygulama koduna ortam değişkeni olarak geçirilen değişkenlerdir. Aşağıdaki koşullar uygulama ayarları için geçerlidir:

• Uygulama ayarı adları yalnızca harf, sayı (0-9), nokta (.) ve alt çizgi (_) içerebilir.
• Bir uygulama ayarının değerindeki özel karakterler, hedef işletim sisteminin gerektirdiği durumlarda kaçış karakteri kullanılarak yazılmalıdır.

Örneğin, Linux için App Service'te değeriyle "pa$$w0rd\"bir ortam değişkeni ayarlamak için, uygulama ayarının dizesi olmalıdır "pa\$\$w0rd\\".

Linux uygulamaları ve özel kapsayıcılar için App Service, kapsayıcıdaki ortam değişkenini ayarlamak için bayrağını --env kullanarak uygulama ayarlarını kapsayıcıya geçirir. Her iki durumda da uygulama başlatma sırasında uygulama ortamınıza eklenmiştir. Uygulama ayarlarını eklediğinizde, kaldırdığınızda veya düzenlediğinizde, App Service uygulamanın yeniden başlatılmasını tetikler.

ASP.NET ve ASP.NET Core geliştiricileri için App Service'te uygulama ayarlarını yapılandırmak, <appSettings>Web.config veya appsettings.json içinde yapılandırmaya benzer. App Service'teki değerler, Web.config veya appsettings.json içindeki değerleri geçersiz kılar. Yerel MySQL parolası gibi geliştirme ayarlarını Web.config veya appsettings.json içinde tutabilirsiniz. Azure MySQL veritabanı parolası gibi üretim gizli dizilerini App Service'te güvenli bir şekilde tutabilirsiniz. Aynı kod, yerel olarak hata ayıklarken geliştirme ayarlarınızı kullanır. Azure'a dağıttığınızda üretim sırlarınızı kullanır.

Diğer dil yığınları uygulama ayarlarını çalışma zamanında ortam değişkenleri olarak alır. Her dil yığınına özgü adımlar için bkz:

• ASP.NET Core
• Java
• Node.js
• Piton
• PHP
• Özel kapsayıcılar

Uygulama ayarları depolandıklarında her zaman şifrelenir (bekleme sırasında şifrelenir).

Uyarı

Gizli bilgileri uygulama ayarlarında depolarsanız Azure Key Vault referanslarını kullanmayı göz önünde bulundurun. Gizli bilgileriniz arka uç kaynaklarına bağlantı amaçlıysa, daha güvenli ve sır gerektirmeyen bağlantı seçeneklerini değerlendirin. Daha fazla bilgi için bkz. Azure Uygulaması Hizmetinden Azure hizmetlerine ve veritabanlarına güvenli bağlantı.

Azure portalı

1. Azure portalında Uygulama Hizmetleri'ni arayıp seçin ve ardından uygulamanızı seçin.

2. Uygulamanın sol menüsünde Ayarlar>Ortam değişkenleri'ni seçin. Ardından Uygulama ayarları'nı seçin.

   

   Varsayılan olarak, uygulama ayarlarının değerleri güvenlik için portalda gizlenir. Bir uygulama ayarının gizli değerini görmek için Değer'in altında Değeri göster'i seçin. Tüm uygulama ayarlarının gizli değerlerini görmek için Değerleri göster'i seçin.

   Uyarı

   Bu bölümü Azure portalında görüntülemek için Okuma/Yazma kullanıcı izinleri gereklidir. Yeterli izinlere sahip RBAC yerleşik rolleri Sahip, Katkıda Bulunan ve Web Sitesi Katkıda Bulunanı'dır. Yalnızca Okuyucu rolünün bu sayfaya erişmesine izin verilmez.

3. Yeni bir uygulama ayarı eklemek için Ekle'yi seçin. Bir ayarı düzenlemek için ayarı seçin.

4. İletişim kutusunda, ayarı geçerli yuvaya sabitleyebilirsiniz.

   Uyarı

   Varsayılan linux uygulama hizmetinde veya özel bir Linux kapsayıcısında, uygulama ayarı adındaki iç içe JSON anahtar yapısının anahtar adı için farklı yapılandırılması gerekir. Herhangi bir iki nokta (:) yerine çift alt çizgi (__) ile değiştirin. Herhangi bir dönemi (.) tek bir alt çizgi (_) ile değiştirin. Örneğin, anahtar adı olarak App Service'te ApplicationInsights:InstrumentationKey, ApplicationInsights__InstrumentationKey şeklinde yapılandırılmalıdır.

5. bitirdiğinizde Uygula'yı seçin. Ardından Ortam değişkenleri sayfasında Uygula'yı seçin.

Azure CLI

az webapp config app settings set komutunu kullanarak uygulama ayarı ekleyin veya düzenleyin:

az webapp config appsettings set --resource-group <group-name> --name <app-name> --settings <setting-name>="<value>"

<setting-name> ile ayarın adını değiştirin. Ayarın değerini <value> ile değiştirin.

az webapp config appsettings list komutunu kullanarak tüm ayarları ve değerlerini gösterin:

az webapp config appsettings list --resource-group <group-name> --name <app-name>

az webapp config app settings delete komutunu kullanarak bir veya daha fazla ayarı kaldırın:

az webapp config appsettings delete --resource-group <group-name> --name <app-name> --setting-names {<setting-name1>,<setting-name2>,...}

Azure PowerShell

Set-AzWebApp kullanarak bir veya daha fazla uygulama ayarı yapın:

Set-AzWebApp -ResourceGroupName <group-name> -Name <app-name> -AppSettings @{"<setting-name1>"="<value1>"; "<setting-name2>"="<value2>";...}

Bu cmdlet, tüm uygulama ayarları kümesini belirttiğiniz ayarlarla değiştirir. Mevcut bir kümeye uygulama ayarı eklemek veya düzenlemek için Get-AzWebApp cmdlet'ini kullanarak giriş karma tablonuza mevcut uygulama ayarlarını ekleyin. Örneğin:

# Get app configuration
$webapp=Get-AzWebApp -ResourceGroupName <group-name> -Name <app-name>

# Copy app settings to a new hash table
$appSettings = @{}
ForEach ($item in $webapp.SiteConfig.AppSettings) {
$appSettings[$item.Name] = $item.Value
}

# Add or edit one or more app settings
$appSettings['<setting-name1>'] = '<value1>'
$appSettings['<setting-name2>'] = '<value2>'

# Save changes
Set-AzWebApp -ResourceGroupName <group-name> -Name <app-name> -AppSettings $appSettings

Bir uygulama ayarının yuvaya özel olup olmadığını kontrol etmek için Get-AzWebAppSlotConfigName kullanın:

Get-AzWebAppSlotConfigName -ResourceGroupName <group-name> -Name <app-name> | select AppSettingNames

Bir veya daha fazla uygulama ayarı yuvasına özgü hale getirmek için Set-AzWebAppSlotConfigName kullanın:

Set-AzWebAppSlotConfigName -ResourceGroupName <group-name> -Name <app-name> -AppSettingNames <setting-name1>,<setting-name2>,...

Uygulama ayarlarını toplu olarak düzenleme

Azure portalı

1. Gelişmiş düzenleme'yi seçin.
2. Metin alanındaki ayarları düzenleyin.
3. İşiniz bittiğinde Tamam'a tıklayın. Ardından Ortam değişkenleri sayfasında Uygula'yı seçin.

Uygulama ayarları aşağıdaki JSON biçimlendirmesine sahiptir:

[
  {
    "name": "<key-1>",
    "value": "<value-1>",
    "slotSetting": false
  },
  {
    "name": "<key-2>",
    "value": "<value-2>",
    "slotSetting": false
  },
  ...
]

Azure CLI

Çalıştırın: az webapp config app settings set komutunu, JSON dosyasının adıyla birlikte.

az webapp config appsettings set --resource-group <group-name> --name <app-name> --settings "@fileName.json"

Tavsiye

Dosya adını tırnak içine almak yalnızca PowerShell'de gereklidir.

Gerekli dosya biçimi, yuva ayarı alanının isteğe bağlı olduğu bir JSON ayar dizisidir. Örneğin:

[
  {
    "name": "key1",
    "slotSetting": false,
    "value": "value1"
  },
  {
    "name": "key2",
    "value": "value2"
  }
]

Kolaylık sağlamak için az webapp config appsettings list komutunu kullanarak mevcut ayarları bir JSON dosyasına kaydedebilirsiniz.

# Save the settings
az webapp config appsettings list --resource-group <group-name> --name <app-name>  > settings.json

# Edit the JSON file
...

# Update the app with the JSON file
az webapp config appsettings set --resource-group <group-name> --name <app-name> --settings @settings.json

Azure PowerShell

Azure PowerShell ile JSON dosyası kullanarak uygulama ayarlarını toplu olarak düzenlemek mümkün değildir.

Bağlantı dizelerini yapılandırma

Bu bölümde bağlantı dizelerinin nasıl yapılandırıldığı açıklanmaktadır.

Uyarı

Daha güvenli olan ve gizli bağlantı bilgileri gerektirmeyen bağlantı seçeneklerini göz önünde bulundurun. Daha fazla bilgi için bkz. Azure Uygulaması Hizmetinden Azure hizmetlerine ve veritabanlarına güvenli bağlantı.

ASP.NET ve ASP.NET Core geliştiricileri için App Service'te bağlantı dizelerini ayarlamak, <connectionStrings> içinde Web.config ayarlamak gibidir. App Service'te ayarladığınız değerler içindeki Web.configdeğerleri geçersiz kılar. veritabanı dosyası gibi geliştirme ayarlarını içinde Web.configtutabilirsiniz. SQL veritabanı kimlik bilgileri gibi üretim gizli dizilerini App Service'te güvenli bir şekilde tutabilirsiniz. Aynı kod, yerel olarak hata ayıklarken geliştirme ayarlarınızı kullanır. Azure'a dağıttığınızda üretim sırlarınızı kullanır.

Diğer dil yığınları için bunun yerine uygulama ayarlarını kullanmak daha iyidir. Bağlantı dizeleri, değerlere erişmek için değişken anahtarlarında özel biçimlendirme gerektirir.

non-.NET diller için uygulama ayarları yerine bağlantı dizelerini kullanmak isteyebileceğiniz bir durum vardır. Belirli Azure veritabanı türleri , uygulamayla birlikte yalnızca App Service uygulamanızdaki veritabanı için bir bağlantı dizesi yapılandırdığınızda yedeklenir. Daha fazla bilgi için bkz . Özel yedekleme oluşturma. Bu otomatik yedeklemeye ihtiyacınız yoksa uygulama ayarlarını kullanın.

Çalışma zamanında, bağlantı dizeleri ortam değişkenleri olarak kullanılabilir ve bu değişkenler, aşağıdaki bağlantı türleriyle ön eklenmiştir:

• SQL Server: SQLCONNSTR_
• MySQL: MYSQLCONNSTR_
• Azure SQL: SQLAZURECONNSTR_
• Özel: CUSTOMCONNSTR_
• PostgreSQL: POSTGRESQLCONNSTR_
• Azure Notification Hubs: NOTIFICATIONHUBCONNSTR_
• Azure Service Bus: SERVICEBUSCONNSTR_
• Azure Event Hubs: EVENTHUBCONNSTR_
• Azure Cosmos DB: DOCDBCONNSTR_
• Redis önbelleği: REDISCACHECONNSTR_

Uyarı

PostgreSQL, Notification Hubs, Service Bus, Event Hubs, Azure Cosmos DB ve Redis cache'i hedefleyen .NET uygulamaları, .NET OrtamıVariablesConfigurationProvider'daki bilinen bir sorun için geçici çözüm olarak bağlantı dizesini Özel olarak ayarlamalıdır.

Örneğin, connectionstring1 adlı bir MySQL bağlantı dizesi ortam değişkeni MYSQLCONNSTR_connectionString1olarak erişilebilir. Her dil yığınına özgü adımlar için bkz:

• ASP.NET Core
• Java
• Node.js
• Piton
• PHP
• Özel kapsayıcılar

Bağlantı dizeleri depolandıklarında her zaman şifrelenir (sabit durumda şifreleme ile korunur).

Uyarı

Key Vault başvurularını kullanarak Key Vault'tan bağlantı dizgilerini çözebilirsiniz.

Azure portalı

1. Azure portalında Uygulama Hizmetleri'ni arayıp seçin ve ardından uygulamanızı seçin.

2. Uygulamanın sol menüsünde Ayarlar>Ortam değişkenleri'ni seçin. Ardından Bağlantı dizeleri'ne tıklayın.

   Varsayılan olarak, bağlantı dizesi değerleri güvenlik için portalda gizlenir. Bağlantı dizesinin gizli değerini görmek için Değer'in altında Değeri göster'i seçin. Tüm bağlantı dizelerinin gizli değerlerini görmek için Değerleri göster'i seçin.

3. Yeni bir bağlantı dizesi eklemek için Ekle'yi seçin. bir bağlantı dizesi düzenlemek için bağlantı dizesi seçin.

4. İletişim kutusunda, bağlantı dizisini geçerli yuvaya yapıştırabilirsiniz.

5. bitirdiğinizde Uygula'yı seçin. Ardından Ortam değişkenleri sayfasında Uygula'yı seçin.

Azure CLI

az webapp config connection-string set komutunu kullanarak uygulama ayarı ekleyin veya düzenleyin:

az webapp config connection-string set --resource-group <group-name> --name <app-name> --connection-string-type <type> --settings <string-name>='<value>'

<string-name> değerini bağlantı dizesinin adıyla değiştirin. <value> öğesini, bağlantı dizesine atanacak değerle değiştirin. gibi olası değerleri <type> için SQLAzure.

az webapp config connection-string list komutunu kullanarak tüm bağlantı dizelerini ve bunların değerlerini gösterin:

az webapp config connection-string list --resource-group <group-name> --name <app-name>

az webapp config connection-string delete komutunu kullanarak bir veya daha fazla bağlantı dizesini kaldırın:

az webapp config connection-string delete --resource-group <group-name>  --name <app-name>--setting-names {<string-name1>,<string-name2>,...}

Azure PowerShell

Set-AzWebApp kullanarak bir veya daha fazla bağlantı dizesi ayarlayın:

$PropertiesObject = @{
  "<string-name1>" = @{
    value="<connection-string1>";
    type="<type>"};
  "<string-name2>" = @{
    value="<connection-string2>";
    type="<type>"}
}

Set-AzWebApp -ResourceGroupName <group-name> -Name <app-name> -ConnectionStrings $PropertiesObject

Her bağlantı dizesi bir ad (<string-name1> ), bir değer ()<connection-string1> ve türü içerir. Tür, ConnectionStringType numaralandırıcı alanlarından birine karşılık gelen sayısal bir değerdir. Örneğin, Azure SQL için belirtin type="2".

Bu cmdlet, bağlantı dizelerinin tamamını belirttiğiniz dizelerle değiştirir. Mevcut bir kümeye uygulama ayarı eklemek veya düzenlemek için Get-AzWebApp cmdlet'ini kullanarak giriş karma tablonuza mevcut uygulama ayarlarını ekleyin. Örneğin:

# Get app configuration
$webapp=Get-AzWebApp -ResourceGroupName <group-name> -Name <app-name>

# Copy connection strings to a new hash table
$connStrings = @{}
ForEach ($item in $webapp.SiteConfig.ConnectionStrings) {
    $connStrings[$item.Name] = @{value=$item.ConnectionString; type=$item.Type.ToString()}
}

# Add or edit one or more connection strings
$connStrings['<string-name1>'] = @{value='<connection-string1>'; type='<type>'}
$connStrings['<string-name2>'] = @{value='<connection-string2>'; type='<type>'}

# Save changes
Set-AzWebApp -ResourceGroupName <group-name> -Name <app-name> -ConnectionStrings $connStrings

Bağlantı dizesinin yuvaya özgü olup olmadığını denetlemek için Get-AzWebAppSlotConfigName komutunu kullanın:

Get-AzWebAppSlotConfigName -ResourceGroupName <group-name> -Name <app-name> | select ConnectionStringNames

Bir veya daha fazla bağlantı dizesi yuvasını belirli hale getirmek için Set-AzWebAppSlotConfigName kullanın:

Set-AzWebAppSlotConfigName -ResourceGroupName <group-name> -Name <app-name> -ConnectionStringNames <string-name1>,<string-name2>,...

Bağlantı dizelerini toplu olarak düzenleme

Azure portalı

1. Gelişmiş düzenleme'yi seçin.
2. Metin alanındaki bağlantı dizesi düzenleyin.
3. bitirdiğinizde Uygula'yı seçin. Ortam değişkenleri sayfasında Uygula'yı da seçmeyi unutmayın.

Bağlantı dizeleri aşağıdaki JSON biçimlendirmesine sahiptir:

[
  {
    "name": "name-1",
    "value": "conn-string-1",
    "type": "SQLServer",
    "slotSetting": false
  },
  {
    "name": "name-2",
    "value": "conn-string-2",
    "type": "PostgreSQL",
    "slotSetting": false
  },
  ...
]

Azure CLI

az webapp config connection-string set komutunu JSON dosyasının adıyla çalıştırın:

az webapp config connection-string set --resource-group <group-name> --name <app-name> --settings "@fileName.json"

Tavsiye

Dosya adını tırnak içine almak yalnızca PowerShell'de gereklidir.

Gerekli dosya biçimi, yuva ayarı alanının isteğe bağlı olduğu bir JSON bağlantı dizeleri dizisidir. Örneğin:

[
  {
    "name": "name-1",
    "value": "conn-string-1",
    "type": "SQLServer",
    "slotSetting": false
  },
  {
    "name": "name-2",
    "value": "conn-string-2",
    "type": "PostgreSQL",
  },
  ...
]

Kolaylık olması için az webapp config connection-string list komutunu kullanarak mevcut bağlantı dizelerini bir JSON dosyasına kaydedebilirsiniz.

# Save the connection strings
az webapp config connection-string list --resource-group <group-name> --name <app-name> > settings.json

# Edit the JSON file
...

# Update the app with the JSON file
az webapp config connection-string set --resource-group <group-name> --name <app-name> --settings @settings.json

Azure PowerShell

Azure PowerShell ile JSON dosyası kullanarak bağlantı dizesi toplu olarak düzenlemek mümkün değildir.

Dil yığını ayarlarını yapılandırma

Dil yığını ayarlarını yapılandırmak için şu kaynaklara bakın:

• ASP.NET Core
• Java
• Node.js
• Piton
• PHP

Genel ayarları yapılandırma

Genel ayarları yapılandırmak için tercih ettiğiniz araçlara yönelik adımları izleyin.

Azure portalı

1. Azure portalında Uygulama Hizmetleri'ni arayıp seçin ve ardından uygulamanızı seçin.

2. Uygulamanın sol menüsünde Ayarlar>Yapılandırması'nı seçin. Ardından Genel ayarlar'ı seçin.

   

Burada, uygulama için bazı yaygın ayarları yapılandırabilirsiniz. Bazı ayarlar için ölçeği daha yüksek fiyatlandırma katmanlarına artırmanız gerekir.

• Yığın ayarları: Uygulamayı çalıştırmak için dil ve SDK sürümleri dahil olmak üzere yazılım yığını ayarlarını yapılandırın.

  Linux uygulamaları için dil çalışma zamanı sürümünü seçebilir ve isteğe bağlı bir başlangıç komutu ayarlayabilirsiniz.

• Platform ayarları: Barındırma platformu için aşağıdakiler dahil olmak üzere ayarları yapılandırın:

  • Platform: 32 bit veya 64 bit'i seçin. Yalnızca Windows uygulamaları için.

  • FTP durumu: Yalnızca FTPS'ye izin verin veya FTP'yi tamamen devre dışı bırakın.

  • HTTP sürümü: HTTPS/2 protokolü desteğini etkinleştirmek için 2.0 olarak ayarlayın.

    Uyarı

    Modern tarayıcıların çoğu yalnızca TLS üzerinden HTTP/2 protokollerini destekler. Şifrelenmemiş trafik HTTP/1.1 kullanmaya devam eder. İstemci tarayıcılarının http/2 ile uygulamanıza bağlandığından emin olmak için özel DNS adınızın güvenliğini sağlayın. Daha fazla bilgi için bkz. App Service'te TLS/SSL bağlaması ile özel bir DNS adı için güvenlik sağlama.

  • Web yuvaları: Örneğin ASP.NET SignalR veya socket.io için yapılandırın.

  • Her Zaman Açık: Trafik olmadığında bile uygulamayı yüklü tutmak istiyorsanız açın.

    AlwaysOn kapalı olduğunda (varsayılan), uygulama 20 dakika sonra gelen istekler olmadan kaldırılır. Yüklenmemiş uygulama, ısınma süresi nedeniyle yeni istekler için yüksek gecikmeye neden olabilir.

    AlwaysOn açık olduğunda, ön uç yük dengeleyici her beş dakikada bir uygulama köküne bir GET istek gönderir. Sürekli ping, uygulamanın yüklenmesini engeller.

    "Always On", sürekli Web İşleri veya bir cron ifadesi tarafından tetiklenen Web İşleri için gereklidir.

  • Oturum benzimi: Çok örnekli bir dağıtımda, istemcinin oturumun ömrü boyunca aynı örneğe yönlendirildiğinden emin olun. Durum bilgisi olmayan uygulamalar için bu seçeneği Kapalı olarak ayarlayabilirsiniz.

  • Oturum bağımlılığı proxy'si: Uygulamanız ters proxy arkasındaysa (Azure Application Gateway veya Azure Front Door gibi) ve varsayılan ana bilgisayar adını kullanıyorsanız, açın. Oturum bağımlılığı tanımlama bilgisinin etki alanı, ters proxy'den iletilen ana bilgisayar adıyla uyumlu hale getirilir.

  • Yalnızca HTTPS: Tüm HTTP trafiğini HTTPS'ye yönlendirmek istiyorsanız etkinleştirin.

  • En düşük TLS sürümü: Uygulamanızın gerektirdiği en düşük TLS şifreleme sürümünü seçin.

• Hata ayıklama: ASP.NET, ASP.NET Core veya Node.js uygulamaları için uzaktan hata ayıklamayı etkinleştirin. Bu seçenek 48 saat sonra otomatik olarak kapatılır.

• Gelen istemci sertifikaları: Karşılıklı kimlik doğrulamasında istemci sertifikalarını zorunlu kılar.

Azure CLI

az webapp config set komutunu kullanarak sık kullanılan yapılandırılabilir seçeneklerin çoğunu ayarlayabilirsiniz. Aşağıdaki örnekte yapılandırılabilir seçeneklerin bir alt kümesi gösterilmektedir:

az webapp config set --resource-group <group-name> --name <app-name>  --use-32bit-worker-process [true|false] --web-sockets-enabled [true|false] --always-on [true|false]--http20-enabled --auto-heal-enabled [true|false] --remote-debugging-enabled [true|false] --number-of-workers

Mevcut ayarları göstermek için az webapp config show komutunu kullanın.

Azure PowerShell

Set-AzWebApp kullanarak sık kullanılan yapılandırılabilir seçeneklerin çoğunu ayarlayabilirsiniz. Aşağıdaki örnekte yapılandırılabilir seçeneklerin bir alt kümesi gösterilmektedir:

Set-AzWebApp -ResourceGroupName <group-name> -Name <app-name> -Use32BitWorkerProcess [$True|$False] -WebSocketsEnabled [$True|$False] -AlwaysOn [$True|$False] -NumberOfWorkers

Mevcut ayarları göstermek için Get-AzWebApp komutunu kullanın.

Varsayılan belgeleri yapılandırma

Varsayılan belge, App Service uygulamasının kök URL'sinde görünen web sayfasıdır. Listedeki ilk eşleşen dosya kullanılır. Uygulama statik içerik sunma yerine URL'ye göre yönlendiren modüller kullanıyorsa varsayılan belgelere gerek yoktur.

Varsayılan belgeleri yapılandırma ayarı yalnızca Windows uygulamaları içindir.

Azure portalı

1. Azure portalında Uygulama Hizmetleri'ni arayıp seçin ve ardından uygulamanızı seçin.
2. Uygulamanın sol menüsünde Yapılandırma'yı seçin. Ardından Varsayılan belgeler'i seçin.
3. Varsayılan belge eklemek için Yeni belge'yi seçin. Varsayılan belgeyi kaldırmak için sağındaki Sil'i seçin.

Azure CLI

az resource update kullanarak varsayılan bir belge ekleyin:

az resource update --resource-group <group-name> --resource-type "Microsoft.Web/sites/config" --name <app-name>/config/web --add properties.defaultDocuments <filename>

Azure PowerShell

Güncelleştirme uygulamasının PowerShell nesnesini değiştirerek varsayılan bir belge ekleyin:

$webapp = Get-AzWebApp -ResourceGroupName <group-name> -Name <app-name>
$webapp.SiteConfig.DefaultDocuments.Add("<filename>")
Set-AzWebApp $webapp

URL yolunu bir dizinle eşleştir

App Service varsayılan olarak uygulamanızı uygulama kodunuzun kök dizininden başlatır. Ancak bazı web çerçeveleri kök dizinde başlamaz. Örneğin, Laravelpublic alt dizininden başlar. Örneğin, böyle bir uygulamaya http://contoso.com/public adresinden erişilebilir, ancak genellikle http://contoso.com'i public dizinine yönlendirmek istersiniz. Uygulamanızın başlangıç dosyası farklı bir klasördeyse veya deponuzda birden fazla uygulama varsa, sanal uygulamaları ve dizinleri düzenleyebilir veya ekleyebilirsiniz.

Sanal dizini fiziksel bir yola eşleme özelliği yalnızca Windows uygulamalarında kullanılabilir.

Azure portalı

1. Azure portalında Uygulama Hizmetleri'ni arayıp seçin ve ardından uygulamanızı seçin.

2. Uygulamanın sol menüsünde Ayarlar>Yapılandırması'nı seçin. Ardından Yol eşlemeleri'ne tıklayın.

3. Yeni sanal uygulama veya dizin'i seçin. Ardından şu eylemlerden birini gerçekleştirin:

   • Bir sanal dizini fiziksel bir yola eşlemek için Dizin'i seçili bırakın. Sanal dizini ve web sitesi köküne () karşılık gelen göreli (D:\homefiziksel) yolu belirtin.
   • Bir sanal dizini web uygulaması olarak işaretlemek için Dizin'in seçimini kaldırın.

   

4. tamamseçin. Ardından Yapılandırma sayfasında Kaydet'i seçin.

Azure CLI

Aşağıdaki örnek, kök yolunu Laravel için çalışan / alt dizinine public ayarlar. Ayrıca /app2 yoluna ikinci bir sanal uygulama ekler. Çalıştırmak için aşağıdaki içeriklere sahip adlı json.txt bir dosya oluşturun:

[
  {
    "physicalPath"':' "site\\wwwroot\\public",
    "preloadEnabled"':' false,
    "virtualDirectories"':' null,
    "virtualPath"':' "/"
  },
  {
    "physicalPath"':' "site\\wwwroot\\app2",
    "preloadEnabled"':' false,
    "virtualDirectories"':' null,
    "virtualPath"':' "/app2"
  }
]

Kaynaklarınız için <group-name> ve <app-name> değiştirin ve ardından aşağıdaki komutu çalıştırın. Bu komutu çalıştırdığınızda kaçış karakterlerine dikkat edin. Kaçış karakterleri hakkında daha fazla bilgi için bkz . Azure CLI'yi başarıyla kullanma ipuçları.

az resource update --resource-group <group-name> --resource-type Microsoft.Web/sites/config --name <app-name>/config/web --set properties.virtualApplications="@json.txt"

Azure PowerShell

Aşağıdaki örnek, kök yolunu Laravel için çalışan / alt dizinine public ayarlar. Ayrıca /app2 yoluna ikinci bir sanal uygulama ekler. Çalıştırmak için <group-name> ve <app-name> öğelerini değiştirin.

$webapp=Get-AzWebApp -ResourceGroupName <group-name> -Name <app-name>

# Set default / path to public subdirectory
$webapp.SiteConfig.VirtualApplications[0].PhysicalPath= "site\wwwroot\public"

# Add a virtual application
$virtualApp = New-Object Microsoft.Azure.Management.WebSites.Models.VirtualApplication
$virtualApp.VirtualPath = "/app2"
$virtualApp.PhysicalPath = "site\wwwroot\app2"
$virtualApp.PreloadEnabled = $false
$webapp.SiteConfig.VirtualApplications.Add($virtualApp)

# Save settings
Set-AzWebApp $webapp

İşleyici eşlemelerini yapılandırma

Windows uygulamaları için IIS işleyici eşlemelerini ve sanal uygulamaları ve dizinleri özelleştirebilirsiniz. İşleyici eşlemeleri, belirli dosya uzantılarına yönelik istekleri işlemek için özel betik işlemcileri eklemenize olanak sağlar.

Özel işleyici eklemek için:

1. Azure portalında Uygulama Hizmetleri'ni arayıp seçin ve ardından uygulamanızı seçin.

2. Uygulamanın sol menüsünde Ayarlar>Yapılandırması'nı seçin. Ardından Yol eşlemeleri'ne tıklayın.

3. Yeni işleyici eşlemesi'ni seçin. İşleyiciyi aşağıdaki gibi yapılandırın:

   • Uzantı. İşlemek istediğiniz dosya uzantısı, *.php veya handler.fcgi gibi.
   • Betik işlemcisi. Size yönelik betik işlemcisinin mutlak yolu. Betik işlemcisi, dosya uzantısıyla eşleşen dosyalara yönelik istekleri işler. Uygulamanızın kök dizinine başvurmak için yolu D:\home\site\wwwroot kullanın.
   • Argümanlar. Betik işlemcisi için isteğe bağlı komut satırı bağımsız değişkenleri.

4. tamamseçin. Ardından Yapılandırma sayfasında Kaydet'i seçin.

Özel kapsayıcıları yapılandırma

• Azure App Service için özel kapsayıcıyı yapılandırma
• Azure Depolama'yı App Service'te yerel paylaşım olarak bağlama

İlgili içerik

• Azure App Service'teki ortam değişkenleri ve uygulama ayarları
• Azure App Service'te var olan bir özel etki alanını ayarlama
• Azure App Service’ta hazırlık ortamları ayarlama
• Azure App Service'te özel bir etki alanı için HTTPS'yi etkinleştirme
• Azure App Service’te uygulamalar için tanılama günlüğünü etkinleştirme
• Azure Uygulaması Hizmeti'nde bir uygulamanın ölçeğini artırma
• Azure App Service kotaları ve uyarıları
• applicationHost.xdt ile applicationHost.config ayarlarını değiştirme