配置应用服务应用

1. 在 Azure 门户中搜索并选择“应用服务” ，然后选择应用。

2. 在应用的左侧菜单中，选择 “设置>环境变量”。 然后选择 “应用设置”。

   

   默认情况下，出于安全考虑，应用设置值会隐藏在门户中。 若要查看应用设置的隐藏值，请在 “值”下选择“ 显示值”。 若要查看所有应用设置的隐藏值，请选择“ 显示值”。

   注意

   在 Azure 门户中查看此部分需要读取/写入用户权限。 具有足够权限的 RBAC 内置角色是“所有者”、“参与者”和“网站参与者”。 仅具有“读者”角色将无权访问此页面。

3. 若要添加新的应用设置，请选择“添加”。 若要编辑设置，请选择该设置。

4. 在对话框中，可将设置绑定到当前槽。

   注意

   在默认 Linux 应用服务或自定义 Linux 容器中，应用设置名称中的任何嵌套 JSON 密钥结构都需要以不同的方式为密钥名称配置。 将任何冒号（:）替换为双下划线（__）。 将任何句点 (.) 替换为单个下划线 (_)。 例如，ApplicationInsights:InstrumentationKey 需要在应用服务中配置为密钥名称 ApplicationInsights__InstrumentationKey。

5. 完成后，选择应用。 选择“环境变量”页上的“应用”。

使用 az webapp config 应用设置集添加或编辑应用设置：

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

请将 <setting-name> 替换为设置的名称。 将 <value> 替换为要分配给设置的值。

使用命令 az webapp config appsettings list 来显示所有设置及其值。

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

使用 az webapp config app settings delete 删除一个或多个设置：

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

使用 Set-AzWebApp 设置一个或多个应用设置：

Set-AzWebApp -ResourceGroupName <group-name> -Name <app-name> -AppSettings @{"<setting-name1>"="<value1>"; "<setting-name2>"="<value2>";...}

此 cmdlet 将整个应用设置集替换为指定的设置。 若要在现有集中添加或编辑应用设置，请使用 Get-AzWebApp cmdlet 在输入哈希表中包括现有应用设置。 例如：

# Get app configuration
$webapp=Get-AzWebApp -ResourceGroupName <group-name> -Name <app-name>

# Copy app settings to a new hash table
$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

若要检查应用设置是否特定于槽，请使用 Get-AzWebAppSlotConfigName：

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

若要将一个或多个应用设置配置为特定插槽，请使用 Set-AzWebAppSlotConfigName：

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

1. 选择 “高级编辑”。
2. 编辑文本区域中的设置。
3. 完成后，选择“确定”。 选择“环境变量”页上的“应用”。

应用设置采用以下 JSON 格式：

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

运行 az webapp config app settings set 命令，并指定 JSON 文件的名称：

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

必要的文件格式是一个 JSON 数组，其中槽设置字段是可选的。 例如：

[
  {
    "name": "key1",
    "slotSetting": false,
    "value": "value1"
  },
  {
    "name": "key2",
    "value": "value2"
  }
]

为方便起见，可以使用 az webapp config appsettings list 将现有设置保存在 JSON 文件中。

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

不能通过将 JSON 文件与 Azure PowerShell 一起使用来批量编辑应用设置。

1. 在 Azure 门户中搜索并选择“应用服务” ，然后选择应用。

2. 在应用的左侧菜单中，选择 “设置>环境变量”。 然后选择 “连接字符串”。

   默认情况下，出于安全考虑，连接字符串的值会隐藏在门户中。 若要查看连接字符串的隐藏值，请在 “值”下选择“ 显示值”。 若要查看所有连接字符串的隐藏值，请选择“ 显示值”。

3. 若要添加新的连接字符串，请选择“添加”。 若要编辑某个连接字符串，请选择该连接字符串。

4. 在对话框中，可将连接字符串绑定到当前槽。

5. 完成后，选择应用。 选择“环境变量”页上的“应用”。

使用 az webapp config connection-string set 添加或编辑应用设置：

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

将 <string-name> 替换为连接字符串的名称。 将<value>替换为要分配给连接字符串的值。 有关<type>的可能值，例如SQLAzure，请参阅CLI 命令文档。

使用 az webapp config connection-string list 显示所有连接字符串及其值：

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

使用 az webapp config connection-string delete 删除一个或多个连接字符串：

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

使用 Set-AzWebApp 设置一个或多个连接字符串：

$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

每个连接字符串都包含一个名称（<string-name1>）、一个值（<connection-string1>）和类型。 类型是对应于 ConnectionStringType 枚举器字段之一的数值。 例如，对于 Azure SQL，请指定 type="2"。

此 cmdlet 将整个连接字符串集替换为指定的连接字符串集。 若要在现有集中添加或编辑应用设置，请使用 Get-AzWebApp cmdlet 在输入哈希表中包括现有应用设置。 例如：

# Get app configuration
$webapp=Get-AzWebApp -ResourceGroupName <group-name> -Name <app-name>

# Copy connection strings to a new hash table
$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

若要检查连接字符串是否特定于某个槽，请使用 Get-AzWebAppSlotConfigName：

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

若要使一个或多个连接字符串槽特定，请使用 Set-AzWebAppSlotConfigName：

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

1. 选择 “高级编辑”。
2. 在文本区域中编辑连接字符串。
3. 完成后，选择应用。 不要忘记在“环境变量”页上选择“应用”。

连接字符串采用以下 JSON 格式：

[
  {
    "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 命令，并使用 JSON 文件的名称：

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

必需的文件格式是连接字符串的 JSON 数组，其中槽设置字段是可选的。 例如：

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

为方便起见，可以使用 az webapp config connection-string list 将现有连接字符串保存在 JSON 文件中。

# 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

不能通过将 JSON 文件与 Azure PowerShell 一起使用来批量编辑连接字符串。

1. 在 Azure 门户中搜索并选择“应用服务” ，然后选择应用。

2. 在应用的左侧菜单中，选择 “设置>配置”。 然后选择 “常规设置”。

   

在此处可以配置应用的某些常用设置。 某些设置要求纵向扩展到更高的定价层。

• 平台设置：配置托管平台的设置，包括：

  • 平台：选择 32 位或 64 位。 仅适用于 Windows 应用。

  • FTP 状态：仅允许 FTPS 或完全禁用 FTP。

  • HTTP 版本：设置为 2.0 以启用对 HTTPS/2 协议的支持。

    注意

    大多数新式浏览器仅支持基于 TLS 的 HTTP/2 协议。 未加密的流量继续使用 HTTP/1.1。 若要确保客户端浏览器使用 HTTP/2 连接到应用，请保护自定义 DNS 名称。 有关详细信息，请参阅 在应用服务中使用 TLS/SSL 绑定为自定义 DNS 名称提供安全性。

  • Web 套接字配置 ASP.NET SignalR 或 socket.io。

  • Always On：如果您希望在没有流量时也能保持应用加载，请启用。

    关闭 Always On （默认值），应用在 20 分钟后卸载，无需任何传入请求。 未加载的应用可能会因为存在预热时间而导致新请求的延迟过高。

    启用 Always On 后，前端负载均衡器每五分钟向应用程序根发送一个 GET 请求。 连续的 ping 会阻止卸载该应用。

    对于连续的 WebJobs 或使用 cron 表达式触发的 WebJobs，Always On 是必需的。

  • 会话相关性：在多实例部署中，确保客户端在会话生存期路由到同一实例。 对于无状态应用程序，请将此选项设置为“关闭”。

  • 会话关联代理：如果应用位于反向代理（如 Azure 应用程序网关或 Azure Front Door）后面，并且使用的是默认主机名，请启用该代理。 会话关联 Cookie 的域与反向代理中的转发主机名保持一致。

  • 仅 HTTPS：如果要将所有 HTTP 流量重定向到 HTTPS，则启用。

  • 最低 TLS 版本：选择应用所需的最低 TLS 加密版本。

    注意

    后量子混合密钥交换 由平台管理，没有应用级设置。 将最低TLS版本设置为1.3并不需要混合组 X25519MLKEM768。 最低 TLS 版本和最低密码套件设置均不会启用、禁用或要求该组。

• 调试：为 ASP.NET、ASP.NET Core 或 Node.js 应用启用远程调试。 此选项在 48 小时后会自动关闭。

• 传入客户端证书：需要在 相互身份验证中要求客户端证书。

还可以选择 “堆栈设置 ”选项卡来配置软件堆栈运行应用的设置，包括语言和 SDK 版本。 对于 Linux 应用，可以选择语言运行时版本并设置可选的启动命令。

可以使用 az webapp config set 设置许多常见的可配置选项。 以下示例显示了可配置选项的子集：

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

对于 Windows 应用程序，将 --use-32bit-worker-process false 设置为使用 64 位 (x64) 进程。 此设置不会增加该层级的资源配额。

若要显示现有设置，请使用 az webapp config show 命令。

可以使用 Set-AzWebApp 设置许多常见的可配置选项。 以下示例显示了可配置选项的子集：

Set-AzWebApp -ResourceGroupName <group-name> -Name <app-name> -Use32BitWorkerProcess [$True|$False] -WebSocketsEnabled [$True|$False] -AlwaysOn [$True|$False] -NumberOfWorkers

对于 Windows 应用程序，将 -Use32BitWorkerProcess $False 设置为使用 64 位 (x64) 进程。 此设置不会增加该层级的资源配额。

若要显示现有设置，请使用 Get-AzWebApp 命令。

1. 在 Azure 门户中搜索并选择“应用服务” ，然后选择应用。
2. 在应用的左侧菜单中，选择“ 配置”。 然后选择 “默认文档”。
3. 若要添加默认文档，请添加列表项，然后选择“ 应用”。 若要删除默认文档，请选择右侧的 “删除” 图标。

使用 az resource update 添加默认文档：

az resource update --resource-group <group-name> --resource-type "Microsoft.Web/sites/config" --name <app-name>/config/web --add properties.defaultDocuments <filename>

通过修改更新应用的 PowerShell 对象添加默认文档：

$webapp = Get-AzWebApp -ResourceGroupName <group-name> -Name <app-name>
$webapp.SiteConfig.DefaultDocuments.Add("<filename>")
Set-AzWebApp $webapp

1. 在 Azure 门户中搜索并选择“应用服务” ，然后选择应用。

2. 在应用的左侧菜单中，选择 “设置>配置”。 然后选择 “路径映射”。

3. 选择 “添加虚拟应用程序或目录”。 然后执行以下操作之一：

   • 若要将虚拟目录映射到物理路径，请选择 “目录”。 指定虚拟目录，以及网站根目录相应的相对（物理）路径 (D:\home)。
   • 若要将虚拟目录标记为 Web 应用程序，请选择 “虚拟应用程序”。

   

4. 选择 “添加 ”以保存。

以下示例将根路径 / 设置为适用于 Laravel 的 public 子目录。 它还会在 /app2 路径中添加第二个虚拟应用程序。 若要运行它，请创建一个名为 json.txt 的文件，并包含以下内容：

[
  {
    "physicalPath"':' "site\\wwwroot\\public",
    "preloadEnabled"':' false,
    "virtualDirectories"':' null,
    "virtualPath"':' "/"
  },
  {
    "physicalPath"':' "site\\wwwroot\\app2",
    "preloadEnabled"':' false,
    "virtualDirectories"':' null,
    "virtualPath"':' "/app2"
  }
]

更改资源的 <group-name> 和 <app-name> 并运行以下命令。 运行此命令时请注意转义字符。 有关转义字符的详细信息，请参阅有关成功使用 Azure CLI 的提示。

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

以下示例将根路径 / 设置为适用于 Laravel 的 public 子目录。 它还会在 /app2 路径中添加第二个虚拟应用程序。 若要运行它，请更改 <group-name> 和 <app-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