Uygulama App Service uygulama Azure portal

Bu makalede, web uygulamaları, mobil arka uç veya API uygulaması için genel ayarları yapılandırma hakkında [Azure portal.]

Uygulama ayarlarını yapılandırma

Uygulama App Service, uygulama koduna ortam değişkenleri olarak geçirilen değişkenlerdir. Linux uygulamaları ve özel kapsayıcılar App Service kapsayıcıda ortam değişkenlerini ayarlamak için bayrağını kullanarak uygulama --env ayarlarını kapsayıcıya iletir. Her iki durumda da, uygulama başlatma sırasında uygulama ortamınıza ekli olur. Uygulama ayarlarını ekler, kaldırır veya düzenlerken, App Service yeniden başlatmayı tetikler. Uygulama ayarı adları nokta ( ) . içerenin. Bir uygulama ayarı nokta içeriyorsa, nokta kapsayıcıda bir alt çizgi ile değiştirilir.

Uygulama [Azure portal]App Services için arama ve seçin ve ardından uygulamanızı seçin.

Uygulamanın sol menüsünde Yapılandırma Uygulaması ayarları'ı > seçin.

ASP.NET ve ASP.NET Core geliştiricileri için, App Service'de uygulama ayarlarınıWeb.configveya <appSettings> appsettings.json içinde ayarlamaya benzer, ancak App Service'daki değerlerWeb.configveya appsettings.json'daki değerleri geçersiz kılar. Geliştirme ayarlarını (örneğin, yerel MySQL parolası) Web.config veya appsettings.json ve üretim gizli dizilerinde (örneğin, Azure MySQL veritabanı parolası) güvenli bir şekilde App Service. Aynı kod, yerel olarak hata ayıklarken geliştirme ayarlarınızı ve Azure'a dağıtıldığında üretim gizli dizilerinizi kullanır.

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

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

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

Gizli değerleri gösterme

Varsayılan olarak, uygulama ayarlarının değerleri güvenlik için portalda gizlenir. Uygulama ayarının gizli bir değerini görmek için bu ayarın Değer alanına tıklayın. Tüm uygulama ayarlarının değerlerini görmek için Değeri göster düğmesine tıklayın.

Ekleme veya düzenleme

Yeni bir uygulama ayarı eklemek için Yeni uygulama ayarı'ya tıklayın. İletişim kutusunda, ayarı geçerli yuvaya abilirsiniz.

Bir ayarı düzenlemek için sağ tarafta Düzenle düğmesine tıklayın.

Tamamlandığında Güncelleştir'e tıklayın. Yapılandırma sayfasında Kaydet'e tıklamayı unutmayın.

Toplu düzenleme

Uygulama ayarlarını toplu olarak eklemek veya düzenlemek için Gelişmiş düzenleme düğmesine tıklayın. Tamamlandığında Güncelleştir'e tıklayın. Yapılandırma sayfasında Kaydet'e tıklamayı unutmayın.

Uygulama ayarları aşağıdaki JSON biçimlendirmesini içerir:

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

Azure CLI ile uygulama ayarlarını otomatikleştirme

Komut satırı ayarlarını oluşturmak ve yönetmek için Azure CLI'sini kullanabilirsiniz.

• az webapp config app settings set ile bir ayara değer attayabilirsiniz:

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

  değerini <setting-name> ayarın adıyla, değerini <value> ise buna atanan değerle değiştirin. Bu komut, henüz yoksa ayarı oluşturur.

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

  az webapp config appsettings list --name <app-name> --resource-group <resource-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 <resource-group-name> --setting-names {<names>}
  

  yerine, <names> ayar adlarının boşlukla ayrılmış listesini ekleyin.

Bağlantı dizelerini yapılandırma

Uygulama [Azure portal]App Services için arama ve seçin ve ardından uygulamanızı seçin. Uygulamanın sol menüsünde Yapılandırma Uygulaması ayarları'ı > seçin.

ASP.NET ve ASP.NET Core geliştiricileri için bağlantı dizelerini App Service'de ayarlamakWeb.config'de ayarlamakla benzerdir, ancak App Service'de ayar <connectionStrings>Web.config. ** ** Geliştirme ayarlarını (örneğin, veritabanı dosyası)Web.config gizli dizilerde (örneğin, SQL Veritabanı kimlik bilgileri) güvenli bir şekilde App Service. Aynı kod, yerel olarak hata ayıklarken geliştirme ayarlarınızı ve Azure'a dağıtıldığında üretim gizli dizilerinizi kullanır.

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

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

• Sqlserver: SQLCONNSTR_
• Mysql: MYSQLCONNSTR_
• SQLAzure: SQLAZURECONNSTR_
• Özel: CUSTOMCONNSTR_
• Postgresql: POSTGRESQLCONNSTR_

Örneğin connectionstring1 adlı bir MySql bağlantı dizesine ortam değişkeni olarak MYSQLCONNSTR_connectionString1 erişilebilir. Dil yığınına özgü adımlar için bkz:

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

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

Gizli değerleri gösterme

Bağlantı dizelerinin değerleri varsayılan olarak güvenlik için portalda gizlenir. Bağlantı dizesinin gizli bir değerini görmek için bu dizenin Değer alanına tıklamanız gerekir. Tüm bağlantı dizelerinin değerlerini görmek için Değeri göster düğmesine tıklayın.

Ekleme veya düzenleme

Yeni bir bağlantı dizesi eklemek için Yeni bağlantı dizesi'ne tıklayın. İletişim kutusunda, bağlantı dizesini geçerli yuvaya abilirsiniz.

Bir ayarı düzenlemek için sağ tarafta Düzenle düğmesine tıklayın.

Tamamlandığında Güncelleştir'e tıklayın. Yapılandırma sayfasında Kaydet'e tıklamayı unutmayın.

Toplu düzenleme

Bağlantı dizelerini toplu olarak eklemek veya düzenlemek için Gelişmiş düzenleme düğmesine tıklayın. Tamamlandığında Güncelleştir'e tıklayın. Yapılandırma sayfasında Kaydet'e tıklamayı unutmayın.

Bağlantı dizeleri aşağıdaki JSON biçimlendirmesini içerir:

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

Genel ayarları yapılandırma

Uygulama [Azure portal]App Services için arama ve seçin ve ardından uygulamanızı seçin. Uygulamanın sol menüsünde Yapılandırma Genel ayarları'na > tıklayın.

Burada, uygulama için bazı genel ayarları yapılandırabilirsiniz. Bazı ayarlar, ölçeğini daha yüksek fiyatlandırma katmanlarına ölçeklendirmeniz gerektirir.

• 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ı ve özel kapsayıcı uygulamaları için dil çalışma zamanı sürümünü seçin ve isteğe bağlı bir Başlangıç komutu veya başlangıç komut dosyası ayarlayın.

  

• Platform ayarları: Barındırma platformu için aşağıdakiler dahil olmak üzere ayarları yapılandırmaya olanak sağlar:

  • Bitlik: 32 bit veya 64 bit. (Portalda oluşturulan varsayılan değer App Service 32 bittir.)

  • WebSocket protokolü: ASP.NET SignalR veya socket.io, örneğin.

  • Always On: Trafik olduğunda bile uygulamayı yüklü tutar. Always On açık değilken (varsayılan), uygulama 20 dakika sonra gelen istek olmadan kaldırılmış olur. Yüklenmeden kaldırılan uygulama, yeni istekler için hazır olduğu süre nedeniyle yüksek gecikme süresine neden olabilir. Her Zaman Açık olduğunda, ön uç yük dengeleyici uygulama köküne beş dakikada bir bir GET isteği gönderir. Sürekli ping, uygulamanın yüklenmesini önler.

    Sürekli WebJob'lar veya CRON ifadesi kullanılarak tetiklenen WebJob'lar için Always On gereklidir.

  • Yönetilen işlem hattı sürümü: IIS [işlem hattı modu.] IIS'nin eski bir sürümünü gerektiren eski bir uygulamanız varsa Klasik olarak ayarlayı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 protokolünü desteklerken, şifrelenmeyen trafik HTTP/1.1 kullanmaya devam eder. İstemci tarayıcılarının HTTP/2 ile uygulamanıza bağlana olduğundan emin olmak için özel DNS adınıza güvenin. Daha fazla bilgi için bkz. Azure App Service'de TLS/SSL bağlamasıile özel BIR DNS Azure App Service.

  • ARR benzeşmi: Çok örnekli bir dağıtımda, istemcinin oturum ömrü boyunca aynı örneğine yönlendirildiklerinden emin olun. Durum olmayan uygulamalar için bu seçeneği Kapalı olarak ayarlayın.

• Hata Ayıklama: ASP.NET, ASP.NET Coreveya Node.jsiçin uzaktan hata ayıklamayı etkinleştirin. Bu seçenek 48 saat sonra otomatik olarak kapanır.

• Gelen istemci sertifikaları: karşılıklı kimlik doğrulamasında istemci sertifikaları gerektirir.

Varsayılan belgeleri yapılandırma

Bu ayar yalnızca Windows için.

uygulama [Azure portal]App Services için arama ve seçin ve ardından uygulamanızı seçin. Uygulamanın sol menüsünde Yapılandırma Varsayılan > belgeleri'ne tıklayın.

Varsayılan belge, bir web sitesinin kök URL'sinde görüntülenen web sayfasıdır. Listede ilk eşleşen dosya kullanılır. Yeni bir varsayılan belge eklemek için Yeni belge'ye tıklayın. Kaydet'e tıklamayı unutmayın.

Uygulama statik içerik yerine URL'ye göre yönlendiren modüller kullanıyorsa, varsayılan belgelere gerek yoktur.

Yol eşlemelerini yapılandırma

uygulama [Azure portal]App Services için arama ve seçin ve ardından uygulamanızı seçin. Uygulamanın sol menüsünde Yapılandırma Yolu eşlemeleri'ne > tıklayın.

Windows uygulamaları (uncontainerized)

Daha Windows için IIS işleyici eşlemelerini ve sanal uygulamaları ve dizinlerini ö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 bir işleyici eklemek için Yeni işleyici eşlemesi'ne tıklayın. İşleyiciyi aşağıdaki gibi yapılandırma:

• Uzantısı. işlemek istediğiniz dosya uzantısı, örneğin * .php veya handler.fcgi.
• Betik işlemcisi. Betik işlemcisinin size mutlak yolu. Dosya uzantısıyla eşlenen dosyalara yapılan istekler betik işlemcisi tarafından işlenir. Yolu kullanarak D:\home\site\wwwroot uygulamanın kök dizinine bakı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.

Her uygulama, kodunuzun varsayılan / olarak dağıtılacağı ile eşlenmiş varsayılan kök yola ( ) D:\home\site\wwwroot sahip olur. Uygulama kök dizininde farklı bir klasör varsa veya depoda birden fazla uygulama varsa, burada sanal uygulamaları ve dizinleri düzenleyebilir veya ekleyin.

Yol eşlemeleri sekmesinde Yeni sanal uygulama veya dizin'e tıklayın.

• Bir sanal dizini fiziksel 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 (fiziksel) yolu belirtin ( D:\home ).

• Bir sanal dizini web uygulaması olarak işaretlemek için Dizin onay kutusunun işaretini kaldırın.

  

Kapsayıcılı uygulamalar

Kapsayıcılı uygulamanız için özel depolama alanı ekebilirsiniz. Kapsayıcılı uygulamalar, tüm Linux uygulamalarının yanı sıra Windows ve Linux özel kapsayıcılarını App Service. Yeni Azure depolama Depolama'a tıklayın ve özel depolamanızı aşağıdaki gibi yapılandırın:

• Ad: Görünen ad.
• Yapılandırma seçenekleri: Temel veya Gelişmiş.
• Depolama hesapları: Depolama hesabı ve istediğiniz kapsayıcı.
• Depolama yazın: Azure Blobları veya Azure Dosyalar.

  Not

  Windows uygulamaları yalnızca uygulama Azure Dosyalar.

• Depolama kapsayıcı: Temel yapılandırma için istediğiniz kapsayıcı.
• Paylaşım adı: Gelişmiş yapılandırma için dosya paylaşımı adı.
• Erişim anahtarı: Gelişmiş yapılandırma için erişim anahtarı.
• Bağlama yolu: Kapsayıcınıza özel depolama birimini bağlamanız için mutlak yol.

Daha fazla bilgi için bkz. Azure Depolama'de bir kapsayıcıdan ağ paylaşımı olarak App Service.

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

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

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

Bkz. Özel Linux kapsayıcısı yapılandırma Azure App Service

Sonraki adımlar

• Ortam değişkenleri ve uygulama ayarları başvurusu
• Azure App Service'de özel etki alanı adı yapılandırma
• Azure App Service’ta hazırlık ortamları ayarlama
• TlS/SSL bağlaması ile özel bir DNS adının güvenliğini Azure App Service
• Tanılama günlüklerini etkinleştirme
• [Uygulamanın ölçeğini Azure App Service]
• Azure App Service'da izlemenin temelleri
• applicationHost.xdt ile applicationHost.config ayarlarını değiştirme