Azure App Service の環境変数とアプリ設定
Note
2024 年 6 月 1 日より、新しく作成されたすべての App Service アプリには、名前付け規則 <app-name>-<random-hash>.<region>.azurewebsites.net
を使用して一意の既定のホスト名を生成するオプションが備わります。 既存のアプリ名は変更されません。
例: myapp-ds27dh7271aah175.westus-01.azurewebsites.net
詳細については、App Service リソースの一意の既定のホスト名に関するページを参照してください。
Azure App Service では、特定の設定をデプロイまたはランタイム環境で環境変数として使用できます。 これらの設定の一部は、アプリ設定として手動で設定するときにカスタマイズできます。 このリファレンスでは、使用またはカスタマイズできる変数を示します。
アプリ環境
次の環境変数は、一般的なアプリ環境に関連しています。
設定名 | 説明 | 例 |
---|---|---|
WEBSITE_SITE_NAME |
読み取り専用です。 [アプリ名]: | |
WEBSITE_RESOURCE_GROUP |
読み取り専用です。 アプリ リソースを含む Azure リソース グループの名前。 | |
WEBSITE_OWNER_NAME |
読み取り専用です。 アプリ、リソース グループ、Web スペースを所有する Azure サブスクリプション ID が含まれています。 | |
REGION_NAME |
読み取り専用です。 アプリのリージョン名。 | |
WEBSITE_PLATFORM_VERSION |
読み取り専用です。 App Service プラットフォームのバージョン。 | |
HOME |
読み取り専用です。 ホーム ディレクトリへのパス (たとえば、Windows では D:\home )。 |
|
SERVER_PORT |
読み取り専用です。 アプリでリッスンされるポート。 | |
WEBSITE_WARMUP_PATH |
アプリをウォームアップするために ping を実行する相対パス (スラッシュで始まる)。 既定値は / で、ルート パスに ping を実行します。 認証されていないクライアントを拒否するように App Service 認証が設定されている場合でも、認証されていないクライアント (Azure Traffic Manager など) でこの特定のパスに ping を実行できます。 (注: このアプリ設定では、Always On で使用されるパスは変更されません。) |
|
WEBSITE_COMPUTE_MODE |
読み取り専用です。 アプリが専用 (Dedicated ) と共有 (Shared ) のどちらの VM で実行されるかを指定します。 |
|
WEBSITE_SKU |
読み取り専用です。 アプリの SKU。 指定できる値は、Free 、Shared 、Basic 、および Standard です。 |
|
SITE_BITNESS |
読み取り専用です。 アプリが 32 ビット (x86 ) と 64 ビット (AMD64 ) のどちらであるかを示します。 |
|
WEBSITE_HOSTNAME |
読み取り専用です。 アプリのプライマリ ホスト名。 ここでは、カスタム ホスト名は考慮されません。 | |
WEBSITE_VOLUME_TYPE |
読み取り専用です。 現在使用中のストレージ ボリュームの種類を示します。 | |
WEBSITE_NPM_DEFAULT_VERSION |
アプリが使用している既定の NPM バージョン。 | |
WEBSOCKET_CONCURRENT_REQUEST_LIMIT |
読み取り専用です。 WebSocket の同時要求数の制限。 Standard レベル以上では、この値は -1 ですが、VM のサイズに応じて VM あたりの制限があります (VM 間数値制限に関する記事をご覧ください)。 |
|
WEBSITE_PRIVATE_EXTENSIONS |
プライベート サイト拡張機能の使用を無効にするには、0 に設定します。 |
|
WEBSITE_TIME_ZONE |
既定では、アプリのタイム ゾーンは常に UTC です。 デフォルトの TimeZone に記載されている有効な値のいずれかに変更できます。 指定した値が認識されない場合は、UTC が使用されます。 | Atlantic Standard Time |
WEBSITE_ADD_SITENAME_BINDINGS_IN_APPHOST_CONFIG |
スロットをスワップした後、アプリが予期せず再起動する可能性があります。 これは、スワップ後にホスト名のバインド構成の同期が切れ、単体では再起動を行うことができないためです。 ただし、基盤となる特定のストレージ イベント (記憶域ボリュームのフェールオーバーなど) によってこれらの不一致が検出され、すべてのワーカー プロセスが強制的に再起動される可能性があります。 このような再起動を最小限に抑えるには、すべてのスロットでアプリ設定値を 1 に設定します (既定値は 0 です)。 ただし、Windows Communication Foundation (WCF) アプリを実行している場合は、この値を設定しないでください。 詳細については、「スワップのトラブルシューティングを行う」を参照してください。 |
|
WEBSITE_PROACTIVE_AUTOHEAL_ENABLED |
既定では、VM インスタンスは、割り当てられたメモリの 90% を 30 秒以上使用している場合、または過去 2 分間の全要求の 80% で実行時間が 200 秒を超えている場合に、プロアクティブに「自動修復」されます。 VM インスタンスによってこれらのルールのいずれかがトリガーされた場合、復旧プロセスはインスタンスの重複した再起動になります。 この回復動作を無効にするには、false に設定します。 既定値は、true です。 詳細については、プロアクティブな自動修復に関する記事をご覧ください。 |
|
WEBSITE_PROACTIVE_CRASHMONITORING_ENABLED |
ハンドルされない例外が 24 時間以内に 4 回以上発生したために、アプリの VM インスタンスの w3wp.exe プロセスがクラッシュすると、そのインスタンスのメイン ワーカー プロセスにデバッガー プロセスがアタッチされ、ワーカー プロセスが再びクラッシュしたときにメモリ ダンプが収集されます。 その後、このメモリ ダンプが分析され、クラッシュの原因となったスレッドの呼び出し履歴が App Service のログに記録されます。 この自動監視動作を無効にするには、false に設定します。 既定値は、true です。 詳細については、プロアクティブなクラッシュの監視に関する記事をご覧ください。 |
|
WEBSITE_DAAS_STORAGE_SASURI |
(プロアクティブまたは手動の) クラッシュの監視では、メモリ ダンプは既定で削除されます。 メモリ ダンプをストレージ BLOB コンテナーに保存するには、SAS URI を指定します。 | |
WEBSITE_CRASHMONITORING_ENABLED |
手動でクラッシュの監視を有効にするには、true に設定します。 WEBSITE_DAAS_STORAGE_SASURI と WEBSITE_CRASHMONITORING_SETTINGS も設定する必要があります。 既定値は、false です。 リモート デバッグが有効になっている場合、この設定は無効です。 また、この設定が true に設定されている場合、プロアクティブなクラッシュの監視は無効になります。 |
|
WEBSITE_CRASHMONITORING_SETTINGS |
次の形式の JSON: {"StartTimeUtc": "2020-02-10T08:21","MaxHours": "<elapsed-hours-from-StartTimeUtc>","MaxDumpCount": "<max-number-of-crash-dumps>"} 。 WEBSITE_CRASHMONITORING_ENABLED が指定されている場合に、クラッシュの監視を構成するために必要です。 ストレージ アカウントにクラッシュ ダンプを保存せずに呼び出し履歴のみをログに記録するには、JSON に ,"UseStorageAccount":"false" を追加します。 |
|
REMOTEDEBUGGINGVERSION |
リモート デバッグ バージョン。 | |
WEBSITE_CONTENTAZUREFILECONNECTIONSTRING |
既定では、アプリの作成時に App Service によって共有ストレージが作成されます。 代わりにカスタム ストレージ アカウントを使用するには、ストレージ アカウントの接続文字列に設定します。 関数については、Functions のアプリ設定のリファレンスをご覧ください。 | DefaultEndpointsProtocol=https;AccountName=<name>;AccountKey=<key> |
WEBSITE_CONTENTSHARE |
WEBSITE_CONTENTAZUREFILECONNECTIONSTRING でカスタム ストレージ アカウントを指定する場合は、App Service によってアプリのそのストレージ アカウントにファイル共有が作成されます。 カスタム名を使用するには、この変数に使用する名前を設定します。 指定した名前を持つファイル共有が存在しない場合は、App Service によって作成されます。 |
myapp123 |
WEBSITE_SCM_ALWAYS_ON_ENABLED |
読み取り専用です。 Always On が有効 (1 ) か無効 (0 ) かを示します。 |
|
WEBSITE_SCM_SEPARATE_STATUS |
読み取り専用です。 Kudu アプリが別のプロセスで実行されている (1 ) かいない (0 ) かを示します。 |
|
WEBSITE_DNS_ATTEMPTS |
名前解決を試行する回数。 | |
WEBSITE_DNS_TIMEOUT |
名前解決を待機する秒数 |
変数プレフィックス
次の表に、App Service でさまざまな目的に使用される環境変数のプレフィックスを示します。
設定名 | 説明 |
---|---|
APPSETTING_ |
変数が顧客によってアプリ構成のアプリ設定として設定されることを示します。 これは、アプリ設定として .NET アプリに挿入されます。 |
MAINSITE_ |
変数がアプリ自体に固有であることを示します。 |
SCMSITE_ |
変数が Kudu アプリに固有であることを示します。 |
SQLCONNSTR_ |
アプリ構成内の SQL Server 接続文字列を示します。 これは、接続文字列として .NET アプリに挿入されます。 |
SQLAZURECONNSTR_ |
アプリ構成の Azure SQL Database 接続文字列を示します。 これは、接続文字列として .NET アプリに挿入されます。 |
POSTGRESQLCONNSTR_ |
アプリ構成の PostgreSQL 接続文字列を示します。 これは、接続文字列として .NET アプリに挿入されます。 |
CUSTOMCONNSTR_ |
アプリ構成のカスタム接続文字列を示します。 これは、接続文字列として .NET アプリに挿入されます。 |
MYSQLCONNSTR_ |
アプリ構成の MySQL Database 接続文字列を示します。 これは、接続文字列として .NET アプリに挿入されます。 |
AZUREFILESSTORAGE_ |
Azure Files でのカスタム コンテナー用のカスタム共有への接続文字列。 |
AZUREBLOBSTORAGE_ |
Azure Blob Storage でのカスタム コンテナー用のカスタム ストレージ アカウントへの接続文字列。 |
NOTIFICATIONHUBCONNSTR_ |
Azure Notification Hubs の通知ハブへの接続文字列を示します。 |
SERVICEBUSCONNSTR_ |
Azure Service Bus のインスタンスへの接続文字列を示します。 |
EVENTHUBCONNSTR_ |
Azure Event Hubs のイベント ハブへの接続文字列を示します。 |
DOCDBCONNSTR_ |
Azure Cosmos DB のデータベースへの接続文字列を示します。 |
REDISCACHECONNSTR_ |
Azure Cache for Redis のキャッシュへの接続文字列を示します。 |
FILESHARESTORAGE_ |
カスタム ファイル共有への接続文字列を示します。 |
デプロイ
次の環境変数は、アプリのデプロイに関連しています。 App Service のビルド オートメーションに関連する変数については、「ビルド オートメーション」を参照してください。
設定名 | 説明 |
---|---|
DEPLOYMENT_BRANCH |
ローカル Git またはクラウド Git デプロイ (GitHub など) の場合は、Azure 内のデプロイするブランチに設定します。 既定では、これは master です。 |
WEBSITE_RUN_FROM_PACKAGE |
ローカル ZIP パッケージからアプリを実行するには、1 に設定します。リモート ZIP パッケージからアプリを実行するには、外部 URL の URL に設定します。 詳細については、「ZIP パッケージから Azure App Service のアプリを直接実行する」を参照してください。 |
WEBSITE_USE_ZIP |
非推奨になりました。 WEBSITE_RUN_FROM_PACKAGE を使用してください。 |
WEBSITE_RUN_FROM_ZIP |
非推奨になりました。 WEBSITE_RUN_FROM_PACKAGE を使用してください。 |
SCM_MAX_ZIP_PACKAGE_COUNT |
アプリは、ZIP デプロイを使ってデプロイされた最新の 5 つの ZIP ファイルを保持します。 アプリの設定を別の値に設定することで、保持する数を増やしたり減らしたりできます。 |
WEBSITE_WEBDEPLOY_USE_SCM |
WebDeploy で Kudu デプロイ エンジンの使用を停止するには、false に設定します。 既定値は、true です。 Visual Studio (WebDeploy/MSDeploy) を使用して Linux アプリにデプロイするには、false に設定します。 |
MSDEPLOY_RENAME_LOCKED_FILES |
WebDeploy デプロイで DLL をコピーできない場合に名前の変更を試行するには、1 に設定します。 WEBSITE_WEBDEPLOY_USE_SCM が false に設定されている場合、この設定は適用されません。 |
WEBSITE_DISABLE_SCM_SEPARATION |
既定では、メイン アプリと Kudu アプリは異なるサンドボックスで実行されます。 アプリを停止すると、Kudu アプリは引き続き実行され、Git デプロイと MSDeploy を使用し続けることができます。 各アプリには固有のローカル ファイルがあります。 この分離をオフにする設定 (true ) は、完全にはサポートされなくなったレガシ モードです。 |
WEBSITE_ENABLE_SYNC_UPDATE_SITE |
1 に設定すると、site と siteconfig を更新する REST API 呼び出しが、すべてのインスタンスに完全に適用されてから戻るようになります。 ARM テンプレートを使用してデプロイする場合、後続の ARM 呼び出しでの競争状態を回避するため、既定値は 1 です。 |
WEBSITE_START_SCM_ON_SITE_CREATION |
ARM テンプレートのデプロイで、アプリの作成の一環として Kudu アプリを事前に開始するには、ARM テンプレートで 1 に設定します。 |
WEBSITE_START_SCM_WITH_PRELOAD |
Linux アプリの場合、Always On を有効にするときに URL に ping を実行して Kudu アプリを強制的にプリロードするには、true に設定します。 既定値は、false です。 Windows アプリの場合、Kudu アプリは常にプリロードされます。 |
ビルド オートメーション
Kudu ビルド構成は、ネイティブ Windows アプリに適用され、Git ベース (または ZIP ベース) のデプロイの動作を制御するために使用されます。
設定名 | 説明 | 例 |
---|---|---|
SCM_BUILD_ARGS |
msbuild コマンド ラインの最後に、既定のコマンド ラインの直前の部分をオーバーライドする要素を追加します。 | クリーン ビルドを実行するには: -t:Clean;Compile |
SCM_SCRIPT_GENERATOR_ARGS |
Kudu では、こちらで説明されている azure site deploymentscript コマンドを使用してデプロイ スクリプトが生成されます。 言語フレームワークの型が自動的に検出され、コマンドに渡すパラメーターが決定されます。 この設定は、自動的に生成されるパラメーターをオーバーライドします。 |
リポジトリをプレーン コンテンツ ファイルとして扱うには: --basic -p <folder-to-deploy> |
SCM_TRACE_LEVEL |
ビルドのトレース レベル。 既定値は、1 です。 より多くのトレースを行う場合は、大きい値 (最大 4) に設定します。 |
4 |
SCM_COMMAND_IDLE_TIMEOUT |
ビルド プロセスによって起動される各コマンドが出力を生成するまでに待機するタイムアウト (秒)。 その後、コマンドはアイドル状態と見なされ、強制終了されます。 既定値は 60 (1 分) です。 Azure では、230 秒後にクライアントを切断する一般的なアイドル要求タイムアウトも発生します。 ただし、サーバー側ではその後もコマンドの実行が継続されます。 |
|
SCM_LOGSTREAM_TIMEOUT |
ログ ストリーミングを停止するまでの非アクティブ状態のタイムアウト (秒)。 既定値は 1800 (30 分) です。 |
|
SCM_SITEEXTENSIONS_FEED_URL |
サイト拡張機能ギャラリーの URL。 既定値は、https://www.nuget.org/api/v2/ です。 以前のフィードの URL は http://www.siteextensions.net/api/v2/ です。 |
|
SCM_USE_LIBGIT2SHARP_REPOSITORY |
Git 操作に libgit2sharp ではなく git.exe を使用するには、0 に設定します。 |
|
WEBSITE_LOAD_USER_PROFILE |
ASP.NET のビルド オートメーション (Git デプロイなど) でエラー The specified user does not have a valid profile. が発生した場合は、この変数を 1 に設定して、ビルド環境に完全なユーザー プロファイルを読み込みます。 この設定は WEBSITE_COMPUTE_MODE が Dedicated の場合にのみ適用されます。 |
|
WEBSITE_SCM_IDLE_TIMEOUT_IN_MINUTES |
SCM (Kudu) サイトのタイムアウト (分)。 既定値は、20 です。 |
|
SCM_DO_BUILD_DURING_DEPLOYMENT |
ZIP デプロイのデプロイ エンジンでは、ZIP ファイルがそのまま実行できる状態であり、ビルド オートメーションは実行されないことが想定されています。 Git デプロイと同じビルド オートメーションを有効にするには、true に設定します。 |
言語固有の設定
このセクションでは、サポートされている各言語フレームワークの構成可能なランタイム設定を示します。 デプロイ時のビルド オートメーションで、追加設定を使用できます。
設定名 | 説明 |
---|---|
PORT |
読み取り専用です。 Linux アプリの場合、.NET ランタイムがコンテナー内でリッスンするポート。 |
WEBSITE_ROLE_INSTANCE_ID |
読み取り専用です。 現在のインスタンスの ID。 |
HOME |
読み取り専用です。 共有ストレージを参照するディレクトリ (/home )。 |
DUMP_DIR |
読み取り専用です。 クラッシュ ダンプのディレクトリ (/home/logs/dumps )。 |
APP_SVC_RUN_FROM_COPY |
Linux アプリのみ。 既定では、アプリはすべてのスケールアウトされたインスタンスの共有ディレクトリである /home/site/wwwroot から実行されます。 アプリをコンテナー内のローカル ディレクトリにコピーし、そこから実行するには、この変数を true に設定します。 このオプションを使用する場合は、/home/site/wwwroot への参照をハードコーディングしないようにしてください。 代わりに、/home/site/wwwroot からの相対パスを使用します。 |
MACHINEKEY_Decryption |
Windows ネイティブ アプリまたは Windows コンテナー化アプリの場合、ASP.NET の暗号化ルーチンを有効にするためにこの変数がアプリの環境またはコンテナーに挿入されます (「machineKey 要素」を参照してください)。 既定の decryption 値をオーバーライドするには、App Service アプリの設定として構成するか、Web.config ファイルの machineKey 要素に直接設定します。 |
MACHINEKEY_DecryptionKey |
Windows ネイティブ アプリまたは Windows コンテナー化アプリの場合、ASP.NET の暗号化ルーチンを有効にするためにこの変数がアプリの環境またはコンテナーに挿入されます (「machineKey 要素」を参照してください)。 自動生成された decryptionKey 値をオーバーライドするには、App Service アプリの設定として構成するか、Web.config ファイルの machineKey 要素に直接設定します。 |
MACHINEKEY_Validation |
Windows ネイティブ アプリまたは Windows コンテナー化アプリの場合、ASP.NET の暗号化ルーチンを有効にするためにこの変数がアプリの環境またはコンテナーに挿入されます (「machineKey 要素」を参照してください)。 既定の validation 値をオーバーライドするには、App Service アプリの設定として構成するか、Web.config ファイルの machineKey 要素に直接設定します。 |
MACHINEKEY_ValidationKey |
Windows ネイティブ アプリまたは Windows コンテナー化アプリの場合、ASP.NET の暗号化ルーチンを有効にするためにこの変数がアプリの環境またはコンテナーに挿入されます (「machineKey 要素」を参照してください)。 自動生成された validationKey 値をオーバーライドするには、App Service アプリの設定として構成するか、Web.config ファイルの machineKey 要素に直接設定します。 |
WordPress
アプリケーション設定 | Scope | 値 | Max | 説明 |
---|---|---|---|---|
WEBSITES_ENABLE_APP_SERVICE_STORAGE |
Web アプリ | TRUE | - | TRUE に設定すると、ファイルの内容は再起動時に保持されます。 |
WP_MEMORY_LIMIT |
WordPress | 128 M | 512 M | フロントエンドまたは一般的な wordpress PHP メモリ制限 (スクリプトあたり)。 PHP_MEMORY_LIMIT を超えることはできません |
WP_MAX_MEMORY_LIMIT |
WordPress | 256M | 512 M | 管理者ダッシュボードの PHP メモリ制限 (スクリプトあたり)。 一般に、管理ダッシュボード/バックエンドのスクリプトは、フロントエンドのスクリプトと比較して多くのメモリを必要とします。 PHP_MEMORY_LIMIT を超えることはできません。 |
PHP_MEMORY_LIMIT |
PHP | 512 M | 512 M | 一般的な PHP スクリプトのメモリ制限。 減らされた場合のみ可能です。 |
FILE_UPLOADS |
PHP | オン | - | On と Off のいずれかになります。 値は、大文字と小文字が区別されます。 ファイルのアップロードを有効または無効にします。 |
UPLOAD_MAX_FILESIZE |
PHP | 50 MB | 256M (ファイル アップロードの最大サイズ) 256M まで増やすことができます。 | |
POST_MAX_SIZE |
PHP | 128 M | 256M | 256M まで増やすことができます。 一般に、 UPLOAD_MAX_FILESIZE を越える必要があります。 |
MAX_EXECUTION_TIME |
PHP | 120 | 120 | 減らされた場合のみ可能です。 120 秒以上かかっている場合は、スクリプトを分解してください。 悪いスクリプトがシステムの速度を低下させるのを回避するために追加されました。 |
MAX_INPUT_TIME |
PHP | 120 | 120 | 入力された要求を解析するための最大制限時間。 減らされた場合のみ可能です。 |
MAX_INPUT_VARS |
PHP | 10000 | 10000 | - |
DATABASE_HOST |
データベース | - | - | WordPress への接続に使用されるデータベース ホスト。 |
DATABASE_NAME |
データベース | - | - | WordPress への接続に使用されるデータベース名。 |
DATABASE_USERNAME |
データベース | - | - | WordPress への接続に使用されるデータベース ユーザー名。 |
DATABASE_PASSWORD |
データベース | - | - | MySQL データベースへの接続に使用されるデータベース パスワード。 MySQL データベースのパスワードを変更するには、「管理パスワードの更新」を参照してください。 MySQL データベースのパスワードが変更されるたびに、アプリケーション設定も更新する必要があります。 |
WORDPRESS_ADMIN_EMAIL |
デプロイのみ | - | - | WordPress 管理者のメール アドレス。 |
WORDPRESS_ADMIN_PASSWORD |
デプロイのみ | - | - | WordPress 管理者のパスワード。 これは、デプロイのみを目的としています。 この値を変更しても、WordPress のインストールには影響しません。 WordPress 管理者のパスワードを変更するには、「Resetting your password (パスワードのリセット)」を参照してください。 |
WORDPRESS_ADMIN_USER |
デプロイのみ | - | - | WordPress 管理者のユーザー名 |
WORDPRESS_ADMIN_LOCALE_CODE |
デプロイのみ | - | - | WordPress への接続に使用されるデータベース ユーザー名。 |
ドメインと DNS
設定名 | 説明 | 例 |
---|---|---|
WEBSITE_DNS_SERVER |
(バックエンド サービスなどへの) 送信接続用のプライマリ DNS サーバーの IP アドレス。 App Service の既定の DNS サーバーは Azure DNS で、その IP アドレスは 168.63.129.16 です。 アプリで VNet 統合が使用されているか、アプリが App Service 環境内にある場合、既定では VNet から DNS サーバー構成が継承されます。 |
10.0.0.1 |
WEBSITE_DNS_ALT_SERVER |
発信接続の代替 DNS サーバーの IP アドレス。 「WEBSITE_DNS_SERVER 」を参照してください。 |
|
WEBSITE_ENABLE_DNS_CACHE |
成功した DNS の解決をキャッシュできるようにします。 既定では、有効期限切れの DNS キャッシュ エントリがフラッシュされ、既存のキャッシュに加えて 4.5 分ごとにフラッシュされます。 |
TLS/SSL
詳細については、「Azure App Service の自分のコードから TLS/SSL 証明書を使用する」を参照してください。
設定名 | 説明 |
---|---|
WEBSITE_LOAD_CERTIFICATES |
コードに読み込む証明書の拇印のコンマ区切り値。すべての証明書をコードに読み込むことができるようにする場合は、* 。 アプリに追加された証明書のみを読み込むことができます。 |
WEBSITE_PRIVATE_CERTS_PATH |
読み取り専用です。 Windows コンテナー内の、読み込まれたプライベート証明書へのパス。 |
WEBSITE_PUBLIC_CERTS_PATH |
読み取り専用です。 Windows コンテナー内の、読み込まれた公開証明書へのパス。 |
WEBSITE_INTERMEDIATE_CERTS_PATH |
読み取り専用です。 Windows コンテナー内の、読み込まれた中間証明書へのパス。 |
WEBSITE_ROOT_CERTS_PATH |
読み取り専用です。 Windows コンテナー内の、読み込まれたルート証明書へのパス。 |
デプロイ スロット
デプロイ スロットの詳細については、「Azure App Service でステージング環境を設定する」を参照してください。
設定名 | 説明 | 例 |
---|---|---|
WEBSITE_OVERRIDE_STICKY_EXTENSION_VERSIONS |
既定では、サイト拡張機能のバージョンは各スロットに固有です。 これにより、スワップ後に拡張機能のバージョンが変更されるために発生する予期しないアプリケーション動作を防ぐことができます。 拡張機能のバージョンもスワップする場合は、"すべてのスロット" で 0 に設定します。 |
|
WEBSITE_OVERRIDE_PRESERVE_DEFAULT_STICKY_SLOT_SETTINGS |
特定の設定を、既定で固定またはスワップ不可能として指定します。 既定値は true です。 代わりに "すべてのデプロイ スロット" をスワップ可能にするには、それらに対してこの設定を false または 0 に設定します。 特定の設定の種類を細かく制御することはできません。 |
|
WEBSITE_SWAP_WARMUP_PING_PATH |
ターゲット スロットをウォームアップするために ping を実行するパス (スラッシュで始まる)。 既定値は / で、HTTP 経由でルート パスに ping を実行します。 |
/statuscheck |
WEBSITE_SWAP_WARMUP_PING_STATUSES |
スワップ中のウォームアップ操作の有効な HTTP 応答コード。 返された状態コードが一覧にない場合、ウォームアップとスワップの操作が停止されます。 既定で、すべての応答コードは有効です。 | 200,202 |
WEBSITE_SLOT_NUMBER_OF_TIMEOUTS_BEFORE_RESTART |
スロット スワップ中に特定の VM インスタンス上のサイトを強制的に再起動するまでのタイムアウトの最大回数。 既定値は、3 です。 |
|
WEBSITE_SLOT_MAX_NUMBER_OF_TIMEOUTS |
スロット スワップ中に 1 つの URL に対するタイムアウト要求を中止するまでの最大回数。 既定値は、5 です。 |
|
WEBSITE_SKIP_ALL_BINDINGS_IN_APPHOST_CONFIG |
applicationHost.config 内のすべてのバインドをスキップするには、true または 1 に設定します。 既定値は、false です。 applicationHost.config がスロットのスワップされたホスト名で更新されるためにアプリの再起動がトリガーされる場合は、このような再起動を回避するため、この変数を true に設定します。 Windows Communication Foundation (WCF) アプリを実行している場合は、この変数を設定しないでください。 |
カスタム コンテナー
カスタム コンテナーの詳細については、「Azure でカスタム コンテナーを実行する」を参照してください。
設定名 | 説明 | 例 |
---|---|---|
WEBSITES_ENABLE_APP_SERVICE_STORAGE |
Linux カスタム コンテナーの場合: スケールされたインスタンス間で /home ディレクトリを共有できるように true に設定。 Linux カスタム コンテナーの既定値は false です。Windows コンテナーの場合: スケールされたインスタンス間で c:\home ディレクトリを共有できるように true に設定。 Windows コンテナーの既定値は true です。 |
|
WEBSITES_CONTAINER_START_TIME_LIMIT |
コンテナーを再起動する前に、コンテナーの起動が完了するまで待機する時間 (秒)。 既定値は 230 です。 最大 1800 まで増やすことができます。 |
|
WEBSITES_CONTAINER_STOP_TIME_LIMIT |
コンテナーが正常に終了するまでの待機時間 (秒単位)。 既定値は 5 です。 最大値の 120 まで増やすことができます。 |
|
DOCKER_REGISTRY_SERVER_URL |
App Service でカスタム コンテナーを実行する場合のレジストリ サーバーの URL。 セキュリティのため、この変数はコンテナーに渡されません。 | https://<server-name>.azurecr.io |
DOCKER_REGISTRY_SERVER_USERNAME |
DOCKER_REGISTRY_SERVER_URL のレジストリ サーバーで認証するためのユーザー名。 セキュリティのため、この変数はコンテナーに渡されません。 |
|
DOCKER_REGISTRY_SERVER_PASSWORD |
DOCKER_REGISTRY_SERVER_URL のレジストリ サーバーで認証するためのパスワード。 セキュリティのため、この変数はコンテナーに渡されません。 |
|
DOCKER_ENABLE_CI |
カスタム コンテナーの CD が可能になるように true に設定します。 カスタム コンテナーの場合、既定値は false です。 |
|
WEBSITE_PULL_IMAGE_OVER_VNET |
仮想ネットワーク内またはオンプレミスのレジストリに接続して、そこからプルします。 アプリは、VNet 統合機能を使用して Virtual Network に接続する必要があります。 この設定は、プライベート エンドポイントを使用する Azure Container Registry にも必要です。 | |
WEBSITES_WEB_CONTAINER_NAME |
Docker Compose アプリでは、インターネットにアクセスできるコンテナーは 1 つだけです。 既定のコンテナーの選択をオーバーライドするには、構成ファイルで定義されているコンテナーの名前に設定します。 インターネットにアクセスできるコンテナーは、既定ではポート 80 または 8080 を定義する最初のコンテナーです。このコンテナーが見つからない場合は、構成ファイルで定義されている最初のコンテナーです。 | |
WEBSITES_PORT |
カスタム コンテナーの場合、要求のルーティング先の App Service のコンテナーのカスタム ポート番号。 既定では、App Service でポート 80 および 8080 の自動ポート検出が試行されます。 この設定は、環境変数としてコンテナーに挿入されません。 | |
WEBSITE_CPU_CORES_LIMIT |
既定では、Windows コンテナーは、選択した価格レベルで使用できるすべてのコアで実行されます。 コア数を減らすには、必要なコア数の制限に設定します。 詳細については、「コンピューティング コアの数をカスタマイズする」を参照してください。 | |
WEBSITE_MEMORY_LIMIT_MB |
既定では、Azure App Service にデプロイされたすべての Windows コンテナーには、App Service プラン SKU に応じてメモリ制限が構成されています。 目的のメモリ制限 (MB) に設定します。 同じプラン内のアプリ間でこの設定を累計した値が、選択した価格レベルで許可されている量を超えないようにする必要があります。 詳細については、「コンテナー メモリをカスタマイズする」を参照してください。 |
スケーリング
設定名 | 説明 |
---|---|
WEBSITE_INSTANCE_ID |
読み取り専用です。 アプリが複数のインスタンスにスケールアウトされている場合の、現在の VM インスタンスの一意の ID。 |
WEBSITE_IIS_SITE_NAME |
非推奨になりました。 WEBSITE_INSTANCE_ID を使用してください。 |
WEBSITE_DISABLE_OVERLAPPED_RECYCLING |
重複したリサイクルにより、アプリの現在の VM インスタンスがシャットダウンされる前に、新しい VM インスタンスが開始されます。 場合によっては、ファイル ロックの問題が発生する可能性があります。 1 に設定して、これを無効にしてみることができます。 |
WEBSITE_DISABLE_CROSS_STAMP_SCALE |
既定では、アプリで Azure Files または Docker コンテナーを使用する場合、複数のスタンプにまたがってアプリをスケーリングできます。 アプリのリージョン内でスタンプ間スケーリングを無効にするには、1 または true に設定します。 既定値は、0 です。 WEBSITES_ENABLE_APP_SERVICE_STORAGE を true または 1 に設定するカスタム Docker コンテナーでは、コンテンツが Docker コンテナーに完全にカプセル化されていないため、スタンプ間スケーリングができません。 |
ログ記録
設定名 | 説明 | 例 |
---|---|---|
WEBSITE_HTTPLOGGING_ENABLED |
読み取り専用です。 Windows ネイティブ アプリに関する Web サーバー ログが有効 (1 ) か無効 (0 ) かを示します。 |
|
WEBSITE_HTTPLOGGING_RETENTION_DAYS |
Windows ネイティブまたは Linux アプリで Web サーバー ログが有効になっている場合の、Web サーバー ログの保持期間 (日数)。 | 10 |
WEBSITE_HTTPLOGGING_CONTAINER_URL |
Web サーバー ログが有効になっている場合、Windows ネイティブ アプリに関する Web サーバー ログを格納する BLOB ストレージ コンテナーの SAS URL。 設定されていない場合、Web サーバー ログはアプリのファイル システム (既定の共有ストレージ) に格納されます。 | |
DIAGNOSTICS_AZUREBLOBRETENTIONINDAYS |
アプリケーション ログが有効になっている場合、Windows ネイティブ アプリに関するアプリケーション ログの保有期間 (日数)。 | 10 |
DIAGNOSTICS_AZUREBLOBCONTAINERSASURL |
アプリケーション ログが有効になっている場合、Windows ネイティブ アプリに関するアプリケーション ログを格納する BLOB ストレージ コンテナーの SAS URL。 | |
APPSERVICEAPPLOGS_TRACE_LEVEL |
AppServiceAppLogs ログの種類について Log Analytics に送信される最小ログ レベル。 | |
DIAGNOSTICS_LASTRESORTFILE |
リスナーのトラブルシューティングに役立つ内部エラーをログに記録するために作成するファイル名、またはログ ディレクトリへの相対パス。 既定値は、logging-errors.txt です。 |
|
DIAGNOSTICS_LOGGINGSETTINGSFILE |
ログ設定ファイルの、D:\home または /home との相対パス。 既定値は、site\diagnostics\settings.json です。 |
|
DIAGNOSTICS_TEXTTRACELOGDIRECTORY |
アプリのルート (D:\home\site\wwwroot または /home/site/wwwroot ) を基準にしたログ フォルダー。 |
..\..\LogFiles\Application |
DIAGNOSTICS_TEXTTRACEMAXLOGFILESIZEBYTES |
ログ ファイルの最大サイズ (バイト)。 既定値は 131072 (128 KB) です。 |
|
DIAGNOSTICS_TEXTTRACEMAXLOGFOLDERSIZEBYTES |
ログ フォルダーの最大サイズ (バイト)。 既定値は 1048576 (1 MB) です。 |
|
DIAGNOSTICS_TEXTTRACEMAXNUMLOGFILES |
保持するログ ファイルの最大数。 既定値は、20 です。 |
|
DIAGNOSTICS_TEXTTRACETURNOFFPERIOD |
アプリケーション ログの有効な状態を維持するタイムアウト (ミリ秒)。 既定値は 43200000 (12 時間) です。 |
|
WEBSITE_LOG_BUFFERING |
既定では、ログ バッファーは有効になっています。 無効にするには、0 に設定します。 |
|
WEBSITE_ENABLE_PERF_MODE |
Windows ネイティブ アプリの場合、10 分以内に返された成功した要求の IIS ログ エントリをオフにするには、TRUE に設定します。 これは、拡張ログを削除することでパフォーマンス ベンチマークを行う簡単な方法です。 |
パフォーマンス カウンター
以下は、列挙しても存在しない「偽りの」環境変数ですが、個別に参照するとその値が返されます。 値は動的であり、参照のたびに変わる可能性があります。
設定名 | 説明 |
---|---|
WEBSITE_COUNTERS_ASPNET |
ASP.NET のパフォーマンス カウンターを含む JSON オブジェクト。 |
WEBSITE_COUNTERS_APP |
サンドボックスのカウンターを含む JSON オブジェクト。 |
WEBSITE_COUNTERS_CLR |
CLR のカウンターを含む JSON オブジェクト。 |
WEBSITE_COUNTERS_ALL |
他の 3 つの変数の組み合わせを含む JSON オブジェクト。 |
キャッシュ
設定名 | 説明 |
---|---|
WEBSITE_LOCAL_CACHE_OPTION |
ローカル キャッシュが有効かどうか。 使用できるオプションは次のとおりです。 - Default : スタンプレベルのグローバル設定を継承します。- Always : アプリで有効にします。- OnStorageUnavailability - Disabled : アプリで無効にします。 |
WEBSITE_LOCAL_CACHE_READWRITE_OPTION |
ローカル キャッシュの読み取り/書き込みオプション。 使用できるオプションは次のとおりです。 - ReadOnly : キャッシュは読み取り専用です。- WriteButDiscardChanges : ローカル キャッシュへの書き込みを許可しますが、ローカルで行われた変更は破棄します。 |
WEBSITE_LOCAL_CACHE_SIZEINMB |
ローカル キャッシュのサイズ (MB)。 既定値は 1000 (1 GB) です。 |
WEBSITE_LOCALCACHE_READY |
アプリでローカル キャッシュが使用されるかどうかを示す読み取り専用フラグ。 |
WEBSITE_DYNAMIC_CACHE |
複数インスタンスのアクセスを許可するネットワーク ファイルの共有の性質により、動的キャッシュでは、最近アクセスしたファイルをインスタンス上でローカルにキャッシュすることで、パフォーマンスが向上します。 ファイルが変更された場合、キャッシュは無効になります。 キャッシュの場所は %SYSTEMDRIVE%\local\DynamicCache です (同じ %SYSTEMDRIVE%\local クォータが適用されます)。 フル コンテンツ キャッシュを有効にするには、1 に設定します。ファイル コンテンツとディレクトリ/ファイル メタデータ (タイムスタンプ、サイズ、ディレクトリ コンテンツ) の両方が含まれます。 ローカル ディスクの使用量を節約するには、2 に設定して、ディレクトリ/ファイルのメタデータ (タイムスタンプ、サイズ、ディレクトリ コンテンツ) のみをキャッシュします。 キャッシュを無効にするには、0 に設定します。 Windows アプリと、WordPress テンプレートで作成された Linux アプリの場合、既定値は 1 です。 その他の Linux アプリでは、既定値は 0 です。 |
WEBSITE_READONLY_APP |
動的キャッシュを使用する場合は、この変数を 1 に設定して、アプリ ルート (D:\home\site\wwwroot または /home/site/wwwroot ) への書き込みアクセスを無効にできます。 ロックされたファイルによってデプロイがブロックされないように、App_Data ディレクトリを除き、排他的ロックは許可されません。 |
ネットワーク
次の環境変数は、ハイブリッド接続および VNet 統合に関連しています。
設定名 | 説明 |
---|---|
WEBSITE_RELAYS |
読み取り専用です。 ハイブリッド接続を構成するために必要なデータ (エンドポイントと Service Bus データを含む)。 |
WEBSITE_REWRITE_TABLE |
読み取り専用です。 実行時に参照を実行し、接続を適切に書き換えるために使用されます。 |
WEBSITE_VNET_ROUTE_ALL |
既定では、リージョン VNet 統合を使用する場合、アプリでは RFC1918 トラフィックのみを VNet にルーティングします。 すべての送信トラフィックを VNet にルーティングし、同じ NSG と UDR を適用するには、1 に設定します。 この設定を使用すると、VNet を介して RFC1918 以外のエンドポイントにアクセスし、アプリから送信されるすべての送信トラフィックをセキュリティで保護し、すべての送信トラフィックを選択したネットワーク アプライアンスに強制的にトンネリングすることができます。 |
WEBSITE_PRIVATE_IP |
読み取り専用です。 VNet と統合されている場合に、アプリに関連付けられている IP アドレス。 リージョン VNet 統合の場合、この値は委任されたサブネットのアドレス範囲の IP になります。また、ゲートウェイが必要な VNet 統合の場合、この値は仮想ネットワーク ゲートウェイに構成されているポイント対サイトのアドレス プールのアドレス範囲の IP になります。 この IP は、アプリで VNet を介してリソースに接続するために使用されます。 また、説明したアドレス範囲内で変更される可能性があります。 |
WEBSITE_PRIVATE_PORTS |
読み取り専用です。 VNet 統合では、アプリで他のノードと通信するために使用できるポートを示します。 |
WEBSITE_CONTENTOVERVNET |
App Service に Azure ファイル共有をマウントしており、ストレージ アカウントが VNET に制限されている場合は、値 1 を指定してこの設定を有効にしてください。 |
Key Vault 参照
次の環境変数は、Key Vault 参照に関連しています。
設定名 | 説明 |
---|---|
WEBSITE_KEYVAULT_REFERENCES |
読み取り専用です。 アプリで現在構成されているすべての Key Vault 参照の情報 (状態を含む) が含まれています。 |
WEBSITE_SKIP_CONTENTSHARE_VALIDATION |
(WEBSITE_CONTENTAZUREFILECONNECTIONSTRING を使用して) アプリの共有ストレージ接続を Key Vault 参照に設定した場合、アプリの作成または更新時に次のいずれかの条件に当てはまる場合は、Key Vault 参照を解決できません。- アプリでシステム割り当て ID を使用してキー コンテナーにアクセスする。 - アプリでユーザー割り当て ID を使用してキー コンテナーにアクセスし、キー コンテナーが VNet でロックされている。 作成または更新時のエラーを回避するには、この変数を 1 に設定します。 |
WEBSITE_DELAY_CERT_DELETION |
ユーザーは、ワーカー プロセスが依存する証明書がプロセスの終了時まで削除されないようにするため、この環境変数を 1 に設定できます。 |
CORS
次の環境変数は、クロスオリジン リソース共有 (CORS) の構成に関連しています。
設定名 | 説明 |
---|---|
WEBSITE_CORS_ALLOWED_ORIGINS |
読み取り専用です。 CORS で許可されているオリジンを示します。 |
WEBSITE_CORS_SUPPORT_CREDENTIALS |
読み取り専用です。 Access-Control-Allow-Credentials ヘッダーを true に設定することが有効 (True ) か無効 (False ) かを示します。 |
認証と承認
次の環境変数は、App Service 認証に関連しています。
設定名 | 説明 |
---|---|
WEBSITE_AUTH_DISABLE_IDENTITY_FLOW |
true に設定すると、ASP.NET ベースの Web アプリケーション (V1 関数アプリを含む) のスレッド プリンシパル ID の割り当てが無効になります。 これは、開発者が認証を使用してサイトへのアクセスを保護しながら、アプリ ロジック内で別のサインイン メカニズムを使用できるように設計されています。 既定値は、false です。 |
WEBSITE_AUTH_HIDE_DEPRECATED_SID |
true または false 。 既定値は false です。 これは、Azure App Service のレガシである Azure Mobile Apps 統合用の設定です。 これを true に設定すると、認証されたユーザーが自分のプロファイル情報を変更した場合に、そのユーザー用に生成された SID (セキュリティ ID) が変更されるという問題が解決されます。 この値を変更すると、既存の Azure Mobile Apps のユーザー ID が変更される可能性があります。 ほとんどのアプリでは、この設定を使用する必要はありません。 |
WEBSITE_AUTH_NONCE_DURATION |
_hours_:_minutes_:_seconds_ 形式の timespan 値。 既定値は 00:05:00 (5 分) です。 この設定は、すべてのブラウザー駆動型ログインで生成される暗号化 nonce の有効期間を制御します。 指定した時間内にサインインを完了できない場合、サインイン フローが自動的に再試行されます。 このアプリケーション設定は、V1 (クラシック) 構成エクスペリエンスで使用することを目的としています。 V2 認証構成スキーマを使用する場合は、代わりに login.nonce.nonceExpirationInterval 構成値を使用してください。 |
WEBSITE_AUTH_PRESERVE_URL_FRAGMENT |
true に設定し、ユーザーが URL フラグメントを含むアプリ リンクを選択すると、このサインイン プロセスにより、サインイン リダイレクト プロセスで URL の URL フラグメント部分が失われなくなります。 詳細については、Azure App Service 認証でのサインインとサインアウトのカスタマイズに関する記事をご覧ください。 |
WEBSITE_AUTH_USE_LEGACY_CLAIMS |
認証モジュールでは、アップグレード間の下位互換性を維持するため、/.auth/me API で従来の短い名前から長い名前への要求マッピングが使用されるため、特定のマッピング (「ロール」など) が除外されます。 要求マッピングの最新バージョンを取得するには、この変数を False に設定します。 "ロール" の例では、長い要求名 "http://schemas.microsoft.com/ws/2008/06/identity/claims/role"" にマップされます。 |
WEBSITE_AUTH_DISABLE_WWWAUTHENTICATE |
true または false 。 既定値は false です。 true に設定すると、モジュールで生成される HTTP 401 応答から WWW-Authenticate HTTP 応答ヘッダーが削除されます。 このアプリケーション設定は、V1 (クラシック) 構成エクスペリエンスで使用することを目的としています。 V2 認証構成スキーマを使用する場合は、代わりに identityProviders.azureActiveDirectory.login.disableWwwAuthenticate 構成値を使用してください。 |
WEBSITE_AUTH_STATE_DIRECTORY |
ファイルベースのトークン ストアが有効になっている場合に、トークンが格納されるローカル ファイル システムのディレクトリ パス。 既定値は %HOME%\Data\.auth です。 このアプリケーション設定は、V1 (クラシック) 構成エクスペリエンスで使用することを目的としています。 V2 認証構成スキーマを使用する場合は、代わりに login.tokenStore.fileSystem.directory 構成値を使用してください。 |
WEBSITE_AUTH_TOKEN_CONTAINER_SASURL |
完全修飾の BLOB コンテナー URL。 既定のローカル ファイル システムを使用する代わりに、指定された BLOB ストレージ コンテナーにすべての暗号化されたトークンを格納して読み込むように、認証モジュールに指示します。 |
WEBSITE_AUTH_TOKEN_REFRESH_HOURS |
任意の正の 10 進数。 既定値は 72 (時間) です。 この設定は、セッション トークンの有効期限が切れた後で /.auth/refresh API を使用してそれを更新できる時間を制御します。 この期間が過ぎると、更新の試行は失敗し、エンド ユーザーはもう一度サインインする必要があります。 このアプリケーション設定は、V1 (クラシック) 構成エクスペリエンスで使用することを目的としています。 V2 認証構成スキーマを使用する場合は、代わりに login.tokenStore.tokenRefreshExtensionHours 構成値を使用してください。 |
WEBSITE_AUTH_TRACE_LEVEL |
アプリケーション ログに書き込まれる認証トレースの詳細度を制御します。 有効な値は、Off 、Error 、Warning 、Information 、またはVerbose です。 既定値は Verbose です。 |
WEBSITE_AUTH_VALIDATE_NONCE |
true または false 。 既定値は true です。 対話型ログイン中に発生する暗号化 nonce の検証エラーを一時的にデバッグする場合を除き、この値を false に設定しないでください。 このアプリケーション設定は、V1 (クラシック) 構成エクスペリエンスで使用することを目的としています。 V2 認証構成スキーマを使用する場合は、代わりに login.nonce.validateNonce 構成値を使用してください。 |
WEBSITE_AUTH_V2_CONFIG_JSON |
この環境変数は、Azure App Service プラットフォームによって自動的に設定され、統合認証モジュールを構成するために使用されます。 この環境変数の値は、Azure Resource Manager における現在のアプリの V2 (クラシックではない) 認証構成に対応しています。 明示的に構成するためのものではありません。 |
WEBSITE_AUTH_ENABLED |
読み取り専用です。 App Service 認証が有効かどうかを示すために Windows または Linux アプリに挿入されます。 |
WEBSITE_AUTH_ENCRYPTION_KEY |
既定では、自動生成されたキーが暗号化キーとして使用されます。 オーバーライドするには、目的のキーに設定します。 これは、複数のアプリでトークンまたはセッションを共有する場合にお勧めします。 指定された場合は、MACHINEKEY_DecryptionKey 設定よりも優先されます。 |
WEBSITE_AUTH_SIGNING_KEY |
既定では、自動生成されたキーが署名キーとして使用されます。 オーバーライドするには、目的のキーに設定します。 これは、複数のアプリでトークンまたはセッションを共有する場合にお勧めします。 指定された場合は、MACHINEKEY_ValidationKey 設定よりも優先されます。 |
マネージド ID
次の環境変数は、マネージド ID に関連しています。
設定名 | 説明 |
---|---|
IDENTITY_ENDPOINT |
読み取り専用です。 アプリのマネージド ID のトークンを取得するための URL。 |
MSI_ENDPOINT |
非推奨になりました。 IDENTITY_ENDPOINT を使用してください。 |
IDENTITY_HEADER |
読み取り専用です。 IDENTITY_ENDPOINT に対して HTTP GET 要求を行う際に X-IDENTITY-HEADER ヘッダーに追加する必要がある値。 値は、プラットフォームによってローテーションされます。 |
MSI_SECRET |
非推奨になりました。 IDENTITY_HEADER を使用してください。 |
正常性チェック
次の環境変数は、正常性チェックに関連しています。
設定名 | 説明 |
---|---|
WEBSITE_HEALTHCHECK_MAXPINGFAILURES |
インスタンスを削除するまでに失敗する ping の最大数。 2 から 100 までの値に設定します。 スケールアップまたはスケールアウトする場合は、新しいインスタンスの準備ができていることを確認するため、App Service で正常性チェックのパスに ping が実行されます。 詳細については、「正常性チェック」を参照してください。 |
WEBSITE_HEALTHCHECK_MAXUNHEALTHYWORKERPERCENT |
正常なインスタンスが過負荷にならないように、ご利用のインスタンスの半分以下が除外されます。 たとえば、App Service プランが 4 つのインスタンスにスケーリングされ、3 つに異常が発生した場合、最大 2 つが除外されます。 他の 2 つのインスタンス (1 つは正常、1 つは異常) は、引き続き要求を受信することになります。 すべてのインスタンスが異常であるという最悪のシナリオでは、何も除外されません。 この動作をオーバーライドするには、1 から 100 までの値に設定します。 値を大きくすると、異常なインスタンスがより多く削除されます。 既定値は 50 (50%) です。 |
プッシュ通知
次の環境変数は、プッシュ通知機能に関連しています。
設定名 | 説明 |
---|---|
WEBSITE_PUSH_ENABLED |
読み取り専用です。 プッシュ通知が有効になったときに追加されます。 |
WEBSITE_PUSH_TAG_WHITELIST |
読み取り専用です。 通知登録のタグが含まれています。 |
WEBSITE_PUSH_TAGS_REQUIRING_AUTH |
読み取り専用です。 通知登録でユーザー認証を必要とするタグの一覧が含まれています。 |
WEBSITE_PUSH_TAGS_DYNAMIC |
読み取り専用です。 通知登録で自動的に追加されたタグの一覧が含まれています。 |
Note
この記事には、Microsoft が使用しなくなった用語への言及が含まれています。 ソフトウェアからこの用語が削除された時点で、この記事から削除します。
Web ジョブ
次の環境変数は、Web ジョブに関連しています。
設定名 | 説明 |
---|---|
WEBJOBS_RESTART_TIME |
連続ジョブの場合、ジョブのプロセスが何らかの理由で停止してから再起動するまでの遅延時間 (秒)。 |
WEBJOBS_IDLE_TIMEOUT |
トリガーされたジョブの場合、ジョブがアイドル状態で、CPU 時間も出力もない場合に、ジョブが中止されるまでのタイムアウト (秒)。 |
WEBJOBS_HISTORY_SIZE |
トリガーされたジョブの場合、ジョブごとに履歴ディレクトリに保持される実行の最大数。 既定値は、50 です。 |
WEBJOBS_STOPPED |
ジョブの実行を無効にし、現在実行中のすべてのジョブを停止するには、1 に設定します。 |
WEBJOBS_DISABLE_SCHEDULE |
スケジュールされたすべてのトリガーを無効にするには、1 に設定します。 その場合でも、手動でジョブを呼び出すことがでできます。 |
WEBJOBS_ROOT_PATH |
Web ジョブ ファイルの絶対または相対パス。 相対パスの場合、この値は既定のルート パス (D:/home/site/wwwroot/ または /home/site/wwwroot/ ) と結合されます。 |
WEBJOBS_LOG_TRIGGERED_JOBS_TO_APP_LOGS |
トリガーされた Web ジョブからの出力をアプリケーション ログのパイプライン (ファイル システム、BLOB、テーブルをサポート) に送信するには、True に設定します。 |
WEBJOBS_SHUTDOWN_FILE |
シャットダウン要求が検出されたときに App Service によって作成されるファイル。 このファイルの存在を検出してシャットダウンを開始するのは、Web ジョブ プロセスの役割です。 Web ジョブ SDK を使用する場合、この部分は自動的に処理されます。 |
WEBJOBS_PATH |
読み取り専用です。 現在実行中のジョブのルート パス (何らかの一時ディレクトリの下に配置されます)。 |
WEBJOBS_NAME |
読み取り専用です。 現在のジョブ名。 |
WEBJOBS_TYPE |
読み取り専用です。 現在のジョブの種類 (triggered または continuous )。 |
WEBJOBS_DATA_PATH |
読み取り専用です。 ジョブのログ、履歴、ジョブの成果物を格納する、現在のジョブのメタデータ パス。 |
WEBJOBS_RUN_ID |
読み取り専用です。 トリガーされたジョブの場合、ジョブの現在の実行 ID。 |
関数
設定名 | 説明 |
---|---|
WEBSITE_FUNCTIONS_ARMCACHE_ENABLED |
関数キャッシュを無効にするには、0 に設定します。 |
WEBSITE_MAX_DYNAMIC_APPLICATION_SCALE_OUT |
Azure Functions のアプリケーション設定のリファレンス |
AzureWebJobsSecretStorageType |
Azure Functions のアプリケーション設定のリファレンス |
FUNCTIONS_EXTENSION_VERSION |
Azure Functions のアプリケーション設定のリファレンス |
FUNCTIONS_WORKER_RUNTIME |
Azure Functions のアプリケーション設定のリファレンス |
AzureWebJobsStorage |
Azure Functions のアプリケーション設定のリファレンス |
WEBSITE_CONTENTAZUREFILECONNECTIONSTRING |
Azure Functions のアプリケーション設定のリファレンス |
WEBSITE_CONTENTSHARE |
Azure Functions のアプリケーション設定のリファレンス |
WEBSITE_CONTENTOVERVNET |
Azure Functions のアプリケーション設定のリファレンス |
WEBSITE_ENABLE_BROTLI_ENCODING |
Azure Functions のアプリケーション設定のリファレンス |
WEBSITE_USE_PLACEHOLDER |
Azure Functions のアプリケーション設定のリファレンス |
WEBSITE_PLACEHOLDER_MODE |
読み取り専用です。 関数アプリがプレースホルダー ホスト (generalized ) と独自のホスト (specialized ) のどちらで実行されるかを示します。 |
WEBSITE_DISABLE_ZIP_CACHE |
アプリが ZIP パッケージから実行される場合 (WEBSITE_RUN_FROM_PACKAGE=1 ) は、最近デプロイされた 5 つの ZIP パッケージがアプリのファイル システム (D:\home\data\SitePackages) にキャッシュされます。 このキャッシュを無効にするには、この変数を 1 に設定します。 Linux 従量課金アプリの場合、ZIP パッケージ キャッシュは既定で無効になっています。 |