#REF!WebApp@1 - #REF! задача веб-приложения v1

Эта задача запускает веб-приложение #REF! для Linux или #REF!.

Синтаксис

# Azure Web App v1
# Deploy an Azure Web App for Linux or Windows.
- task: AzureWebApp@1
  inputs:
    azureSubscription: # string. Required. Azure subscription. 
    appType: # 'webApp' | 'webAppLinux'. Required. App type. 
    appName: # string. Required. App name. 
    #deployToSlotOrASE: false # boolean. Optional. Use when appType != "". Deploy to Slot or App Service Environment. Default: false.
    #resourceGroupName: # string. Required when deployToSlotOrASE = true. Resource group. 
    #slotName: 'production' # string. Required when deployToSlotOrASE = true. Slot. Default: production.
    package: '$(System.DefaultWorkingDirectory)/**/*.zip' # string. Required. Package or folder. Default: $(System.DefaultWorkingDirectory)/**/*.zip.
    #customDeployFolder: # string. Optional. Use when package EndsWith .war. Custom Deploy Folder. 
    #runtimeStack: # 'DOTNETCORE|9.0' | 'DOTNETCORE|8.0' | 'DOTNETCORE|7.0' | 'DOTNETCORE|6.0' | 'NODE|24-lts' | 'NODE|22-lts' | 'NODE|20-lts' | 'NODE|18-lts' | 'NODE|16-lts' | 'PYTHON|3.13' | 'PYTHON|3.12' | 'PYTHON|3.11' | 'PYTHON|3.10' | 'PYTHON|3.9' | 'PYTHON|3.8' | 'PHP|8.3' | 'PHP|8.2' | 'PHP|8.1' | 'PHP|8.0' | 'JAVA|21-java21' | 'JAVA|17-java17' | 'JAVA|11-java11' | 'JAVA|8-jre8' | 'JBOSSEAP|8-java17' | 'JBOSSEAP|8-java11' | 'JBOSSEAP|7-java17' | 'JBOSSEAP|7-java11' | 'JBOSSEAP|7-java8' | 'TOMCAT|10.1-java21' | 'TOMCAT|10.1-java17' | 'TOMCAT|10.1-java11' | 'TOMCAT|10.0-java17' | 'TOMCAT|10.0-java11' | 'TOMCAT|10.0-jre8' | 'TOMCAT|9.0-java21' | 'TOMCAT|9.0-java17' | 'TOMCAT|9.0-java11' | 'TOMCAT|9.0-jre8' | 'TOMCAT|8.5-java11' | 'TOMCAT|8.5-jre8'. Optional. Use when appType = webAppLinux. Runtime stack. 
    #startUpCommand: # string. Optional. Use when appType = webAppLinux. Startup command. 
    #siteContainersConfig: # string. Site Containers Config. 
  # Application and Configuration Settings
    #customWebConfig: # string. Optional. Use when appType != webAppLinux && package NotEndsWith .war. Generate web.config parameters for Python, Node.js, Go and Java apps. 
    #appSettings: # string. App settings. 
    #configurationStrings: # string. Configuration settings. 
  # Additional Deployment Options
    #deploymentMethod: 'auto' # 'auto' | 'zipDeploy' | 'runFromPackage'. Required when appType != webAppLinux && appType != "" && package NotEndsWith .war && package NotEndsWith .jar. Deployment method. Default: auto.

# Azure Web App v1
# Deploy an Azure Web App for Linux or Windows.
- task: AzureWebApp@1
  inputs:
    azureSubscription: # string. Required. Azure subscription. 
    appType: # 'webApp' | 'webAppLinux'. Required. App type. 
    appName: # string. Required. App name. 
    #deployToSlotOrASE: false # boolean. Optional. Use when appType != "". Deploy to Slot or App Service Environment. Default: false.
    #resourceGroupName: # string. Required when deployToSlotOrASE = true. Resource group. 
    #slotName: 'production' # string. Required when deployToSlotOrASE = true. Slot. Default: production.
    package: '$(System.DefaultWorkingDirectory)/**/*.zip' # string. Required. Package or folder. Default: $(System.DefaultWorkingDirectory)/**/*.zip.
    #customDeployFolder: # string. Optional. Use when package EndsWith .war. Custom Deploy Folder. 
    #runtimeStack: # 'DOTNETCORE|9.0' | 'DOTNETCORE|8.0' | 'DOTNETCORE|7.0' | 'DOTNETCORE|6.0' | 'NODE|22-lts' | 'NODE|20-lts' | 'NODE|18-lts' | 'NODE|16-lts' | 'PYTHON|3.13' | 'PYTHON|3.12' | 'PYTHON|3.11' | 'PYTHON|3.10' | 'PYTHON|3.9' | 'PYTHON|3.8' | 'PHP|8.3' | 'PHP|8.2' | 'PHP|8.1' | 'PHP|8.0' | 'JAVA|21-java21' | 'JAVA|17-java17' | 'JAVA|11-java11' | 'JAVA|8-jre8' | 'JBOSSEAP|8-java17' | 'JBOSSEAP|8-java11' | 'JBOSSEAP|7-java17' | 'JBOSSEAP|7-java11' | 'JBOSSEAP|7-java8' | 'TOMCAT|10.1-java21' | 'TOMCAT|10.1-java17' | 'TOMCAT|10.1-java11' | 'TOMCAT|10.0-java17' | 'TOMCAT|10.0-java11' | 'TOMCAT|10.0-jre8' | 'TOMCAT|9.0-java21' | 'TOMCAT|9.0-java17' | 'TOMCAT|9.0-java11' | 'TOMCAT|9.0-jre8' | 'TOMCAT|8.5-java11' | 'TOMCAT|8.5-jre8'. Optional. Use when appType = webAppLinux. Runtime stack. 
    #startUpCommand: # string. Optional. Use when appType = webAppLinux. Startup command. 
  # Application and Configuration Settings
    #customWebConfig: # string. Optional. Use when appType != webAppLinux && package NotEndsWith .war. Generate web.config parameters for Python, Node.js, Go and Java apps. 
    #appSettings: # string. App settings. 
    #configurationStrings: # string. Configuration settings. 
  # Additional Deployment Options
    #deploymentMethod: 'auto' # 'auto' | 'zipDeploy' | 'runFromPackage'. Required when appType != webAppLinux && appType != "" && package NotEndsWith .war && package NotEndsWith .jar. Deployment method. Default: auto.

# Azure Web App v1
# Deploy an Azure Web App for Linux or Windows.
- task: AzureWebApp@1
  inputs:
    azureSubscription: # string. Required. Azure subscription. 
    appType: # 'webApp' | 'webAppLinux'. Required. App type. 
    appName: # string. Required. App name. 
    #deployToSlotOrASE: false # boolean. Optional. Use when appType != "". Deploy to Slot or App Service Environment. Default: false.
    #resourceGroupName: # string. Required when deployToSlotOrASE = true. Resource group. 
    #slotName: 'production' # string. Required when deployToSlotOrASE = true. Slot. Default: production.
    package: '$(System.DefaultWorkingDirectory)/**/*.zip' # string. Required. Package or folder. Default: $(System.DefaultWorkingDirectory)/**/*.zip.
    #customDeployFolder: # string. Optional. Use when package EndsWith .war. Custom Deploy Folder. 
    #runtimeStack: # string. Optional. Use when appType = webAppLinux. Runtime stack. 
    #startUpCommand: # string. Optional. Use when appType = webAppLinux. Startup command. 
  # Application and Configuration Settings
    #customWebConfig: # string. Optional. Use when appType != webAppLinux && package NotEndsWith .war. Generate web.config parameters for Python, Node.js, Go and Java apps. 
    #appSettings: # string. App settings. 
    #configurationStrings: # string. Configuration settings. 
  # Additional Deployment Options
    #deploymentMethod: 'auto' # 'auto' | 'zipDeploy' | 'runFromPackage'. Required when appType != webAppLinux && appType != "" && package NotEndsWith .war && package NotEndsWith .jar. Deployment method. Default: auto.

Входы

azureSubscription - #REF! подписка
. Обязательно.

Указывает подключение Azure Resource Manager подписка для развертывания.

типа приложения
. Обязательно. Разрешённые значения: webApp (веб-приложение на #REF!), webAppLinux (веб-приложение на Linux).

Указывает тип веб-приложения #REF!.

имя приложения
. Обязательно.

Указывает имя существующего Служба приложений Azure. Будут перечислены только службы приложений, основанные на выбранном типе приложения.

deployToSlotOrASE - Развернуть в слот или Среда службы приложений
. Необязательный. Используется при . Значение по умолчанию: .

Выбирает опцию развертывания в существующем слоте развертывания или Azure Среда службы приложений.
Для обоих целевых объектов задача должна иметь имя группы ресурсов.
Если целевой объект развертывания является слотом, по умолчанию используется рабочий слот. Можно также указать любое другое существующее имя слота.
Если цель развертывания — Azure Среда службы приложений, оставьте имя слота как «production» и укажите название группы ресурсов.

группы ресурсов
. Требуется, если .

Название группы ресурсов требуется, когда цель развертывания — слот развертывания или Azure Среда службы приложений.
Указывает группу ресурсов #REF!, содержащую вышеуказанный Служба приложений Azure.

слота
. Требуется, если . Значение по умолчанию: .

Указывает существующий слот, за исключением рабочего слота.

пакет или папка
. Обязательно. Значение по умолчанию: .

Путь к пакету или папке, содержащей содержимое службы приложений, созданное MSBuild, сжатым ZIP-файлом или файлом войны. Поддерживаются переменные (BuildRelease) и подстановочные знаки. Например, или .

настраиваемую папку развертывания
. Необязательный. Используется при .

Указывает имя настраиваемой папки, в которую требуется развернуть.
Если поле пусто, пакет развертывается в .
Если введен корневой каталог, пакет развертывается в .
Во всех остальных экземплярах он развертывается в .

Веб-приложение в Linux предлагает два различных варианта публикации приложения: пользовательское развертывание образов (веб-приложение для контейнеров) и развертывание приложений со встроенным образом платформы (веб-приложение в Linux). Этот параметр доступен только в том случае, если веб-приложение Linux выбран в качестве типа приложения в задаче.

стека среды выполнения
. Необязательный. Используется при .

команда запуска
. Необязательный. Используется при .

Задает команду запуска.
Например:
dotnet run
dotnet filename.dll.

customWebConfig - Генерируйте web.config параметры для приложений Python, Node.js, Go и Java приложений
. Необязательный. Используется при .

Стандартный web.config будет сгенерирован и развернут на Служба приложений Azure, если в приложении его нет. Значения в web.config зависят от платформы приложений и могут быть изменены. Например, для приложения node.js web.config будет иметь файл запуска и iis_node значения модуля. Эта функция редактирования доступна только для созданных web.config.

параметров приложения
.

Укажите параметры приложения веб-приложения с помощью синтаксиса (например, ). Заключайте значения, содержащие пробелы в двойных кавычках (например, ).

параметры конфигурации
.

Укажите параметры конфигурации веб-приложения с помощью синтаксиса (например, ). Заключайте значения, содержащие пробелы в двойных кавычках.

метод развертывания
. Требуется, если . Допустимые значения: (автоматическое обнаружение), (ZIP-развертывание), (запуск из пакета). Значение по умолчанию: .

Выберите метод развертывания для приложения. Допустимые значения: автоза, zipDeployи runFromPackage.

Конфигурация контейнеров сайта
.

Предоставьте код JSON siteContainers-config для развертываний SiteContainers.

Параметры управления задачами

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

Выходные переменные

Эта задача определяет следующие выходные переменные, которые можно использовать в подчиненных шагах, заданиях и этапах.

AppServiceApplicationUrl
URL приложения выбранного Служба приложений Azure.

Замечания

Используйте эту задачу для развертывания веб-приложений в Служба приложений Azure.

Методы развертывания

В этой задаче доступны несколько методов развертывания. — это параметр по умолчанию.

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

В зависимости от типа Служба приложений Azure и агента Azure Pipelines, задача выбирает подходящую технологию развертывания. Ниже приведены различные технологии развертывания, используемые задачей:

REST API Kudu
Развертывание ZIP
RunFromPackage (RunFromPackage)

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

Если тип службы приложений — веб-приложение в приложении Linux, используйте Zip Deploy
Если предоставлен файл War, используйте War Deploy
Если указан jar-файл, используйте запуск из пакета
Для всех остальных используйте запуск из ZIP- (с помощью zip-развертывания)

На не #REF! агенте (для любого типа сервиса приложения) задача зависит от Kudu REST API для развертывания веб-приложения.

REST API Kudu

Kudu REST API работают с агентами автоматизации #REF! или Linux, когда цель — веб-приложение на #REF!, веб-приложение на Linux (встроенный исходный код) или функциональное приложение. Задача использует Kudu для копирования файлов в Служба приложений Azure.

Развертывание ZIP

Создает пакет развертывания .zip выбранного пакета или папки. Содержимое файла затем разворачивается в папку wwwroot функционального приложения в Служба приложений Azure. Этот параметр перезаписывает все существующие содержимое в папке wwwroot. Для получения дополнительной информации см. Zip deployment для Функции Azure.

RunFromPackage (RunFromPackage)

Создает тот же пакет развертывания, что и Zip Deploy. Однако вместо развертывания файлов в папке wwwroot, весь пакет монтируется через Функции Azure runtime. С помощью этого параметра файлы в папке wwwroot становятся доступны только для чтения. Для получения дополнительной информации см. Запусти Функции Azure из файла пакета.

Ошибка: Не удалось получить токен доступа для #REF!. Убедитесь, что используемый субъект-служба действителен и не истек.

Задача использует принципал сервиса в сервисном соединении для аутентификации с помощью #REF!. Если субъект-служба истек или не имеет разрешений для службы приложений, задача завершается ошибкой. Проверьте допустимость используемого субъекта-службы и ее наличие в регистрации приложения. Для получения дополнительной информации см. Use role based access control to manage access to access to your #REF! subscription resources. этой записи блога также содержит дополнительные сведения об использовании проверки подлинности субъекта-службы.

Ошибка SSL

Если вы хотите использовать сертификат в службе приложений, сертификат должен быть подписан доверенным центром сертификации. Если веб-приложение дает ошибки проверки сертификатов, вероятно, вы используете самозаверяющий сертификат. Задайте переменную с именем значением, в конвейере сборки или выпуска, чтобы устранить ошибку.

Выпуск зависает в течение длительного времени, а затем завершается сбоем

Эта проблема может быть результатом нехватки емкости в плане службы приложений. Чтобы устранить эту проблему, можно увеличить масштаб экземпляра службы приложений, чтобы увеличить доступное количество ЦП, ОЗУ и дискового пространства или попробовать использовать другой план службы приложений.

Коды ошибок 5xx

Если вы видите ошибку 5xx, проверьте статус вашего #REF! сервиса.

#REF! Function внезапно перестала работать

Функции Azure может внезапно перестать работать, если с момента последнего развертывания прошёл более года. При развертывании с помощью RunFromPackage в deploymentMethod создается SAS с датой окончания срока действия 1 года и задает значение "WEBSITE_RUN_FROM_PACKAGE" в конфигурации приложения. Функции Azure использует этот SAS для ссылки на файл пакета для выполнения функции, поэтому если срок действия SAS истёк, функция не будет выполнена. Чтобы устранить эту проблему, разверните еще раз, чтобы создать SAS с датой окончания срока действия в течение одного года.

Ошибка: пакет не найден с указанным шаблоном

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

Ошибка. Публикация с помощью параметра zip-развертывания не поддерживается для типа пакета msBuild

Веб-пакеты, созданные с помощью задачи MSBuild (с аргументами по умолчанию), имеют вложенную структуру папок, которая может быть развернута правильно только с помощью веб-развертывания. Параметр развертывания публикации в ZIP не может использоваться для развертывания этих пакетов. Чтобы преобразовать структуру упаковки, выполните следующие действия.

В задаче решения сборки измените аргументы MSBuild на :

снимок экрана со значениями решения сборки.
Добавьте задачу "Архив" и измените значения следующим образом:
1. Измените корневую папку или файл, чтобы архивировать на .
2. Снимите имя корневой папки prepend, чтобы архивировать пути флажок:
  
  снимок экрана, на котором показаны значения архива.

Часто задаваемые вопросы

Какова разница между задачами и ?

Задача #REF! Web App (#REF!WebApp) — самый простой способ развернуть её в #REF! веб-приложении. По умолчанию развертывание происходит в корневом приложении #REF! Web App.

Задача Служба приложений Azure Deployment (AzureRmWebAppDeployment) может работать с более пользовательскими сценариями, такими как:

изменение параметров конфигурации в веб-пакетах и XML-файлах параметров.
развертывание с помощью веб-развертывания, если вы используете процесс развертывания IIS.
Развертывание в виртуальных приложениях.
Развертывание в других типах приложений, таких как приложения-контейнеры, приложения-функции, веб-задания или API и мобильные приложения.

Заметка

Преобразования файлов и подстановка переменных также поддерживаются отдельной задачей File Transformation для использования в Azure Pipelines. Задачу преобразования файлов можно использовать для применения преобразований файлов и подстановок переменных для любых файлов конфигурации и параметров.

Развертывание веб-приложений на #REF! прошло успешно, но приложение не работает

Это может быть связано с тем, что web.config отсутствует в приложении. Вы можете добавить файл web.config в источник или автоматически создать файл с помощью параметров приложения и конфигурации.

Нажмите на задачу и перейдите в Generate web.config параметры для Python, Node.js, Go и Java приложений.

снимок экрана диалогового окна "Создание web.config параметров".
Нажмите кнопку "Дополнительно" , чтобы изменить параметры.

снимок экрана раскрывающегося окна.
Выберите тип приложения в раскрывающемся списке.
Нажмите кнопку "ОК". Это приведет к заполнению параметров web.config, необходимых для создания web.config.

Развертывание веб-приложений в Среда службы приложений (ASE) не работает

Убедитесь, что агент сборки Azure DevOps находится на той же VNET (подсеть может отличаться), что и внутренний Load Balancer (ILB) ASE. Это позволит агенту получать код из Azure DevOps и развертывать его в ASE.
Если вы используете Azure DevOps, агенту не обязательно быть доступен из интернета, ему нужен только исходящий доступ для подключения к Azure DevOps Service.
Если вы используете TFS/Azure DevOps Server, развернутый в виртуальная сеть, агент может быть полностью изолирован.
Агент сборки должен быть настроен с конфигурацией DNS веб-приложения, в которую необходимо развернуть. Частные ресурсы в виртуальная сеть не содержат записей в Azure DNS, поэтому их нужно добавить в файл хоста на агентной машине.
Если для конфигурации ASE используется самозаверяющий сертификат, в задаче развертывания для MSDeploy необходимо задать параметр . Также рекомендуется задать для переменной значение . Если сертификат из центра сертификации используется для конфигурации ASE, это не обязательно.

Как настроить подключение службы?

Эта задача требует подключения Azure Resource Manager сервиса.

Как настроить развертывание веб-заданий с помощью Application Insights?

При развертывании в службе приложений, если вы настроили Application Insights и включили , необходимо также включить . Включение этого параметра сохраняет расширение Application Insights в безопасном состоянии. Этот шаг необходим, так как приложение Application Insights постоянного веб-задания устанавливается в папку App_Data.

Как настроить агент, если он находится за прокси-сервером во время развертывания в Службе приложений?

Если для локального агента требуется веб-прокси, можно сообщить агенту о прокси-сервере во время настройки. Это позволяет вашему агенту подключаться к Azure Pipelines или Azure DevOps Server через прокси. Узнайте больше о запуске локального агента за веб-прокси.

Примеры

Ниже приведён пример фрагмента YAML для развертывания веб-приложения в #REF! Web App Service, работающий на #REF!.

variables:
  azureSubscription: Contoso
  # To ignore SSL error uncomment the below variable
  # VSTS_ARM_REST_IGNORE_SSL_ERRORS: true

steps:

- task: AzureWebApp@1
  displayName: Azure Web App Deploy
  inputs:
    azureSubscription: $(azureSubscription)
    appName: samplewebapp
    package: $(System.DefaultWorkingDirectory)/**/*.zip

Чтобы развернуть веб-приложение в Linux, добавьте параметр и задайте для него значение .

Чтобы указать метод развертывания в качестве zip-развертывания, добавьте параметр . Другим поддерживаемым значением этого параметра является .

Если это не указано, является значением по умолчанию.

Требования

Требование	Описание
Типы конвейеров	YAML, классическая сборка, классический выпуск
Выполняется в	Агент, DeploymentGroup
требования	Никакой
возможностей	Эта задача не удовлетворяет требованиям к последующим задачам в задании.
ограничения команд	Любой
переменные settable	Любой
Версия агента	2.209.0 или более поздней версии
Категория задач	Развертывать

Требование	Описание
Типы конвейеров	YAML, классическая сборка, классический выпуск
Выполняется в	Агент, DeploymentGroup
требования	Никакой
возможностей	Эта задача не удовлетворяет требованиям к последующим задачам в задании.
ограничения команд	Любой
переменные settable	Любой
Версия агента	2.104.1 или более поздней версии
Категория задач	Развертывать

Обратная связь

Были ли сведения на этой странице полезными?

Last updated on 2026-03-06