Настройка службы приложений

1. На портале Azure найдите и выберите Службы приложений, а затем выберите приложение.

2. В меню слева приложения выберите Параметры, >. Затем выберите параметры приложения.

   

   По умолчанию в целях безопасности значения параметров приложения на портале скрыты. Чтобы увидеть скрытое значение параметра приложения в разделе "Значение", выберите "Показать значение". Чтобы просмотреть скрытые значения всех параметров приложения, выберите "Показать значения".

   Примечание.

   Read/Write user permimssions are required to view this section in the Azure portal. RBAC built-in roles with sufficient permissions are Owner, Contributor, and Website Contributor. The Reader role alone would not be allowed to access this page.

3. Чтобы добавить новый параметр приложения, нажмите кнопку "Добавить". Чтобы изменить параметр, выберите этот параметр.

4. В диалоговом окне можно прикрепить параметр к текущему слоту.

   Примечание.

   В службе приложений Linux по умолчанию или пользовательском контейнере Linux любая вложенная структура ключа JSON в имени параметра приложения должна быть настроена по-разному для имени ключа. Замените любое двоеточие (:) двойным подчеркиванием (__). Замените любой период (.) одним подчеркиванием (_). For example, ApplicationInsights:InstrumentationKey needs to be configured in App Service as ApplicationInsights__InstrumentationKey for the key name.

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>

Remove one or more settings by using 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>";...}

Этот командлет заменяет весь набор параметров конфигурации приложения на указанные вами. Чтобы добавить или изменить параметр приложения в существующем наборе, добавьте существующие параметры приложения в входную хэш-таблицу с помощью командлета Get-AzWebApp . Например:

# 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. Select Advanced edit.
2. Измените параметры в текстовой области.
3. По завершении нажмите кнопку ОК. Затем выберите Применить на странице переменных среды.

Параметры приложения задаются в следующем формате JSON.

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

Run az webapp config app settings set with the name of the JSON file:

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"
  }
]

Для удобства можно сохранить существующие параметры в JSON-файле с помощью az webapp config appsettings list.

# 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. По завершении нажмите кнопку "Применить". Затем выберите Применить на странице переменных среды.

Add or edit an app setting by using 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 . Например, для SQL Azure укажите type="2".

Этот командлет заменяет весь набор строк подключения на те, которые вы указываете. Чтобы добавить или изменить параметр приложения в существующем наборе, добавьте существующие параметры приложения в входную хэш-таблицу с помощью командлета Get-AzWebApp . Например:

# 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. Select Advanced edit.
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
  },
  ...
]

Run az webapp config connection-string set with the name of the JSON file:

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

Для удобства можно сохранить существующие строки подключения в JSON-файле с помощью az webapp config connection-string list.

# 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. В меню слева приложения выберите "Конфигурация параметров>". Затем выберите общие параметры.

   

Здесь можно настроить некоторые общие параметры для приложения. Для некоторых параметров необходимо выполнить масштабирование до более высокой ценовой категории.

• Параметры стека: настройте параметры стека программного обеспечения для запуска приложения, включая версии языка и пакета SDK.

  Для приложений Linux можно выбрать версию среды выполнения языка и задать необязательную команду запуска.

• Параметры платформы: настройка параметров для платформы размещения, в том числе:

  • Платформа: выберите 32-разрядную или 64-разрядную версию. Только для приложений для Windows.

  • Состояние FTP: разрешить только FTPS или отключить FTP полностью.

  • ВЕРСИЯ HTTP: установите значение 2.0 , чтобы включить поддержку протокола HTTPS/2 .

    Примечание.

    Большинство современных браузеров поддерживают протокол HTTP/2 только по протоколу TLS. Незашифрованный трафик продолжает использовать HTTP/1.1. Чтобы клиентские браузеры могли подключаться к приложению по протоколу HTTP/2, обеспечьте безопасность настраиваемого DNS-имени. Дополнительные сведения см. в разделе "Обеспечение безопасности для пользовательского DNS-имени с привязкой TLS/SSL" в службе приложений.

  • Веб-сокеты: настройте для ASP.NET SignalR или socket.io, например.

  • AlwaysOn: включите, если вы хотите сохранить приложение загружено, даже если нет трафика.

    При отключении AlwaysOn (по умолчанию) приложение выгрузится через 20 минут без входящих запросов. The unloaded app can cause high latency for new requests because of its warm-up time.

    При включении AlwaysOn интерфейсная подсистема балансировки нагрузки отправляет GET запрос в корневой каталог приложения каждые пять минут. Постоянный пинг предотвращает выгрузку приложения.

    AlwaysOn требуется для непрерывных веб-заданий или веб-заданий, которые активируют выражение cron.

  • Session affinity: In a multiple-instance deployment, ensure that the client is routed to the same instance for the life of the session. Для приложений без отслеживания состояния этот параметр можно установить в значение Off (Выкл.).

  • Session affinity proxy: Turn on if your app is behind a reverse proxy (like Azure Application Gateway or Azure Front Door) and you're using the default host name. Домен для файла cookie привязки сеансов соответствует переданному имени хоста от обратного прокси-сервера.

  • Только HTTPS: включите, если вы хотите перенаправить весь HTTP-трафик на HTTPS.

  • Минимальная версия TLS: выберите минимальную версию шифрования TLS, которую требует ваше приложение.

• Debugging (Отладка): включение удаленной отладки для приложений ASP.NET, ASP.NET Core или Node.js. Этот параметр автоматически отключается через 48 часов.

• Входящие сертификаты клиента: требовать сертификаты клиента во взаимной проверке подлинности.

Вы можете задать множество распространенных настраиваемых параметров с помощью 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

Чтобы отобразить существующие параметры, используйте команду az webapp config show.

Вы можете задать множество распространенных настраиваемых параметров с помощью Set-AzWebApp. В следующем примере показано подмножество настраиваемых параметров:

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

Чтобы отобразить существующие параметры, используйте команду 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. В меню слева приложения выберите "Конфигурация параметров>". Then select Path mappings.

3. Выберите новое виртуальное приложение или каталог. Затем выполните одно из следующих действий:

   • To map a virtual directory to a physical path, leave Directory selected. Укажите виртуальный каталог и соответствующий относительный (физический) путь к корню веб-сайта (D:\home).
   • Чтобы пометить виртуальный каталог как веб-приложение, отмените выбор каталога.

   

4. Нажмите OK. Затем нажмите кнопку "Сохранить " на странице "Конфигурация ".

Следующий пример задает корневой путь / к подкаталогу public , который работает для Laravel. Он также добавляет второе виртуальное приложение по пути /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> для ресурсов и выполните следующую команду. Be aware of escape characters when you run this command. Дополнительные сведения о escape-символах см. в статье Советы по эффективному использованию 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"

Следующий пример задает корневой путь / к подкаталогу public , который работает для Laravel. Он также добавляет второе виртуальное приложение по пути /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