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

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

   

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

   

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

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

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

   Примечание.

   В службе приложений Linux по умолчанию или в настраиваемом контейнере Linux любая вложенная структура ключей JSON в имени параметра приложения, например ApplicationInsights:InstrumentationKey, должна указываться в службе приложений для имени ключа как ApplicationInsights__InstrumentationKey. Другими словами, символы : следует заменять на __ (двойное подчеркивание). Все периоды в имени параметра приложения будут заменены одним символом _ подчеркивания.

5. По завершении нажмите кнопку "Применить". Не забудьте выбрать "Применить обратно" на странице переменных среды.

Добавьте или измените параметр приложения с помощью команды az webapp config app settings set:

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

Замените <setting-name> на имя параметра, а <value> — на значение для этого параметра.

Отобразите все параметры и их значения с помощью команды az webapp config appsettings list.

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

Удалите один параметр или несколько с помощью команды az webapp config app settings delete.

az webapp config appsettings delete --name <app-name> --resource-group <group-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 Hashtable
$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>,...

Нажмите кнопку "Дополнительно изменить ". Измените параметры в текстовой области. По завершении выберите ОК. Не забудьте выбрать "Применить обратно" на странице переменных среды.

Параметры приложения задаются в следующем формате 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"
  }
]

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

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

Удалите одну или несколько строк подключения с помощью команды az webapp config connection-string delete:

az webapp config connection-string delete --name <app-name> --resource-group <group-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 hashtable
$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>,...

Нажмите кнопку "Дополнительно изменить ". Измените строки подключения в текстовой области. По завершении нажмите кнопку "Применить". Не забудьте выбрать "Применить обратно" на странице переменных среды.

Строки подключения задаются в следующем формате 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",
  },
  ...
]

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

# 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.

На портале Azure найдите и выберите Службы приложений, а затем выберите приложение. В меню приложения слева выберите Конфигурация>Общие параметры.

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

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

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

  

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

  • Скорость платформы: 32-разрядная или 64-разрядная. Только для приложений для Windows.
  • Состояние FTP: возможность разрешить только FTPS или отключить протокол FTP в целом.
  • HTTP version (Версия HTTP): задайте значение 2.0, чтобы включить поддержку протокола HTTPS/2.

  Примечание.

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

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

  • Always On: приложение остается загруженным даже при отсутствии трафика. Если AlwaysOn не включен (по умолчанию), приложение выгрузится через 20 минут без входящих запросов. Выгруженное приложение может вызвать высокую задержку для новых запросов, так как ему нужно снова загрузиться. Если параметр Всегда включено включен, внешняя подсистема балансировки нагрузки отправляет запрос GET к корню приложения каждые пять минут. Важно убедиться, что этот запрос получает ответ 200 ОК, чтобы убедиться, что все операции повторной визуализации выполняются правильно. Непрерывная проверка связи предотвращает выгрузку приложения.

    Параметр "Всегда включено" обязателен для постоянных веб-заданий или для веб-заданий, которые запускаются с помощью выражения CRON.

  • Сходство сеансов. В развертывании с несколькими экземплярами убедитесь, что клиент направляется в тот же экземпляр для жизни сеанса. Для приложений без отслеживания состояния этот параметр можно установить в значение Off (Выкл.).

  • Прокси-сервер сопоставления сеансов: прокси-сервер сопоставления сеансов можно включить, если приложение находится за обратным прокси-сервером (например, Шлюз приложений Azure или Azure Front Door) и используется имя узла по умолчанию. Домен для файла cookie сходства сеансов будет соответствовать имени перенаправленного узла из обратного прокси-сервера.

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

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

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

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

Многие из общих настраиваемых параметров можно задать с помощью команды 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. В меню приложения слева выберите Конфигурация>Сопоставления путей

3. Выберите новое виртуальное приложение или каталог.

   • Чтобы сопоставить виртуальный каталог с физическим путем, установите флажок Каталог. Укажите виртуальный каталог и соответствующий относительный (физический) путь к корню веб-сайта (D:\home).
   • Чтобы пометить виртуальный каталог как веб-приложение, снимите флажок Каталог.

   

4. Нажмите ОК. Не забудьте выбрать "Сохранить" на странице "Конфигурация".

В следующем примере задается корневой путь / к подкаталогу 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> для ресурсов и выполните следующую команду. При выполнении этой команды следует учитывать escape-символы. Дополнительные сведения о 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