Aracılığıyla paylaş

Azure Uygulaması Hizmeti'nde ortam değişkenleri ve uygulama ayarları

Azure Uygulaması Hizmeti'nde, dağıtım veya çalışma zamanı ortamında ortam değişkenleri olarak bazı ayarlar kullanılabilir. Bu ayarların bazılarını uygulama ayarları olarak el ile ayarlarken özelleştirebilirsiniz. Bu başvuru, kullanabileceğiniz veya özelleştirebileceğiniz değişkenleri gösterir.

Uygulama ortamı

Aşağıdaki ortam değişkenleri genel olarak uygulama ortamıyla ilgilidir.

Ayar adı Açıklama
WEBSITE_SITE_NAME Yalnızca okunabilir Uygulama adı.
WEBSITE_RESOURCE_GROUP Yalnızca okunabilir Uygulama kaynağını içeren Azure kaynak grubu adı.
WEBSITE_OWNER_NAME Yalnızca okunabilir Uygulamanın, kaynak grubunun ve web alanının sahibi olan Azure abonelik kimliğini içerir.
REGION_NAME Yalnızca okunabilir Uygulamanın bölge adı.
WEBSITE_PLATFORM_VERSION Yalnızca okunabilir App Service platform sürümü.
HOME Yalnızca okunabilir Ana dizinin yolu (örneğin, Windows için D:\home).
SERVER_PORT Yalnızca okunabilir Uygulamanın dinlemesi gereken bağlantı noktası.
WEBSITE_WARMUP_PATH Eğik çizgiyle başlayarak uygulamayı ısıtmak için ping işleminin göreli yolu. Varsayılan değer: /robots933456.txt.

Platform bir kapsayıcı başlattığında, düzenleyici bu uç noktaya yönelik yinelenen istekler yapar. Platform, kapsayıcının hazır olduğunu belirten bir gösterge olarak bu uç noktadan gelen tüm yanıtları dikkate alır. Platform kapsayıcıyı hazır olarak kabul ettiğinde organik trafiği yeni başlatılan kapsayıcıya iletmeye başlar. Yapılandırılmadığı sürece WEBSITE_WARMUP_STATUSES platform bu uç noktada kapsayıcıdan gelen herhangi bir yanıtı (404 veya 502 gibi hata kodları bile) kapsayıcının hazır olduğunu gösteren bir gösterge olarak değerlendirir.

Bu uygulama ayarı Always On'un kullandığı yolu değiştirmez.
WEBSITE_WARMUP_STATUSES Platform yeni başlatılan bir kapsayıcıda ısınma ping'leri yaptığında başarılı olarak kabul edilen HTTP durum kodlarının virgülle ayrılmış listesi. WEBSITE_WARMUP_PATH ile kullanılır.

Varsayılan olarak, herhangi bir durum kodu kapsayıcının organik trafiğe hazır olduğunu gösteren bir gösterge olarak kabul edilir. Organik trafik kapsayıcıya yönlendirilmeden önce belirli bir yanıt istemek için bu uygulamayı kullanabilirsiniz.

200,202 bunun bir örneğidir. Uygulamanın yapılandırılmış ısınma yolunda pingler 200 veya 202 durum koduyla bir yanıt alırsa, organik trafik kapsayıcıya yönlendirilir. Listede olmayan bir durum kodu alınırsa (örneğin 502), platform 200 veya 202 alınana kadar veya kapsayıcı başlatma zaman aşımı sınırına ulaşılana kadar ping işlemi yapmaya devam eder. (Bu tablonun ilerleyen kısımlarında bakın WEBSITES_CONTAINER_START_TIME_LIMIT .)

Kapsayıcı listede yer alan bir HTTP durum koduyla yanıt vermezse, platform sonunda başlatma girişiminde başarısız olur ve yeniden denenir ve bu da 503 hatasına neden olur.
WEBSITE_COMPUTE_MODE Yalnızca okunabilir Uygulamanın ayrılmış () veya paylaşılan (Dedicated) sanal makinelerde (SharedVM) çalıştırılıp çalıştırılmayacağını belirtir.
WEBSITE_SKU Yalnızca okunabilir Uygulamanın fiyatlandırma katmanı. Olası değerler , , FreeSharedve BasicdeğerleridirStandard.
SITE_BITNESS Yalnızca okunabilir Uygulamanın 32 bit (x86) veya 64 bit (AMD64) olup olmadığını gösterir.
WEBSITE_HOSTNAME Yalnızca okunabilir Uygulamanın birincil sunucu adı. Bu ayar özel konak adlarını hesaba vermez.
WEBSITE_VOLUME_TYPE Yalnızca okunabilir Şu anda kullanımda olan depolama birimi türünü gösterir.
WEBSITE_NPM_DEFAULT_VERSION Uygulamanın kullandığı varsayılan npm sürümü.
WEBSOCKET_CONCURRENT_REQUEST_LIMIT Yalnızca okunabilir Eşzamanlı WebSocket istekleri için sınır. Standard Katmanı ve üzeri için değer -1'dir, ancak VM boyutunuza göre her VM için bir sınır vardır. Bkz Sanal Makine Arası Sayısal Sınırlar.
WEBSITE_PRIVATE_EXTENSIONS 0 Özel site uzantılarının kullanımını devre dışı bırakmak için olarak ayarlayın.
WEBSITE_TIME_ZONE Varsayılan olarak, uygulamanın saat dilimi her zaman UTC'dir. Varsayılan saat dilimlerinde listelenen geçerli değerlerden herhangi birine değiştirebilirsiniz. Belirtilen değer tanınmıyorsa uygulama UTC kullanır.

Örnek: Atlantic Standard Time
WEBSITE_ADD_SITENAME_BINDINGS_IN_APPHOST_CONFIG Slot değiştirme işleminden sonra uygulama beklenmeyen yeniden başlatmalarla karşılaşabilir. Bunun nedeni, değiştirme işleminden sonra ana bilgisayar adı bağlama yapılandırmasının eşitlenmemiş olmasıdır ve bu da yeniden başlatmalara neden olmaz. Ancak, bazı temel alınan depolama olayları (depolama birimi yük devretmeleri gibi) bu tutarsızlıkları algılayabilir ve tüm çalışan işlemlerini yeniden başlatmaya zorlayabilir.

Bu tür yeniden başlatmaları en aza indirmek için tüm yuvalarda uygulama ayarı değerini olarak 1 ayarlayın. (Varsayılan değer. 0) Ancak bir Windows Communication Foundation uygulaması çalıştırıyorsanız bu değeri ayarlamayın. Daha fazla bilgi için bkz Değiştirme sorunlarını giderme.
WEBSITE_PROACTIVE_AUTOHEAL_ENABLED Varsayılan olarak, bir VM örneği 30 saniyeden fazla ayrılmış bellek% 90'dan fazla kullandığında veya son iki dakikadaki toplam isteklerin 80% 200 saniyeden uzun sürdüğünde proaktif olarak düzeltilir. Bir VM örneği bu kurallardan birini tetiklerse, kurtarma işlemi örneğin eşzamanlı bir şekilde yeniden başlatılmasıdır.

Bu kurtarma davranışını devre dışı bırakmak için false olarak ayarlayın. Varsayılan değer: true.

Daha fazla bilgi için Proaktif Otomatik İyileştirmeye Giriş blog gönderisine bakın.
WEBSITE_PROACTIVE_CRASHMONITORING_ENABLED Uygulamanızın sanal makine örneğindeki w3wp.exe işlemi 24 saatte üçten fazla işlenmeyen özel durum nedeniyle kilitlendiğinde, söz konusu örnekteki ana çalışan işlemine bir hata ayıklayıcı işlemi eklenir. Hata ayıklama süreci, çalışan işlem tekrar çöktüğünde bir bellek dökümü toplar. Bu bellek dökümü daha sonra analiz edilir ve kilitlenmeye neden olan iş parçacığının çağrı yığını App Service günlüklerinize kaydedilir.

false Bu otomatik izleme davranışını devre dışı bırakmak için olarak ayarlayın. Varsayılan değer: true.

Daha fazla bilgi için Azure App Service'te Proaktif Kilitlenme İzleme blog gönderisine bakın.
WEBSITE_DAAS_STORAGE_SASURI Çökme izleme sırasında (proaktif veya elle), bellek dökümleri varsayılan olarak silinir. Bellek dökümlerini bir depolama blob kapsayıcısına kaydetmek için paylaşılan erişim imzası (SAS) URI'sini belirtin.
WEBSITE_CRASHMONITORING_ENABLED true Kilitlenme izlemeyi el ile etkinleştirmek için olarak ayarlayın. Ve WEBSITE_DAAS_STORAGE_SASURI ve WEBSITE_CRASHMONITORING_SETTINGS öğelerini de ayarlamanız gerekir. Varsayılan değer: false.

Uzaktan hata ayıklama etkinse bu ayarın bir etkisi yoktur. Ayrıca, bu ayar true olarak ayarlanırsa, proaktif kilitlenme izleme devre dışı bırakılır.
WEBSITE_CRASHMONITORING_SETTINGS Aşağıdaki biçime sahip JSON:{"StartTimeUtc": "2020-02-10T08:21","MaxHours": "<elapsed-hours-from-StartTimeUtc>","MaxDumpCount": "<max-number-of-crash-dumps>"}. belirtilirse WEBSITE_CRASHMONITORING_ENABLED yapılandırmak gereklidir. Depolama hesabında kilitlenme dökümünü kaydetmeden çağrı yığınını günlüğe kaydetmek için JSON'a ekleyin ,"UseStorageAccount":"false" .
REMOTEDEBUGGINGVERSION Uzaktan hata ayıklama sürümü.
WEBSITE_CONTENTAZUREFILECONNECTIONSTRING Varsayılan olarak App Service, uygulama oluşturma sırasında sizin için paylaşılan bir depolama alanı oluşturur. Bunun yerine özel bir depolama hesabı kullanmak için depolama hesabınızın bağlantı dizesi ayarlayın. İşlevler için bkz. Azure İşlevleri için uygulama ayarları başvurusu.

Örnek: DefaultEndpointsProtocol=https;AccountName=<name>;AccountKey=<key>
WEBSITE_CONTENTSHARE ile WEBSITE_CONTENTAZUREFILECONNECTIONSTRINGözel bir depolama hesabı belirttiğinizde, App Service bu depolama hesabında uygulamanız için bir dosya paylaşımı oluşturur. Özel bir ad kullanmak için bu değişkeni istediğiniz ada ayarlayın. Belirtilen ada sahip bir dosya paylaşımı yoksa App Service bunu sizin için oluşturur.

Örnek: myapp123
WEBSITE_SCM_ALWAYS_ON_ENABLED Yalnızca okunabilir "Always On'un açık (1) veya kapalı (0) olduğunu gösterir."
WEBSITE_SCM_SEPARATE_STATUS Yalnızca okunabilir Kudu uygulamasının ayrı bir işlemde () çalışıp çalışmadığını (10) gösterir.
WEBSITE_DNS_ATTEMPTS İsim çözümlemesinin kaç kez deneneceği.
WEBSITE_DNS_TIMEOUT Ad çözümlemesi için beklenmesi gereken saniye sayısı.
WEBSITES_CONTAINER_START_TIME_LIMIT Platformun bir kapsayıcının başlangıçta hazır olmasını beklediği süre (saniye cinsinden). Bu ayar, Linux için App Service'te hem kod tabanlı hem de kapsayıcı tabanlı uygulamalar için geçerlidir. Varsayılan değer şudur: 230.

Kapsayıcı başlatıldığında, organik trafiğe hizmet etmeye hazır olduğunu ölçmek için kapsayıcıya sürekli ping gönderilir. (Bkz WEBSITE_WARMUP_PATH . ve WEBSITE_WARMUP_STATUSES.) Bu pingler, başarılı bir yanıt alınana veya başlangıç zamanı sınırına ulaşılana kadar sürekli olarak yapılır. Kapsayıcı yapılandırılan zaman aşımı içinde hazır olarak kabul edilmezse platform başlatma girişiminde başarısız olur ve yeniden denemeler 503 hatasıyla sonuçlanır.

Windows kapsayıcıları için App Service'de varsayılan başlangıç zaman sınırı 10 mins'dir. Bir zaman aralığı belirterek başlangıç zamanı sınırını değiştirebilirsiniz. Örneğin, 00:05:00 5 dakikayı gösterir.

Değişken ön ekleri

Aşağıdaki tabloda, App Service'in çeşitli amaçlar için kullandığı ortam değişkeni ön ekleri gösterilmektedir.

Ayar adı Açıklama
APPSETTING_ Müşterinin uygulama yapılandırmasında bir değişkeni uygulama ayarı olarak ayarladığını belirtir. Bir .NET uygulamasına uygulama ayarı olarak eklenmiştir.
MAINSITE_ Bir değişkenin uygulamanın kendisine özgü olduğunu belirtir.
SCMSITE_ Bir değişkenin Kudu uygulamasına özgü olduğunu belirtir.
SQLCONNSTR_ Uygulama yapılandırmasında SQL Server bağlantı dizesi. .NET uygulamasına bağlantı dizesi olarak eklenmiştir.
SQLAZURECONNSTR_ Uygulama yapılandırmasında Azure SQL Veritabanı bağlantı dizesi. .NET uygulamasına bağlantı dizesi olarak eklenmiştir.
POSTGRESQLCONNSTR_ Uygulama yapılandırmasında PostgreSQL bağlantı dizesi. .NET uygulamasına bağlantı dizesi olarak eklenmiştir.
CUSTOMCONNSTR_ Uygulama yapılandırmasında özel bağlantı dizesi. .NET uygulamasına bağlantı dizesi olarak eklenmiştir.
MYSQLCONNSTR_ Uygulama yapılandırmasında MySQL veritabanı bağlantı dizesi. .NET uygulamasına bağlantı dizesi olarak eklenmiştir.
AZUREFILESSTORAGE_ Azure Dosyalar'da özel bir kapsayıcıya ait özel paylaşım için bağlantı dizesi.
AZUREBLOBSTORAGE_ Azure Blob Depolama'da, özel bir kapsayıcı için özel bir depolama hesabına ait bağlantı dizesi.
NOTIFICATIONHUBCONNSTR_ Azure Notification Hubs'da bir bildirim hub'ına bağlantı dizesi.
SERVICEBUSCONNSTR_ Azure Service Bus örneğine bağlantı dizesi.
EVENTHUBCONNSTR_ Azure Event Hubs'da bir olay merkezine bağlantı dizisi.
DOCDBCONNSTR_ Azure Cosmos DB'deki bir veritabanına bağlantı dizesi.
REDISCACHECONNSTR_ Redis için Azure Cache'te bir önbelleğe bağlantı dizesi.
FILESHARESTORAGE_ Özel dosya paylaşımına bağlantı dizesi.

Dağıtım

Aşağıdaki ortam değişkenleri uygulama dağıtımıyla ilgilidir. App Service derleme otomasyonuyla ilgili değişkenler için bu makalenin devamında derleme otomasyonu bölümüne bakın.

Ayar adı Açıklama
DEPLOYMENT_BRANCH Yerel Git veya bulut Git dağıtımı için (GitHub gibi), Azure'da dağıtmak istediğiniz dala ayarlayın. Varsayılan olarak değeridir master.
WEBSITE_RUN_FROM_PACKAGE 1 ayarlayarak uygulamayı yerel bir ZIP paketinden çalıştırın veya harici bir URL'ye ayarlayarak uygulamayı uzaktaki bir ZIP paketinden çalıştırın. Daha fazla bilgi için bkz. Uygulamanızı doğrudan zip paketinden Azure Uygulaması Hizmetinde çalıştırma.
WEBSITE_USE_ZIP Kullanımdan kaldırıldı. WEBSITE_RUN_FROM_PACKAGE adresini kullanın.
WEBSITE_RUN_FROM_ZIP Kullanımdan kaldırıldı. WEBSITE_RUN_FROM_PACKAGE adresini kullanın.
SCM_MAX_ZIP_PACKAGE_COUNT Uygulamanız, ZIP dağıtımı aracılığıyla dağıtılan en son zip dosyalarından beşini tutar. Uygulama ayarını farklı bir sayıya değiştirerek daha fazla veya daha az süre tutabilirsiniz.
WEBSITE_WEBDEPLOY_USE_SCM false ayarını, Web Dağıtımı'nın Kudu dağıtım motorunu kullanmayı durdurması için yapın. Varsayılan değer: true. Visual Studio (Web Dağıtımı/MSDeploy) kullanarak Linux uygulamalarına dağıtmak için false değerini ayarlayın.
MSDEPLOY_RENAME_LOCKED_FILES 1 olarak ayarlayın, böylece Web Dağıtımı sırasında kopyalanamazsa DLL'leri yeniden adlandırmayı deneyin. Bu ayar, WEBSITE_WEBDEPLOY_USE_SCMfalse olarak ayarlandıysa geçerli değildir.
WEBSITE_DISABLE_SCM_SEPARATION Varsayılan olarak, ana uygulama ve Kudu uygulaması farklı korumalı alanlarda çalışır. Uygulamayı durdurduğunuzda Kudu uygulaması çalışmaya devam eder ve Git dağıtımını ve MSDeploy'u kullanmaya devam edebilirsiniz. Her uygulamanın kendi yerel dosyaları vardır. Bu ayrımı kapatmak (ayarı true) artık tam olarak desteklenmeyen eski bir moddur.
WEBSITE_ENABLE_SYNC_UPDATE_SITE Rest API çağrılarının döndürülmeden 1 önce güncelleştirilmesini site ve siteconfig tüm örneklere tamamen uygulanmasını sağlamak için ayarlayın. Varsayılan ayar, bir Azure Resource Manager şablonu (ARM şablonu) ile dağıtım yapıyorsanız 1'dir ve bu ayar, sonraki kaynak yöneticisi çağrılarıyla yarış koşullarını önlemeye yardımcı olur.
WEBSITE_START_SCM_ON_SITE_CREATION Arm şablonu dağıtımında, uygulama oluşturma işleminin bir parçası olarak Kudu uygulamasını önceden başlatmak için ARM şablonunda olarak ayarlayın 1 .
WEBSITE_START_SCM_WITH_PRELOAD Linux uygulamaları için, Url'sine true ping atarak Always On etkinleştirildiğinde Kudu uygulamasının önceden yüklenmesini zorlamak için olarak ayarlayın. Varsayılan değer: false. Windows uygulamaları için Kudu uygulaması her zaman önceden yüklenir.

Yapı otomasyonu

Kudu derleme yapılandırması yerel Windows uygulamaları için geçerlidir ve Git tabanlı (veya ZIP tabanlı) dağıtımların davranışını denetlemek için kullanılır.

Ayar adı Açıklama
SCM_BUILD_ARGS msbuild komut satırının sonuna, varsayılan komut satırının önceki bölümlerini geçersiz kılması için öğeleri ekleyin.

Örneğin, temiz bir derleme yapmak için: -t:Clean;Compile.
SCM_SCRIPT_GENERATOR_ARGS Kudu, azure site deploymentscript komutunu bir dağıtım betiği oluşturmak için kullanır. Dil çerçevesi türünü otomatik olarak algılar ve komuta geçirecek parametreleri belirler. Bu ayar otomatik olarak oluşturulan parametreleri geçersiz kılar.

Örneğin, deponuzu düz içerik dosyaları olarak ele almak için: --basic -p <folder-to-deploy>.
SCM_TRACE_LEVEL Build izleme seviyesi. Varsayılan değer: 1. İzlemeyi artırmak için 4'ye kadar daha yüksek değerlere ayarlayın.
SCM_COMMAND_IDLE_TIMEOUT Derleme sürecinin çıkış üretmeden önce çalıştırdığı her komut için beklenebilecek zaman aşımı, saniye cinsinden belirtilir. Bundan sonra, komut boşta olarak kabul edilir ve durdurulur. Varsayılan değer ( 60 bir dakika).

Azure'da 230 saniye sonra istemcilerin bağlantısını kesen genel bir boşta istek zaman aşımı da vardır. Ancak, komut bundan sonra sunucu tarafında çalışmaya devam eder.
SCM_LOGSTREAM_TIMEOUT Günlük akışını durdurmadan önce, etkinlik dışı kalma zaman aşımı süresi saniye cinsinden. Varsayılan değer ( 1800 30 dakika).
SCM_SITEEXTENSIONS_FEED_URL Site uzantıları galerisinin URL'si. Varsayılan değer: https://www.nuget.org/api/v2/. Eski akışın URL'si şeklindedir http://www.siteextensions.net/api/v2/.
SCM_USE_LIBGIT2SHARP_REPOSITORY 0 Git işlemleri için libgit2sharp yerine git.exe kullanacak şekilde ayarlayın.
WEBSITE_LOAD_USER_PROFILE ASP.NET derleme otomasyonu sırasında hata The specified user does not have a valid profile olması durumunda (git dağıtımı gibi), derleme ortamında tam kullanıcı profili yüklemek için bu değişkeni 1 olarak ayarlayın. Bu ayar yalnızca WEBSITE_COMPUTE_MODEDedicated olduğunda geçerlidir.
WEBSITE_SCM_IDLE_TIMEOUT_IN_MINUTES Kaynak Denetim Yöneticisi (Kudu) sitesi için dakika cinsinden zaman aşımı. Varsayılan değer: 20.
SCM_DO_BUILD_DURING_DEPLOYMENT ZIP dağıtımı ile dağıtım altyapısı, bir ZIP dosyasının olduğu gibi çalışmaya hazır olduğunu ve herhangi bir derleme otomasyonunu çalıştırmadığını varsayar. Git dağıtımındakiyle aynı derleme otomasyonunu etkinleştirmek için bunu true olarak ayarlayın.

Dile özgü ayarlar

Bu bölümde desteklenen her dil çerçevesi için yapılandırılabilir çalışma zamanı ayarları gösterilir. Dağıtım zamanında derleme otomasyonu esnasında daha fazla ayar kullanılabilir.

Ayar adı Açıklama
PORT Yalnızca okunabilir Linux uygulamaları için, .NET çalışma zamanının kapsayıcıda dinlediği bağlantı noktası.
WEBSITE_ROLE_INSTANCE_ID Yalnızca okunabilir Geçerli örneğin ID'si.
HOME Yalnızca okunabilir Paylaşılan depolamayı () işaret eden dizin/home.
DUMP_DIR Yalnızca okunabilir Çökme dökümleri dizini (/home/logs/dumps).
APP_SVC_RUN_FROM_COPY Yalnızca Linux uygulamaları. Varsayılan olarak, uygulama tüm ölçeklendirilen örnekler için paylaşılan bir dizinden /home/site/wwwrootçalıştırılır. Uygulamayı kapsayıcınızdaki yerel bir dizine kopyalamak ve oradan çalıştırmak için bu değişkeni true olarak ayarlayın. Bu seçeneği kullandığınızda, /home/site/wwwroot herhangi bir referans noktası sabitlemediğinizden emin olun. Bunun yerine, /home/site/wwwroot ile ilgili bir yol kullanın.
MACHINEKEY_Decryption Yerel Windows uygulamaları veya kapsayıcılı Windows uygulamaları için bu değişken, ASP.NET şifreleme yordamlarını etkinleştirmek için bir uygulama ortamına veya kapsayıcıya eklenir. (Bkz. machineKey Öğesi.) Varsayılan decryption değerini geçersiz kılmak için, bunu bir App Service uygulama ayarı olarak yapılandırın veya dosyada machineKey öğesinin içine Web.config doğrudan ayarlayın.
MACHINEKEY_DecryptionKey Yerel Windows uygulamaları veya kapsayıcılı Windows uygulamaları için bu değişken, ASP.NET şifreleme yordamlarını etkinleştirmek için uygulama ortamına veya kapsayıcıya eklenir. (Bkz. machineKey Öğesi.) Otomatik olarak oluşturulan decryptionKey değerini geçersiz kılmak için bir App Service uygulama ayarı olarak yapılandırın veya doğrudan machineKey dosyasının Web.config öğesinde ayarlayın.
MACHINEKEY_Validation Yerel Windows uygulamaları veya kapsayıcılı Windows uygulamaları için bu değişken, ASP.NET şifreleme yordamlarını etkinleştirmek için uygulama ortamına veya kapsayıcıya eklenir. (Bkz. machineKey Öğesi.) Varsayılan validation değerini geçersiz kılmak için, bunu bir App Service uygulama ayarı olarak yapılandırın veya dosyada machineKey öğesinin içine Web.config doğrudan ayarlayın.
MACHINEKEY_ValidationKey Yerel Windows uygulamaları veya kapsayıcılı Windows uygulamaları için bu değişken, ASP.NET şifreleme yordamlarını etkinleştirmek için uygulama ortamına veya kapsayıcıya eklenir. (Bkz. machineKey Öğesi.) Otomatik olarak oluşturulan validationKey değerini geçersiz kılmak için bir App Service uygulama ayarı olarak yapılandırın veya doğrudan machineKey dosyasının Web.config öğesinde ayarlayın.

WordPress

Uygulama ayarı Kapsam Değer Maksimum Açıklama
WEBSITES_ENABLE_APP_SERVICE_STORAGE Web uygulaması true Uygulanamaz olarak ayarlandığında true, yeniden başlatmalar sırasında dosya içeriği korunur.
WP_MEMORY_LIMIT WordPress 128M 512M Ön uç veya genel WordPress PHP bellek sınırı (betik başına). değerinden fazlası PHP_MEMORY_LIMITolamaz.
WP_MAX_MEMORY_LIMIT WordPress 256M 512M Yönetici panosu PHP bellek sınırı (betik başına). Genel olarak, yönetici panosu ve arka uç betikleri ön uç betiklerine kıyasla çok fazla bellek alır. değerinden fazlası PHP_MEMORY_LIMITolamaz.
PHP_MEMORY_LIMIT PHP 512M 512M Genel PHP betikleri için bellek sınırı. Yalnızca azaltılabilir.
FILE_UPLOADS PHP On Uygulanamaz Dosya yüklemelerini etkinleştirir veya devre dışı bırakır. veya OnolabilirOff. Değerlerin büyük/küçük harfe duyarlı olduğunu unutmayın.
UPLOAD_MAX_FILESIZE PHP 50M 256M Dosya yükleme için boyut sınırı. 'a 256Mkadar artırılabilir.
POST_MAX_SIZE PHP 128M 256M 'a 256Mkadar artırılabilir. Genellikle değerinden daha fazla UPLOAD_MAX_FILESIZEolmalıdır.
MAX_EXECUTION_TIME PHP 120 120 Yalnızca azaltılabilir. Eğer 120 saniyeden uzun sürerse betikleri parçala. Hatalı betiklerin sistemi yavaşlatmasını önlemek için eklendi.
MAX_INPUT_TIME PHP 120 120 Giriş isteklerini ayrıştırmak için süre sınırı. Yalnızca azaltılabilir.
MAX_INPUT_VARS PHP 10000 10000 Giriş istekleri için en fazla değişken sayısı.
DATABASE_HOST Veritabanı Uygulanamaz Uygulanamaz WordPress'e bağlanmak için kullanılan veritabanı konağı.
DATABASE_NAME Veritabanı Uygulanamaz Uygulanamaz WordPress'e bağlanmak için kullanılan veritabanı adı.
DATABASE_USERNAME Veritabanı Uygulanamaz Uygulanamaz WordPress'e bağlanmak için kullanılan veritabanı kullanıcı adı.
DATABASE_PASSWORD Veritabanı Uygulanamaz Uygulanamaz MySQL veritabanına bağlanmak için kullanılan veritabanı parolası. MySQL veritabanı parolasını değiştirmek için bkz. Yönetici parolasını güncelleştirme. MySQL veritabanı parolası her değiştirildiğinde uygulama ayarlarının da güncelleştirilmiş olması gerekir.
WORDPRESS_ADMIN_EMAIL Yalnızca dağıtım Uygulanamaz Uygulanamaz WordPress yönetici e-postası.
WORDPRESS_ADMIN_PASSWORD Yalnızca dağıtım Uygulanamaz Uygulanamaz WordPress yönetici parolası. Bu ayar yalnızca dağıtım amaçlıdır. Bu değeri değiştirmenin WordPress yüklemesi üzerinde hiçbir etkisi yoktur. WordPress yönetici parolasını değiştirmek için bkz. Parolanızı sıfırlama.
WORDPRESS_ADMIN_USER Yalnızca dağıtım Uygulanamaz Uygulanamaz WordPress yönetici kullanıcı adı.
WORDPRESS_ADMIN_LOCALE_CODE Yalnızca dağıtım Uygulanamaz Uygulanamaz WordPress'e bağlanmak için kullanılan veritabanı kullanıcı adı.

Etki alanı ve DNS

Ayar adı Açıklama
WEBSITE_DNS_SERVER Giden bağlantılar için birincil DNS sunucusunun IP adresi (örneğin, bir arka uç hizmetine). App Service için varsayılan DNS sunucusu, IP adresi olan Azure DNS'dir 168.63.129.16. Uygulamanız sanal ağ tümleştirmesi kullanıyorsa veya bir App Service ortamındaysa, dns sunucusu yapılandırmasını varsayılan olarak sanal ağdan devralır.

Örnek: 10.0.0.1
WEBSITE_DNS_ALT_SERVER Giden bağlantılar için geri dönüş DNS sunucusunun IP adresi. Bkz. WEBSITE_DNS_SERVER.
WEBSITE_ENABLE_DNS_CACHE Başarılı DNS çözümlemelerinin önbelleğe alınmasına izin verir. Varsayılan olarak, süresi dolan DNS önbellek girdileri her 4,5 dakikada bir temizlenir (mevcut önbelleğe ek olarak).

TLS/SSL

Daha fazla bilgi için bkz. Azure Uygulaması Hizmeti'nde kodunuzda TLS/SSL sertifikası kullanma.

Ayar adı Açıklama
WEBSITE_LOAD_CERTIFICATES Kodunuzda yüklemek istediğiniz sertifikaya virgülle ayrılmış parmak izi değerleri. Veya tüm sertifikaların koda yüklenmesine izin vermek için kullanın * . Yalnızca uygulamanıza eklenen sertifikalar yüklenebilir.
WEBSITE_PRIVATE_CERTS_PATH Yalnızca okunabilir Windows kapsayıcısında yüklü özel sertifikaların yolu.
WEBSITE_PUBLIC_CERTS_PATH Yalnızca okunabilir Windows kapsayıcısında yüklü ortak sertifikalara giden yol.
WEBSITE_INTERMEDIATE_CERTS_PATH Yalnızca okunabilir Windows kapsayıcısında yüklü ara sertifikalara giden yol.
WEBSITE_ROOT_CERTS_PATH Yalnızca okunabilir Windows kapsayıcısında yüklü kök sertifikalara giden yol.

Dağıtım alanları

Daha fazla bilgi için bkz. Azure Uygulama Hizmetinde hazırlama ortamlarını ayarlama.

Ayar adı Açıklama
WEBSITE_OVERRIDE_STICKY_EXTENSION_VERSIONS Varsayılan olarak, site uzantılarının sürümleri her yuvaya özeldir. Bu varsayılan ayar, değiştirme işleminden sonra uzantı sürümlerinin değiştirilmesi nedeniyle tahmin edilmeyen uygulama davranışını engeller. Eğer uzantı sürümlerinin de değiştirilmesini istiyorsanız, 0 olarak ayarlayın.
WEBSITE_OVERRIDE_PRESERVE_DEFAULT_STICKY_SLOT_SETTINGS Belirli ayarları yapışkan olarak veya varsayılan olarak değiştirilemez olarak ayarlar. Varsayılan true değeridir. Bunun yerine değiştirilebilir hale getirmek için bu değeri false0 için veya olarak ayarlayın. Belirli ayar türleri için ayrıntılı denetim yoktur.
WEBSITE_SWAP_WARMUP_PING_PATH Eğik çizgiyle başlayarak bir takasta hedef yuvayı ısıtmak için ping gönderme yolu. Varsayılan değer, HTTP üzerinden kök yola ping işlemi yapan değeridir /.

Örnek: /statuscheck
WEBSITE_SWAP_WARMUP_PING_STATUSES Değiştirme sırasında ısınma işlemi için geçerli HTTP yanıt kodları. Döndürülen durum kodu listede yoksa, ısınma ve değiştirme işlemleri durdurulur. Varsayılan olarak, tüm yanıt kodları geçerlidir.

Örnek: 200,202
WEBSITE_SLOT_NUMBER_OF_TIMEOUTS_BEFORE_RESTART Zaman aralığı değiştirme sırasında, belirli bir VM örneğinde sitenin zorla yeniden başlatılmasından önceki maksimum zaman aşımı sayısı. Varsayılan değer: 3.
WEBSITE_SLOT_MAX_NUMBER_OF_TIMEOUTS Bir yuva değişimi sırasında, tek bir URL için vazgeçmeden önce yapılabilecek en fazla zaman aşımı isteği sayısı. Varsayılan değer: 5.
WEBSITE_SKIP_ALL_BINDINGS_IN_APPHOST_CONFIG true içindeki tüm bağlılıkları atlamak için 1 veya applicationHost.config olarak ayarlayın. Varsayılan değer: false. Uygulamanız, yuvaların değiştirilmiş ana bilgisayar adlarıyla applicationHost.config güncellendiğinde bir yeniden başlatma tetikliyorsa, bu tür bir yeniden başlatmayı önlemek için bu değişkeni true olarak ayarlayın. Windows Communication Foundation uygulaması çalıştırıyorsanız bu değişkeni ayarlamayın.

Özel kapsayıcılar

Özel kapsayıcılar hakkında daha fazla bilgi için bkz . Azure'da özel kapsayıcı çalıştırma.

Ayar adı Açıklama
WEBSITES_ENABLE_APP_SERVICE_STORAGE Linux kapsayıcıları için, bu uygulama ayarı belirtilmezse dizin /home varsayılan olarak ölçeklendirilmiş örnekler arasında paylaşılır. Paylaşımı devre dışı bırakmak için false olarak ayarlayabilirsiniz.

Windows kapsayıcıları için, dizinin ölçeklendirilmiş örnekler arasında paylaşılabilmesi için olarak ayarlayın truec:\home . Varsayılan değer true Windows kapsayıcıları içindir.
WEBSITES_CONTAINER_STOP_TIME_LIMIT Kapsayıcının düzgün bir şekilde sona ermesini bekleme süresi (saniye cinsinden). Varsayılan 5 değeridir. üst sınırına 120kadar artırabilirsiniz.
DOCKER_REGISTRY_SERVER_URL App Service'te özel bir kapsayıcı çalıştırırken kayıt defteri sunucusunun URL'si. Güvenlik için bu değişken kapsayıcıya geçirilmiyor.

Örnek: https://<server-name>.azurecr.io
DOCKER_REGISTRY_SERVER_USERNAME konumundaki DOCKER_REGISTRY_SERVER_URLkayıt defteri sunucusuyla kimlik doğrulaması için kullanıcı adı. Güvenlik için bu değişken kapsayıcıya geçirilmiyor.
DOCKER_REGISTRY_SERVER_PASSWORD konumundaki DOCKER_REGISTRY_SERVER_URLkayıt defteri sunucusuyla kimlik doğrulaması için parola. Güvenlik için bu değişken kapsayıcıya geçirilmiyor.
DOCKER_ENABLE_CI Özel kapsayıcılar true için sürekli dağıtımı etkinleştirmek için olarak ayarlayın. Özel kapsayıcılar için varsayılan false değeridir.
WEBSITE_PULL_IMAGE_OVER_VNET Sanal ağ veya şirket içi içindeki bir kayıt defterine bağlanın ve kayıt defterinden çekin. Uygulamanızın sanal ağ tümleştirme özelliği aracılığıyla bir sanal ağa bağlanması gerekir. Bu ayar, özel uç nokta içeren Azure Container Registry için de gereklidir.
WEBSITES_WEB_CONTAINER_NAME Docker Compose uygulamasında kapsayıcılardan yalnızca biri İnternet'e erişilebilir. Varsayılan kapsayıcı seçimini geçersiz kılmak için yapılandırma dosyasında tanımlanan kapsayıcının adına ayarlayın. Varsayılan olarak, İnternet'e erişilebilir kapsayıcı 80 veya 8080 numaralı bağlantı noktasını tanımlayan ilk kapsayıcıdır. Böyle bir kapsayıcı bulunamadığında varsayılan, yapılandırma dosyasında tanımlanan ilk kapsayıcıdır.
WEBSITES_PORT Özel bir kapsayıcı için, App Service'in istekleri yönlendirecek kapsayıcıdaki özel bağlantı noktası numarası. App Service varsayılan olarak 80 ve 8080 numaralı bağlantı noktalarını otomatik olarak algılamayı dener. Bu ayar kapsayıcıya ortam değişkeni olarak eklenmez.
WEBSITE_CPU_CORES_LIMIT Varsayılan olarak, bir Windows kapsayıcısı seçtiğiniz fiyatlandırma katmanı için tüm kullanılabilir çekirdeklerle çalışır. Çekirdek sayısını azaltmak için istenen çekirdek sayısına bir sınır ayarlayın. Daha fazla bilgi için bkz . İşlem çekirdeği sayısını özelleştirme.
WEBSITE_MEMORY_LIMIT_MB Varsayılan olarak, App Service'te dağıtılan tüm Windows kapsayıcılarının, App Service planının katmanına bağlı olarak yapılandırılmış bir bellek sınırı vardır. megabayt cinsinden istenen bellek sınırına ayarlayın. Aynı plandaki uygulamalar genelinde bu ayarın toplu toplamı, seçilen fiyatlandırma katmanının izin verdiği miktarı aşmamalıdır. Daha fazla bilgi için bkz . Kapsayıcı belleğini özelleştirme.

Ölçeklendirme

Ayar adı Açıklama
WEBSITE_INSTANCE_ID Yalnızca okunabilir Uygulamanın ölçeği birden çok örneğe genişletildiğinde geçerli VM örneğinin benzersiz kimliği.
WEBSITE_IIS_SITE_NAME Kullanımdan kaldırıldı. WEBSITE_INSTANCE_ID adresini kullanın.
WEBSITE_DISABLE_OVERLAPPED_RECYCLING Çakışan geri dönüşüm, bir uygulamanın geçerli VM örneği kapatılmadan önce yeni bir VM örneğinin başlatılmasını sağlar. Bazı durumlarda dosya kilitleme sorunlarına neden olabilir. ayarını olarak ayarlayarak kapatmayı 1deneyebilirsiniz.
WEBSITE_DISABLE_CROSS_STAMP_SCALE Varsayılan olarak, uygulamalar Azure Dosyalar veya Docker kapsayıcısı kullanıyorsa damgalar arasında ölçeklendirilebilir. 1 Uygulamanın bölgesinde çapraz damga ölçeklendirmeyi devre dışı bırakmak için veya true olarak ayarlayın. Varsayılan değer: 0. İçeriği Docker kapsayıcısında tamamen kapsüllenmediğinden çapraz damgaları olarak ayarlayan WEBSITES_ENABLE_APP_SERVICE_STORAGEtrue veya 1 ölçeklendiremediği özel Docker kapsayıcıları.

Günlük Kaydı

Ayar adı Açıklama
WEBSITE_HTTPLOGGING_ENABLED Yalnızca okunabilir Web sunucusu günlüğünün yerel Windows uygulamaları için etkin olup olmadığını (1) veya etkin olmadığını (0) gösterir.
WEBSITE_HTTPLOGGING_RETENTION_DAYS Web sunucusu günlükleri yerel bir Windows veya Linux uygulaması için etkinleştirildiyse, web sunucusu günlüklerinin saklama süresi (gün cinsinden).

Örnek: 10
WEBSITE_HTTPLOGGING_CONTAINER_URL SAS URL'si, web sunucusu günlükleri etkinse yerel Windows uygulamaları için web sunucusu günlüklerini depolamak üzere blob depolama kapsayıcısına aittir. Ayarlanmadıysa, web sunucusu günlükleri uygulamanın dosya sisteminde (varsayılan paylaşılan depolama) depolanır.
DIAGNOSTICS_AZUREBLOBRETENTIONINDAYS Uygulama günlükleri etkinse yerel Windows uygulamaları için uygulama günlüklerinin saklama süresi (gün cinsinden).

Örnek: 10
DIAGNOSTICS_AZUREBLOBCONTAINERSASURL Uygulama günlükleri etkinleştirilmişse, yerel Windows uygulamaları için uygulama günlüklerini depolamak amacıyla kullanılan blob depolama kapsayıcısının SAS URL'si.
APPSERVICEAPPLOGS_TRACE_LEVEL AppServiceAppLogs günlük türü için Log Analytics'e gönderilecek asgarî günlük düzeyi.
DIAGNOSTICS_LASTRESORTFILE Günlük dizini için oluşturulacak dosya adı veya göreli yol, dinleyici sorunlarını gidermek amacıyla iç hataların kaydedilmesi içindir. Varsayılan değer: logging-errors.txt.
DIAGNOSTICS_LOGGINGSETTINGSFILE Log ayarları dosyasının yolu, D:\home veya /home ile göreceli. Varsayılan değer: site\diagnostics\settings.json.
DIAGNOSTICS_TEXTTRACELOGDIRECTORY Günlük klasörü, uygulama köküne (D:\home\site\wwwroot veya /home/site/wwwroot) göre.

Örnek: ..\..\LogFiles\Application
DIAGNOSTICS_TEXTTRACEMAXLOGFILESIZEBYTES Günlük dosyasının bayt cinsinden maksimum boyutu. Varsayılan değer ( 131072 128 KB).
DIAGNOSTICS_TEXTTRACEMAXLOGFOLDERSIZEBYTES Günlük klasörünün bayt cinsinden maksimum boyutu. Varsayılan değer ( 1048576 1 MB).
DIAGNOSTICS_TEXTTRACEMAXNUMLOGFILES Tutulacak günlük dosyası sayısı üst sınırı. Varsayılan değer: 20.
DIAGNOSTICS_TEXTTRACETURNOFFPERIOD Uygulama günlüğünü etkin tutmak için milisaniye cinsinden zaman aşımı. Varsayılan değer ( 43200000 12 saat).
WEBSITE_LOG_BUFFERING Varsayılan olarak, log ara belleğe alma etkindir. Devre dışı bırakmak için olarak 0 ayarlayın.
WEBSITE_ENABLE_PERF_MODE Yerel Windows uygulamaları için, 10 saniye içinde döndürülen başarılı istekler için IIS günlük girdilerini kapatmak üzere TRUE değerine ayarlayın. Bu, genişletilmiş günlüğü kaldırarak performans karşılaştırması gerçekleştirmenin hızlı bir yoludur.

Performans sayaçları

Aşağıda, bunları numaralandırırsanız mevcut olmayan "sahte" ortam değişkenleri vardır, ancak bunları tek tek ararsanız değerleri döndürülmektedir. Değer dinamiktir ve her aramada değişebilir.

Ayar adı Açıklama
WEBSITE_COUNTERS_ASPNET ASP.NET performans sayaçlarını içeren JSON nesnesi.
WEBSITE_COUNTERS_APP Korumalı alan sayaçları içeren JSON nesnesi.
WEBSITE_COUNTERS_CLR Ortak Dil Çalışma Zamanı sayaçlarını içeren JSON nesnesi.
WEBSITE_COUNTERS_ALL Diğer üç değişkenin birleşimini içeren JSON nesnesi.

Önbellekleme

Ayar adı Açıklama
WEBSITE_LOCAL_CACHE_OPTION Yerel önbelleğin etkinleştirilip etkinleştirilmediği. Kullanılabilir seçenekler şunlardır:

- Default: Damga düzeyi genel ayarını devralın.
- Always: Uygulama için etkinleştirin.
- OnStorageUnavailability
- Disabled: Uygulama için devre dışı bırakın.
WEBSITE_LOCAL_CACHE_READWRITE_OPTION Yerel önbelleğin okuma/yazma seçenekleri. Kullanılabilir seçenekler şunlardır:

- ReadOnly: Önbellek salt okunurdur.
- WriteButDiscardChanges: Yerel önbelleğe yazma işlemlerine izin verin, ancak yerel olarak yapılan değişiklikleri atın.
WEBSITE_LOCAL_CACHE_SIZEINMB Yerel önbelleğin megabayt cinsinden boyutu. Varsayılan değer ( 1000 1 GB).
WEBSITE_LOCALCACHE_READY Uygulamanın yerel önbelleği kullanıp kullanmadığını gösteren salt okunur bayrak.
WEBSITE_DYNAMIC_CACHE Ağ dosya paylaşımının birden çok örneğe erişim izni verme yapısı nedeniyle dinamik önbellek, son erişilen dosyaları bir örnekte yerel olarak önbelleğe alarak performansı artırır. Dosya değiştirildiğinde önbellek geçersiz kılınır. Önbellek konumu şeklindedir %SYSTEMDRIVE%\local\DynamicCache. (Aynı %SYSTEMDRIVE%\local kota uygulanır.)

Tam içerik önbelleğe almayı etkinleştirmek için, hem dosya içeriğini hem de dizin/dosya meta verilerini (zaman damgaları, boyut, dizin içeriği) içeren olarak ayarlayın 1. Yerel disk kullanımını korumak için yalnızca dizin/dosya meta verilerini (zaman damgaları, boyut, dizin içeriği) önbelleğe almak için 2 olarak ayarlayın. Önbelleğe almayı kapatmak için olarak 0ayarlayın.

Windows uygulamaları ve WordPress şablonuyla oluşturulan Linux uygulamaları için varsayılan değerdir1. Diğer tüm Linux uygulamaları için varsayılan değerdir 0.
WEBSITE_READONLY_APP Dinamik önbellek kullandığınızda, bu değişkeni D:\home\site\wwwrootolarak ayarlayarak uygulama köküne (/home/site/wwwroot veya 1) yazma erişimini devre dışı bırakabilirsiniz. App_Data Dizin dışında, kilitli dosyaların dağıtımları engellememesi için özel kilitlere izin verilmez.

Ağ

Aşağıdaki ortam değişkenleri karma bağlantılar ve sanal ağ tümleştirmesi ile ilgilidir.

Ayar adı Açıklama
WEBSITE_RELAYS Yalnızca okunabilir Uç noktalar ve service bus verileri dahil olmak üzere karma bağlantıyı yapılandırmak için gereken veriler.
WEBSITE_REWRITE_TABLE Yalnızca okunabilir Çalışma zamanında aramaları yapmak ve bağlantıları uygun şekilde yeniden yazmak için kullanılır.
WEBSITE_VNET_ROUTE_ALL Varsayılan olarak, bölgesel sanal ağ tümleştirmesi kullanıyorsanız uygulamanız yalnızca RFC1918 trafiği sanal ağınıza yönlendirir. 1 Tüm giden trafiği sanal ağınıza yönlendirecek şekilde ayarlayın ve aynı ağ güvenlik gruplarına ve kullanıcı tanımlı yollara tabi olun. Bu ayar sanal ağınız üzerinden RFC1918 olmayan uç noktalara erişmenizi, uygulamanızdan çıkan tüm giden trafiğin güvenliğini sağlamanızı ve tüm giden trafiği kendi seçtiğiniz bir ağ gerecine zorlamanızı sağlar.
WEBSITE_PRIVATE_IP Yalnızca okunabilir Sanal ağ ile tümleştirilmiş uygulamayla ilişkilendirilmiş IP adresi. Bölgesel sanal ağ tümleştirmesi için değer, temsilci alt ağın adres aralığından bir IP'dir. Ağ geçidi için gerekli sanal ağ tümleştirmesi için değer, sanal ağ geçidinde yapılandırılan noktadan siteye adres havuzunun adres aralığından bir IP'dir.

Uygulama, sanal ağ üzerinden kaynaklara bağlanmak için bu IP'yi kullanır. Ayrıca, açıklanan adres aralığı içinde değişebilir.
WEBSITE_PRIVATE_PORTS Yalnızca okunabilir Sanal ağ tümleştirmesinde, uygulamanın diğer düğümlerle iletişim kurmak için kullanabileceği bağlantı noktalarını gösterir.
WEBSITE_CONTENTOVERVNET App Service'te bir Azure dosya paylaşımını bağlarken depolama hesabı bir sanal ağ ile sınırlıysa, bu ayarı 1 değeriyle etkinleştirin.

Anahtar kasası başvuruları

Aşağıdaki ortam değişkenleri anahtar kasası başvuruları ile ilgilidir.

Ayar adı Açıklama
WEBSITE_KEYVAULT_REFERENCES Yalnızca okunabilir Uygulamada şu anda yapılandırılmış olan tüm anahtar kasası referansları için bilgileri (durumlar dahil) içerir.
WEBSITE_SKIP_CONTENTSHARE_VALIDATION Uygulamanızın paylaşılan depolama bağlantısını (kullanarak WEBSITE_CONTENTAZUREFILECONNECTIONSTRING) bir anahtar kasası başvurusuna ayarlarsanız, uygulama uygulama oluşturma sırasında anahtar kasası başvuruyu çözümleyemez veya aşağıdaki koşullardan biri doğruysa güncelleştiremez:

- Uygulama, sistem tarafından atanan bir kimlik kullanarak anahtar kasasına erişir.
- Uygulama, kullanıcı tarafından atanan bir kimlik kullanarak anahtar kasasına erişir ve anahtar kasası bir sanal ağ ile kilitlenir.

Oluşturma veya güncelleştirme zamanındaki hataları önlemek için bu değişkeni olarak 1ayarlayın.
WEBSITE_DELAY_CERT_DELETION 1 ortam değişkenini ayarlamak, bir çalışan işleminin bağımlı olduğu sertifikanın işlem çıkana kadar silinmemesini sağlar.

Kaynaklar Arası Paylaşım (CORS)

Aşağıdaki ortam değişkenleri çıkış noktaları arası kaynak paylaşımı (CORS) yapılandırmasıyla ilgilidir.

Ayar adı Açıklama
WEBSITE_CORS_ALLOWED_ORIGINS Yalnızca okunabilir CORS için izin verilen çıkış noktalarını gösterir.
WEBSITE_CORS_SUPPORT_CREDENTIALS Yalnızca okunabilir Access-Control-Allow-Credentials üstbilgi ayarının true etkinleştirilip etkinleştirilmediğini (True) veya etkinleştirilmediğini (False) gösterir.

Kimlik doğrulaması ve yetkilendirme

Aşağıdaki ortam değişkenleri App Service kimlik doğrulamasıyla ilgilidir.

Ayar adı Açıklama
WEBSITE_AUTH_DISABLE_IDENTITY_FLOW true olarak ayarlandığında, ASP.NET tabanlı web uygulamalarında (v1 işlev uygulamaları dahil) iş parçacığı ana kimliğini atama özelliğini devre dışı bırakır. Bu özellik, geliştiricilerin kimlik doğrulaması ile sitelerine erişimi korumalarına olanak tanır, ancak yine de uygulama mantığı içinde ayrı bir oturum açma mekanizması kullanır. Varsayılan değer: false.
WEBSITE_AUTH_HIDE_DEPRECATED_SID true veya false. Varsayılan değer şudur: false. Bu, Azure App Service için eski Mobile Apps tümleştirmesine yönelik bir ayardır. değerini true ayarlayarak kimliği doğrulanmış kullanıcılar için oluşturulan güvenlik kimliğinin, kullanıcı profil bilgilerini değiştirirse değişebileceği bir sorunu giderir.

Bu değerin değiştirilmesi, mevcut Azure Mobile Apps kullanıcı kimliklerinin değişmesine neden olabilir. Çoğu uygulamanın bu ayarı kullanması gerekmez.
WEBSITE_AUTH_NONCE_DURATION biçiminde hours:minutes:secondsbir zaman aralığı değeri. Varsayılan değer 00:05:00 veya 5 dakikadır. Bu ayar, tüm tarayıcı tabanlı oturum açma işlemleri için oluşturulan şifreleme nonce'sinin ömrünü denetler. Oturum açma işlemi belirtilen sürede tamamlayamazsa oturum açma akışı otomatik olarak yeniden denenecek.

Bu uygulama ayarı, V1 (klasik) yapılandırma deneyimiyle kullanılmak üzere tasarlanmıştır. V2 kimlik doğrulama yapılandırma şemasını kullanıyorsanız bunun yerine yapılandırma değerini kullanmanız login.nonce.nonceExpirationInterval gerekir.
WEBSITE_AUTH_PRESERVE_URL_FRAGMENT olarak ayarlandığında true ve kullanıcılar URL parçaları içeren uygulama bağlantılarını seçtiğinde, oturum açma işlemi URL'nizin URL parçası bölümünün oturum açma yeniden yönlendirme işleminde kaybolmamasını sağlar. Daha fazla bilgi için Azure Uygulama Hizmeti kimlik doğrulamasında oturum açmayı ve oturumu kapatmayı özelleştirme'ye bakın.
WEBSITE_AUTH_USE_LEGACY_CLAIMS Yükseltmeler arasında geriye dönük uyumluluğu korumak için, kimlik doğrulama modülü API'deki /.auth/me kısa adları uzun adlara eşleyen eski talep haritalamasını kullanır, böylece bazı eşlemeler hariç tutulur (örneğin, "roller"). Talep eşlemelerinin daha modern sürümünü almak için bu değişkeni olarak Falseayarlayın. "Roller" örneğinde, uzun talep adına http://schemas.microsoft.com/ws/2008/06/identity/claims/roleeşlenir.
WEBSITE_AUTH_DISABLE_WWWAUTHENTICATE true veya false. Varsayılan değer şudur: false. olarak ayarlandığında true, modül tarafından oluşturulan HTTP 401 yanıtlarından HTTP yanıt üst bilgisini kaldırır WWW-Authenticate .

Bu uygulama ayarı, V1 (klasik) yapılandırma deneyimiyle kullanılmak üzere tasarlanmıştır. V2 kimlik doğrulama yapılandırma şemasını kullanıyorsanız bunun yerine yapılandırma değerini kullanmanız identityProviders.azureActiveDirectory.login.disableWwwAuthenticate gerekir.
WEBSITE_AUTH_STATE_DIRECTORY Yerel dosya sisteminin, dosya tabanlı belirteç deposu etkinleştirildiğinde belirteçlerin depolandığı dizin yolu. Varsayılan değer şudur: %HOME%\Data\.auth.

Bu uygulama ayarı, V1 (klasik) yapılandırma deneyimiyle kullanılmak üzere tasarlanmıştır. V2 kimlik doğrulama yapılandırma şemasını kullanıyorsanız bunun yerine yapılandırma değerini kullanmanız login.tokenStore.fileSystem.directory gerekir.
WEBSITE_AUTH_TOKEN_CONTAINER_SASURL Tam blob kapsayıcı URL'si. Kimlik doğrulama modülüne, varsayılan yerel dosya sistemini kullanmak yerine tüm şifrelenmiş belirteçleri depolamasını ve belirtilen blob depolama kapsayıcısına yüklemesini belirtir.
WEBSITE_AUTH_TOKEN_REFRESH_HOURS Herhangi bir pozitif ondalık sayı. Varsayılan değer (saat) değeridir 72 . Bu ayar, bir oturum belirtecinin süresi dolduktan sonra API'yi yenilemek /.auth/refresh için kullanılabilecek süreyi denetler. Bu süre sonunda yenileme girişimleri başarısız olur ve kullanıcıların yeniden oturum açması gerekir.

Bu uygulama ayarı, V1 (klasik) yapılandırma deneyimiyle kullanılmak üzere tasarlanmıştır. V2 kimlik doğrulama yapılandırma şemasını kullanıyorsanız bunun yerine yapılandırma değerini kullanmanız login.tokenStore.tokenRefreshExtensionHours gerekir.
WEBSITE_AUTH_TRACE_LEVEL Uygulama günlüğüne yazılan kimlik doğrulama izlemlerinin ayrıntı düzeyini denetler. Geçerli değerler : Off, Error, Warning, Informationve Verbose. Varsayılan değer şudur: Verbose.
WEBSITE_AUTH_VALIDATE_NONCE true veya false. Varsayılan değer şudur: true. Bu değer, etkileşimli oturum açma sırasında meydana gelen false doğrulama hatalarını geçici olarak ayıkladığınız durumlar haricinde, hiçbir zaman olarak ayarlanmamalıdır.

Bu uygulama ayarı, V1 (klasik) yapılandırma deneyimiyle kullanılmak üzere tasarlanmıştır. V2 kimlik doğrulama yapılandırma şemasını kullanıyorsanız bunun yerine yapılandırma değerini kullanmanız login.nonce.validateNonce gerekir.
WEBSITE_AUTH_V2_CONFIG_JSON Azure App Service bu ortam değişkenini otomatik olarak doldurur. Bu değişken, tümleşik kimlik doğrulama modülünü yapılandırmak için kullanılır. Değeri, Azure Resource Manager'daki geçerli uygulamanın V2 (klasik olmayan) kimlik doğrulama yapılandırmasına karşılık gelir. Açıkça yapılandırılması amaçlanmamıştır.
WEBSITE_AUTH_ENABLED Yalnızca okunabilir App Service kimlik doğrulamasının etkinleştirilip etkinleştirilmediğini göstermek için bir Windows veya Linux uygulamasına eklenir.
WEBSITE_AUTH_ENCRYPTION_KEY Varsayılan olarak, otomatik olarak oluşturulan anahtar şifreleme anahtarı olarak kullanılır. Geçersiz kılmak için istenen tuşa ayarlayın. Belirteçleri veya oturumları birden çok uygulamada paylaşmak istiyorsanız bu ortam değişkenini öneririz. Belirtirseniz, bu, MACHINEKEY_DecryptionKey ayarının yerini alır.
WEBSITE_AUTH_SIGNING_KEY Varsayılan olarak, otomatik olarak oluşturulan anahtar imzalama anahtarı olarak kullanılır. Geçersiz kılmak için istenen tuşa ayarlayın. Belirteçleri veya oturumları birden çok uygulamada paylaşmak istiyorsanız bu ortam değişkenini öneririz. Belirtirseniz, bu, MACHINEKEY_ValidationKey ayarının yerini alır.
WEBSITE_AUTH_PRM_DEFAULT_WITH_SCOPES Uygulamanın ihtiyaç duyduğu kapsamların virgülle ayrılmış listesi. Bu değişken ayarlandığında, belirtilen kapsamların desteklendiğini bildiren bir varsayılan korumalı kaynak meta veri belgesi yapılandırılır. Kapsamlar, uygulama tarafından döndürülen kimlik doğrulama zorluklarına da dahildir.

Yönetilen kimlik

Aşağıdaki ortam değişkenleri yönetilen kimliklerle ilgilidir.

Ayar adı Açıklama
IDENTITY_ENDPOINT Yalnızca okunabilir Uygulamanın yönetilen kimliği için belirtecin alınacağı URL.
MSI_ENDPOINT Kullanımdan kaldırıldı. IDENTITY_ENDPOINT adresini kullanın.
IDENTITY_HEADER Yalnızca okunabilir HTTP GET isteğinde bulunduğunuzda X-IDENTITY-HEADER üst bilgisine eklenmesi gereken IDENTITY_ENDPOINT değer. Platform değeri döndürür.
MSI_SECRET Kullanımdan kaldırıldı. IDENTITY_HEADER adresini kullanın.

Durum denetimi

Aşağıdaki ortam değişkenleri sistem durumu denetimleriyle ilgilidir.

Ayar adı Açıklama
WEBSITE_HEALTHCHECK_MAXPINGFAILURES Örneği kaldırmadan önce en fazla başarısız ping sayısı. ile 2arasında 10 bir değere ayarlayın. Ölçeği genişletirken veya genişletirken App Service, yeni örneklerin hazır olduğundan emin olmak için sistem durumu denetiminin yoluna ping atar. Daha fazla bilgi için bkz . Sistem durumu denetimi.
WEBSITE_HEALTHCHECK_MAXUNHEALTHYWORKERPERCENT Aşırı iyi durumdaki örnekleri önlemek için örneklerin yarısından fazlası dışlanmaz. Örneğin, bir App Service planı dört örneğe ölçeklendirilirse ve üç örnek iyi durumda değilse, en çok ikisi hariç tutulur. Diğer iki örnek (biri sağlıklı, diğeri sağlıksız) istek almaya devam ederler. Tüm örneklerin sağlıksız olduğu en kötü senaryoda, hiçbiri hariç tutulmaz.

Bu davranışı geçersiz kılmak için ile 1arasında 100 bir değere ayarlayın. Daha yüksek bir değer, daha iyi durumda olmayan örneklerin kaldırıldığı anlamına gelir. Varsayılan değer 50 (%50).

Anında iletme bildirimleri

Aşağıdaki ortam değişkenleri anında iletme bildirimleri özelliğiyle ilgilidir.

Ayar adı Açıklama
WEBSITE_PUSH_ENABLED Yalnızca okunabilir Anında iletme bildirimleri etkinleştirildiğinde eklenir.
WEBSITE_PUSH_TAG_WHITELIST Yalnızca okunabilir Bildirim kaydındaki etiketleri içerir.
WEBSITE_PUSH_TAGS_REQUIRING_AUTH Yalnızca okunabilir Bildirim kaydında kullanıcı kimlik doğrulaması gerektiren etiketlerin listesini içerir.
WEBSITE_PUSH_TAGS_DYNAMIC Yalnızca okunabilir Bildirim kaydında otomatik olarak eklenen etiketlerin listesini içerir.

Not

Yukarıdaki tablo, Microsoft'un artık kullanmadığını ifade eden beyaz listeye başvurur. Terim yazılımdan kaldırıldığında, bu makaleden kaldırırız.

Web İşleri

Aşağıdaki ortam değişkenleri Web İşleri ile ilgilidir.

Ayar adı Açıklama
WEBJOBS_RESTART_TIME Sürekli işler için, bir işin işlemi herhangi bir nedenle devre dışı bırakıldığında ve yeniden başlatılmadan önceki gecikme süresi saniyeler cinsindendir.
WEBJOBS_IDLE_TIMEOUT Tetiklenen işler için zaman aşımı süresi (saniye cinsinden). Bu zaman aşımından sonra, iş atıl durumdaysa, CPU süresi yoksa veya çıkış üretmiyorsa durdurulur.
WEBJOBS_HISTORY_SIZE Tetiklenen işler için, iş başına geçmiş dizininde tutulan en fazla çalıştırma sayısı. Varsayılan değer: 50.
WEBJOBS_STOPPED 1 ayarını, herhangi bir işin çalışmasını devre dışı bırakmak ve halihazırda çalışan tüm işleri durdurmak için yapın.
WEBJOBS_DISABLE_SCHEDULE Tüm zamanlanmış tetikleyicileri kapatmak için 1 olarak ayarlayın. İşler yine de el ile çağrılabilir.
WEBJOBS_ROOT_PATH Web İşi dosyalarının mutlak veya göreli yolu. Göreli yol için, değer varsayılan kök yol (D:/home/site/wwwroot/ veya /home/site/wwwroot/) ile birleştirilir.
WEBJOBS_LOG_TRIGGERED_JOBS_TO_APP_LOGS true değerini, tetiklenen Web İşleri çıktısını (dosya sistemlerini, blobları ve tabloları destekleyen) uygulama günlükleri işlem hattına göndermek için ayarlayın.
WEBJOBS_SHUTDOWN_FILE App Service'in kapatma isteği algılandığında oluşturduğu dosya. Bu dosyanın varlığını algılamak ve kapatma işlemini başlatmak WebJob sürecinin sorumluluğundadır. Web İşleri SDK'sını kullandığınızda, bu bölüm otomatik olarak işlenir.
WEBJOBS_PATH Yalnızca okunabilir Şu anda çalışan işin kök yolu, geçici bir dizin altında.
WEBJOBS_NAME Yalnızca okunabilir Geçerli iş adı.
WEBJOBS_TYPE Yalnızca okunabilir Geçerli iş türü (triggered veya continuous).
WEBJOBS_DATA_PATH Yalnızca okunabilir Geçerli işin günlüklerini, geçmişini ve eserlerini/artifaktlarını içeren meta veri dizini.
WEBJOBS_RUN_ID Yalnızca okunabilir Tetiklenen işler için işin geçerli çalışma kimliği.

İşlevler

Ayar adı Açıklama
WEBSITE_FUNCTIONS_ARMCACHE_ENABLED 0 İşlev önbelleğini devre dışı bırakmak için olarak ayarlayın.
WEBSITE_MAX_DYNAMIC_APPLICATION_SCALE_OUT Bkz. Azure İşlevleri için uygulama ayarları başvurusu.
AzureWebJobsSecretStorageType Bkz. Azure İşlevleri için uygulama ayarları başvurusu.
FUNCTIONS_EXTENSION_VERSION Bkz. Azure İşlevleri için uygulama ayarları başvurusu.
FUNCTIONS_WORKER_RUNTIME Bkz. Azure İşlevleri için uygulama ayarları başvurusu.
AzureWebJobsStorage Bkz. Azure İşlevleri için uygulama ayarları başvurusu.
WEBSITE_CONTENTAZUREFILECONNECTIONSTRING Bkz. Azure İşlevleri için uygulama ayarları başvurusu.
WEBSITE_CONTENTSHARE Bkz. Azure İşlevleri için uygulama ayarları başvurusu.
WEBSITE_CONTENTOVERVNET Bkz. Azure İşlevleri için uygulama ayarları başvurusu.
WEBSITE_ENABLE_BROTLI_ENCODING Bkz. Azure İşlevleri için uygulama ayarları başvurusu.
WEBSITE_USE_PLACEHOLDER Bkz. Azure İşlevleri için uygulama ayarları başvurusu.
WEBSITE_PLACEHOLDER_MODE Yalnızca okunabilir İşlev uygulamasının bir yer tutucu konakta mı () yoksa kendi ana bilgisayarında mı (generalizedspecialized) çalıştığını gösterir.
WEBSITE_DISABLE_ZIP_CACHE Uygulamanız bir ZIP paketinden ( WEBSITE_RUN_FROM_PACKAGE=1) çalıştırıldığında, en son dağıtılan beş ZIP paketi uygulamanın dosya sisteminde (D:\home\data\SitePackages ) önbelleğe alınır. Bu önbelleği devre dışı bırakmak için bu değişkeni olarak 1 ayarlayın. Linux tüketim uygulamaları için ZIP paketi önbelleği varsayılan olarak devre dışı bırakılır.
  • Last updated on