App Service uygulamasını yapılandırma

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>Uygulaması 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 Yeni uygulama ayarı'na tıklayın. Bir ayarı düzenlemek için sağ taraftaki Düzenle düğmesini seçin.

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 Güncelleştir'i seçin. Yapılandırma sayfasında Geri kaydet'i seçmeyi unutmayın.

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>,...}

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>,...

Gelişmiş düzenleme düğmesini seçin. Metin alanındaki ayarları düzenleyin. bitirdiğinizde Güncelleştir'i seçin. Yapılandırma sayfasında Geri kaydet'i 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
  },
  ...
]

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"

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 ile JSON dosyası kullanarak uygulama ayarlarını toplu olarak düzenlemek mümkün değildir.

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>Uygulaması ayarları'nı 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 Yeni bağlantı dizesi'ı seçin. Bağlantı dizesi düzenlemek için sağ taraftaki Düzenle düğmesini seçin.

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

5. bitirdiğinizde Güncelleştir'i seçin. Yapılandırma sayfasında Geri kaydet'i seçmeyi unutmayın.

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>,...}

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 Bağlan ionStringType 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>,...

Gelişmiş düzenleme düğmesini seçin. Metin alanındaki bağlantı dizesi düzenleyin. bitirdiğinizde Güncelleştir'i seçin. Yapılandırma sayfasında Geri kaydet'i seçmeyi unutmayın.

Bağlan ion 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
  },
  ...
]

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"

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 ile JSON dosyası kullanarak bağlantı dizesi toplu olarak düzenlemek mümkün değildir.

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. 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.

  • ARR 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.

  • 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.

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.

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.

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.

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>

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

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.

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 kullanmak için İpuçları.

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

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