App Service uygulamasını yapılandırma

Not

1 Haziran 2024'den itibaren, yeni oluşturulan tüm App Service uygulamaları adlandırma kuralını <app-name>-<random-hash>.<region>.azurewebsites.netkullanarak benzersiz bir varsayılan ana bilgisayar adı oluşturma seçeneğine sahip olacaktır. Mevcut uygulama adları değişmeden kalır.

Örnek: myapp-ds27dh7271aah175.westus-01.azurewebsites.net

Diğer ayrıntılar için App Service Kaynağı için Benzersiz Varsayılan Ana Bilgisayar Adı'na bakın.

Bu makalede web uygulamaları, mobil arka uç veya API uygulaması için genel ayarların nasıl yapılandırılır açıklanmaktadır. Azure İşlevleri için bkz. Azure İşlevleri için uygulama ayarları başvurusu.

Uygulama ayarlarını yapılandırma

Not

• Uygulama ayarları adları yalnızca harf, sayı (0-9), nokta (".") ve alt çizgi ("_") içerebilir
• Uygulama Ayarı değerindeki özel karakterlerin hedef işletim sistemi tarafından gerektiği gibi kaçılması gerekir

Örneğin App Service Linux'ta uygulama ayarının dizesinin değeriyle "pa$$w0rd\" bir ortam değişkeni ayarlamak için: "pa\$\$w0rd\\"

App Service'te uygulama ayarları, uygulama koduna ortam değişkeni olarak geçirilen değişkenlerdir. 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ın ayarlanması, bunları <appSettings> Web.config veya appsettings.json içinde ayarlamaya benzer, ancak App Service'teki değerler Web.config veya appsettings.json'daki değerleri geçersiz kılar. Geliştirme ayarlarını (örneğin, yerel MySQL parolası) Web.config'de veya appsettings.json ve üretim gizli dizilerinde (örneğin, Azure MySQL veritabanı parolası) App Service'te güvenli bir şekilde tutabilirsiniz. Aynı kod, yerel olarak hata ayıklarken geliştirme ayarlarınızı kullanır ve Azure'a dağıtıldığında üretim gizli dizilerinizi kullanır.

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

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

Uygulama ayarları depolandığında her zaman şifrelenir (bekleyenler şifrelenir).

Not

Gizli dizileri uygulama ayarlarında depolarsanız Key Vault başvurularını kullanmayı göz önünde bulundurun. Gizli dizileriniz arka uç kaynaklarına bağlantı amaçlıysa, gizli dizi gerektirmeyen daha güvenli 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ı.

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 Ortam değişkenleri>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 alanını seçin. Tüm uygulama ayarlarının gizli değerlerini görmek için Değerleri göster düğmesini seçin.

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

4. İletişim kutusunda, ayarı geçerli yuvaya yapıştırabilirsiniz.

   Not

   Varsayılan Linux uygulama hizmetinde veya özel bir Linux kapsayıcısında, uygulama ayarı adında olduğu gibi ApplicationInsights:InstrumentationKey iç içe JSON anahtar yapısının App Service'te anahtar adı olarak ApplicationInsights__InstrumentationKey yapılandırılması gerekir. Başka bir deyişle, herhangi biri : ile __ değiştirilmelidir (çift alt çizgi). Uygulama ayarı adındaki tüm dönemler bir (tek alt _ çizgi) ile değiştirilir.

5. bitirdiğinizde Uygula'yı seçin. Ortam değişkenleri sayfasında Geri uygula'yı seçmeyi unutmayın.

Azure CLI

Az webapp config uygulama ayarları ayarlanmış bir uygulama ayarı ekleyin veya düzenleyin:

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

değerini ayarın adıyla ve <value> atanacak değerle değiştirin<setting-name>.

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

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

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

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

Azure PowerShell

Set-AzWebApp ile 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ümede uygulama ayarı eklemek veya düzenlemek için Get-AzWebApp cmdlet'ini kullanarak giriş Hashtable'ınıza 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 Hashtable
$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 özgü olup olmadığını denetlemek için Get-AzWebAppSlotConfigName komutunu kullanın:

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

Bir veya daha fazla uygulama ayarlarını yuvaya özgü hale getirmek için Set-AzWebAppSlotConfigName komutunu kullanın:

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

Uygulama ayarlarını toplu olarak düzenleme

Azure portalı

Gelişmiş düzenleme düğmesini seçin. Metin alanındaki ayarları düzenleyin. İşiniz bittiğinde Tamam'ı seçin. Ortam değişkenleri sayfasında Geri uygula'yı seçmeyi unutmayın.

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

Az webapp config app settings set with the name of the JSON file komutunu çalıştırın.

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

İpucu

Dosya adını tırnak işaretleri ile kaydırmak yalnızca PowerShell'de gereklidir.

Gereken 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 ile mevcut ayarları bir JSON dosyasına kaydedebilirsiniz. Aşağıdaki örnek Bash'te çalıştırılabilir.

# Save the settings
az webapp config appsettings list --name <app-name> --resource-group <group-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

Not

Bağlantı gizli dizileri gerektirmeyen daha güvenli 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ı dizesi ayarlamak, bunları Web.config'de <connectionStrings>ayarlamaya benzer, ancak App Service'te ayarladığınız değerler Web.config'deki değerleri geçersiz kılar. Geliştirme ayarlarını (örneğin, veritabanı dosyası) Web.config'de ve üretim gizli dizilerinde (örneğin, SQL Veritabanı kimlik bilgileri) App Service'te güvenli bir şekilde tutabilirsiniz. Aynı kod, yerel olarak hata ayıklarken geliştirme ayarlarınızı kullanır ve Azure'a dağıtıldığında üretim gizli dizilerinizi kullanır.

Bağlantı dizesi değerlerine erişmek için değişken anahtarlarında özel biçimlendirme gerektirdiğinden, diğer dil yığınları için bunun yerine uygulama ayarlarını kullanmak daha iyidir.

Not

non-.NET diller için uygulama ayarları yerine bağlantı dizesi kullanmak isteyebileceğiniz bir durum vardır: Belirli Azure veritabanı türleri yalnızca App Service uygulamanızdaki veritabanı için bir bağlantı dizesi yapılandırdığınızda uygulamayla birlikte 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ı dizesi ortam değişkenleri olarak kullanılabilir ve ön ek olarak aşağıdaki bağlantı türleri bulunur:

• SQLServer: SQLCONNSTR_
• MySQL: MYSQLCONNSTR_
• SQLAzure: SQLAZURECONNSTR_
• Töre: CUSTOMCONNSTR_
• PostgreSQL: POSTGRESQLCONNSTR_
• Bildirim Hub'ı: NOTIFICATIONHUBCONNSTR_
• Service Bus: SERVICEBUSCONNSTR_
• Olay Hub'ı: EVENTHUBCONNSTR_
• Belge VERITABANı: DOCDBCONNSTR_
• Redis Cache: REDISCACHECONNSTR_

Not

PostgreSQL, Notification Hub, Service Bus, Event Hub, Document Db ve Redis Cache'i hedefleyen .NET uygulamaları.NET EnvironmentVariablesConfigurationProvider'daki bilinen bir sorun için geçici çözüm olarak bağlantı dizesi Özel olarak ayarlamalıdır

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

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

Bağlantı dizeleri depolandığında her zaman şifrelenir (bekleyenler şifrelenir).

Not

Bağlantı dizeleri, Key Vault başvuruları kullanılarak Key Vault'tan da çözümlenebilir.

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 Ortam değişkenleri Bağlantı dizeleri'ni> seçin.

   

   Varsayılan olarak, bağlantı dizesi değerleri güvenlik için portalda gizlenir. bir bağlantı dizesi gizli değerini görmek için Değer alanını seçin. Tüm bağlantı dizesi gizli değerlerini görmek için Değeri göster düğmesini 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ı dizesi geçerli yuvaya yapıştırabilirsiniz.

5. bitirdiğinizde Uygula'yı seçin. Ortam değişkenleri sayfasında Geri uygula'yı seçmeyi unutmayın.

Azure CLI

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

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

değerini bağlantı dizesi adıyla ve <value> atanacak değerle değiştirin<string-name>. Olası değerleri <type> (örneğin, SQLAzure) için CLI komut belgelerine bakın.

az webapp config connection-string list ile tüm bağlantı dizesi ve değerlerini göster:

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

az webapp config connection-string delete ile bir veya daha fazla bağlantı dizesi kaldırın:

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

Azure PowerShell

Set-AzWebApp ile 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 connectionStringType sabit listesi alanlarından birine karşılık gelen sayısal bir değer olan türü içerir. Örneğin, SQL Azure için öğesini belirtin type="2".

Bu cmdlet, tüm bağlantı dizesi kümesini belirttiğinizlerle değiştirir. Mevcut bir kümede 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 hashtable
$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ı dizesi 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 yuvaya özgü hale getirmek için Set-AzWebAppSlotConfigName kullanın:

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

bağlantı dizesi toplu düzenleme

Azure portalı

Gelişmiş düzenleme düğmesini seçin. Metin alanındaki bağlantı dizesi düzenleyin. bitirdiğinizde Uygula'yı seçin. Ortam değişkenleri sayfasında Geri uygula'yı 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"

İpucu

Dosya adını tırnak işaretleri ile kaydırmak yalnızca PowerShell'de gereklidir.

Gereken dosya biçimi, yuva ayarı alanının isteğe bağlı olduğu bağlantı dizesi bir JSON 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 sağlamak için mevcut bağlantı dizesi az webapp config connection-string list ile bir JSON dosyasına kaydedebilirsiniz. Aşağıdaki örnek Bash'te çalıştırılabilir.

# 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

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

Genel ayarları yapılandırma

Azure portalı

Azure portalında Uygulama Hizmetleri'ni arayıp seçin ve ardından uygulamanızı seçin. Uygulamanın sol menüsünde Yapılandırma>Genel ayarları'nı 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 de dahil olmak üzere yazılım yığını.

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

  

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

  • Platform bitliği: 32 bit veya 64 bit. 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.

  Not

  Çoğu modern tarayıcı yalnızca TLS üzerinden HTTP/2 protokollerini desteklerken, ş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. Azure Uygulaması Hizmeti'nde TLS/SSL bağlaması ile özel bir DNS adının güvenliğini sağlama.

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

  • Always On: Trafik olmadığında bile uygulamanın yüklü kalmasını sağlar. AlwaysOn açık olmadığında (varsayılan), uygulama 20 dakika sonra gelen istekler olmadan kaldırılır. Kaldırılan uygulama, ısınma süresi nedeniyle yeni istekler için yüksek gecikme süresine neden olabilir. AlwaysOn açık olduğunda, ön uç yük dengeleyici her beş dakikada bir uygulama köküne bir GET isteği gönderir. Yeniden görüntüleme işlemlerinin doğru yapıldığından emin olmak için bu isteğin 200 Tamam yanıtı aldığından emin olmak önemlidir. Sürekli ping, uygulamanın kaldırılmasını engeller.

    Sürekli Web İşleri için veya CRON ifadesi kullanılarak tetiklenen Web İşleri için Always On 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 benzimliği ara sunucusu: Uygulamanız ters ara sunucu arkasındaysa (Azure Uygulaması lication Gateway veya Azure Front Door gibi) ve varsayılan ana bilgisayar adını kullanıyorsanız oturum benzimliği proxy'si açılabilir. Oturum benzimliği tanımlama bilgisinin etki alanı, ters proxy'den iletilen ana bilgisayar adıyla hizalanır.

  • Yalnızca HTTPS: Etkinleştirildiğinde tüm HTTP trafiği HTTPS'ye yönlendirilir.

  • En düşük TLS sürümü: Uygulamanız için gereken 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ı gerektirir.

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

Bu ayar yalnızca Windows uygulamaları içindir.

Varsayılan belge, App Service uygulamasının kök URL'sinde görüntülenen 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.

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>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 dizine eşleme

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 adresinden http://contoso.com/publicerişilebilir, ancak genellikle bunun yerine dizine yönlendirmek http://contoso.com public 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.

Önemli

Fiziksel yol özelliğine sanal dizin 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 Yapılandırma>Yolu eşlemeleri'ni seçin

3. Yeni sanal uygulama veya dizin'i seçin.

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

   

4. Tamam'ı seçin. Yapılandırma sayfasında Kaydet'i seçmeyi unutmayın.

Azure CLI

Aşağıdaki örnek, alt dizinin kök yolunu / public ayarlar (Laravel için çalışır) ve ayrıca yola ikinci bir sanal uygulama /app2 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"
  }
]

<app-name> ve kaynaklarınız için öğesini değiştirin <group-name> ve aşağıdaki komutu çalıştırın. Bu komutu çalıştırırken 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, alt dizinin kök yolunu / public ayarlar (Laravel için çalışır) ve ayrıca yola ikinci bir sanal uygulama /app2 ekler. Çalıştırmak için ve <app-name>öğesini değiştirin<group-name>.

$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 Yapılandırma>Yolu eşlemeleri'ni seçin.

   

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

   • Uzantı. *.php veya handler.fcgi gibi işlemek istediğiniz dosya uzantısı.
   • Betik işlemcisi. Betik işlemcisinin size mutlak yolu. Dosya uzantısıyla eşleşen dosyalara yönelik istekler betik işlemcisi tarafından işlenir. Uygulamanızın kök dizinine başvurmak için yolu D:\home\site\wwwroot kullanın.
   • Bağımsız değişkenler. Betik işlemcisi için isteğe bağlı komut satırı bağımsız değişkenleri.

4. Tamam'ı seçin. Yapılandırma sayfasında Kaydet'i seçmeyi unutmayın.

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

• Azure App Service için özel kapsayıcıyı yapılandırma
• Kapsayıcılı uygulamanız için özel depolama alanı ekleme

Sonraki adımlar

• Ortam değişkenleri ve uygulama ayarları başvurusu
• Azure App Service'te özel etki alanı adını yapılandırma
• Azure App Service’ta hazırlık ortamları ayarlama
• Azure Uygulaması Hizmeti'nde TLS/SSL bağlaması ile özel bir DNS adının güvenliğini sağlama
• Tanılama günlüklerini etkinleştirme
• Azure Uygulaması Hizmeti'nde bir uygulamayı ölçeklendirme
• Azure Uygulaması Hizmeti'nde temel izleme
• applicationHost.xdt ile applicationHost.config ayarlarını değiştirme