AzureWebApp@1: tarea Azure Web App v1

Esta tarea implementa una aplicación web de Azure para Linux o Windows.

Syntax

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

Entradas

azureSubscription - Suscripción de Azure
string. Obligatorio.

Especifica la conexión de suscripción de Azure Resource Manager para la implementación.

appType - Tipo de aplicación
string. Obligatorio. Valores permitidos: webApp (Web App en Windows), webAppLinux (Web App en Linux).

Especifica el tipo de aplicación web de Azure.

appName - Nombre de la aplicación
string. Obligatorio.

Especifica el nombre de un Azure App Service existente. Solo se mostrarán los servicios de aplicaciones basados en el tipo de aplicación seleccionado.

deployToSlotOrASE - Implementación en ranura o App Service Environment
boolean. Opcional. Use cuando appType != "". Valor predeterminado: false.

Selecciona la opción para implementar en una ranura de implementación existente o en un entorno de Azure App Service.
Para ambos destinos, la tarea necesita un nombre de grupo de recursos.
Si el destino de implementación es una ranura, el valor predeterminado es el espacio de producción. También se puede proporcionar cualquier otro nombre a la ranura existente.
Si el destino de implementación es un entorno de Azure App Service, deje el nombre de la ranura como "producción" y especifique el nombre del grupo de recursos.

resourceGroupName - Grupo de recursos
string. Necesario cuando deployToSlotOrASE = true.

El nombre del grupo de recursos es necesario cuando el destino de implementación es una ranura de implementación o un entorno de Azure App Service.
Especifica el grupo de recursos de Azure que contiene el Azure App Service indicado anteriormente.

slotName - Ranura
string. Necesario cuando deployToSlotOrASE = true. Valor predeterminado: production.

Especifica una ranura existente, excepto la ranura de producción.

package - Paquete o carpeta
string. Obligatorio. Valor predeterminado: $(System.DefaultWorkingDirectory)/**/*.zip.

Ruta de acceso del archivo al paquete o carpeta que contiene App Service contenido generado por MSBuild, un archivo ZIP comprimido o un archivo war. Se admiten variables (versión decompilación | ) y caracteres comodín. Por ejemplo, $(System.DefaultWorkingDirectory)/**/*.zip o $(System.DefaultWorkingDirectory)/**/*.war.

customDeployFolder - Carpeta de implementación personalizada
string. Opcional. Use cuando package EndsWith .war.

Especifica el nombre de carpeta personalizado en el que desea realizar la implementación.
Si el campo está vacío, el paquete se implementa en <appname>.azurewebsites.net/<warpackagename>.
Si se especifica ROOT, el paquete se implementa en <appname>.azurewebsited.net.
En todas las demás instancias, se implementa en <appname>.azurewebsited.net/<customWarName>.

runtimeStack - Pila en tiempo de ejecución
string. Opcional. Use cuando appType = webAppLinux.

Web App en Linux ofrece dos opciones diferentes para publicar la aplicación: implementación de imágenes personalizadas (Web App for Containers) e implementación de aplicaciones con una imagen de plataforma integrada (Web App en Linux). Este parámetro solo está disponible cuando la aplicación web de Linux está seleccionada como un tipo de aplicación en la tarea.

startUpCommand - Comando de inicio
string. Opcional. Use cuando appType = webAppLinux.

Especifica el comando de inicio.
Por ejemplo:
dotnet run
dotnet filename.dll.

customWebConfig - Generación de parámetros de web.config para aplicaciones python, Node.js, Go y Java
string. Opcional. Use cuando appType != webAppLinux && package NotEndsWith .war.

Se generará e implementará un web.config estándar en Azure App Service si la aplicación no tiene una. Los valores de web.config varían en función del marco de trabajo de la aplicación y se pueden editar. Por ejemplo, para la aplicación node.js, web.config tendrá un archivo de inicio y iis_node valores de módulo. Esta característica de edición solo es para el web.configgenerado .

appSettings - Configuración de la aplicación
string.

Especifique la configuración de la aplicación web mediante la sintaxis -key value (por ejemplo:-RequestTimeout 5000-Port 5000-WEBSITE_TIME_ZONE ). Incluya los valores que contienen espacios entre comillas dobles (por ejemplo: "Eastern Standard Time").

configurationStrings - Configuración
string.

Especifique los valores de configuración de la aplicación web mediante la sintaxis -key value (por ejemplo: -phpVersion 5.6-linuxFxVersion: node|6.11). Incluya los valores que contienen espacios entre comillas dobles.

deploymentMethod - Método de implementación
string. Necesario cuando appType != webAppLinux && appType != "" && package NotEndsWith .war && package NotEndsWith .jar. Valores permitidos: auto (detección automática), zipDeploy (Zip Deploy), runFromPackage (Ejecutar desde paquete). Valor predeterminado: auto.

Elija el método de implementación de la aplicación. Los valores aceptables son auto, zipDeploy y runFromPackage.

Opciones de control de tareas

Todas las tareas tienen opciones de control además de las entradas de tareas. Para obtener más información, vea Opciones de control y propiedades de tareas comunes.

Variables de salida

Esta tarea define las siguientes variables de salida, que puede consumir en pasos, trabajos y fases de bajada.

AppServiceApplicationUrl
Dirección URL de la aplicación del Azure App Service seleccionado.

Comentarios

Use esta tarea para implementar aplicaciones web en Azure App Service.

Métodos de implementación

Hay varios métodos de implementación disponibles en esta tarea. Auto es la opción predeterminada.

Para cambiar la opción de implementación basada en paquetes en la tarea del diseñador, expanda Opciones de implementación adicionales y habilite Seleccionar método de implementación.

La tarea elige una tecnología de implementación adecuada en función del tipo de agente de Azure App Service y Azure Pipelines. Las diferentes tecnologías de implementación usadas por la tarea son:

• API REST de Kudu
• Implementación de archivo ZIP
• RunFromPackage

De forma predeterminada, la tarea intenta seleccionar la tecnología de implementación adecuada según el paquete de entrada, el tipo de app service y el sistema operativo del agente.

• Cuando el tipo de servicio de aplicaciones es Aplicación web en una aplicación Linux, use Zip Deploy.
• Si se proporciona un archivo War, use War Deploy.
• Si se proporciona un archivo Jar, use Ejecutar desde paquete.
• Para todos los demás, use Ejecutar desde zip (a través de Zip Deploy)

En un agente que no sea de Windows (para cualquier tipo de servicio de aplicaciones), la tarea se basa en las API REST de Kudu para implementar la aplicación web.

API REST de Kudu

Las API REST de Kudu funcionan en agentes de automatización de Windows o Linux cuando el destino es Web App en Windows, Web App en Linux (origen integrado) o Function App. La tarea usa Kudu para copiar archivos en Azure App Service.

Implementación de archivo ZIP

Crea un paquete de implementación .zip del paquete o carpeta elegido. A continuación, el contenido del archivo se implementa en la carpeta wwwroot de la aplicación de funciones en Azure App Service. Esta opción sobrescribe todo el contenido existente en la carpeta wwwroot. Para más información, consulte Implementación de archivos ZIP en Azure Functions.

RunFromPackage

Crea el mismo paquete de implementación que para Implementación de archivo ZIP. Sin embargo, en lugar de implementar archivos en la carpeta wwwroot, el entorno de ejecución de Azure Functions monta todo el paquete. Con esta opción, los archivos de la carpeta wwwroot pasan a ser de solo lectura. Para más información, consulte Run your Azure Functions from a package file (Ejecución de Azure Functions desde un archivo de paquete).

Error: No se pudo recuperar el token de acceso para Azure. Compruebe si la entidad de servicio usada es válida y no ha expirado.

La tarea usa la entidad de servicio en la conexión de servicio para autenticarse con Azure. Si la entidad de servicio ha expirado o no tiene permisos para App Service, se produce este error en la tarea. Compruebe la validez de la entidad de servicio usada y que se encuentra en el registro de la aplicación. Para más información, consulte Uso del control de acceso basado en rol para administrar el acceso a los recursos de la suscripción de Azure. Esta entrada de blog también contiene más información sobre el uso de la autenticación de entidad de servicio.

Error de SSL

Si desea usar un certificado en App Service, dicho certificado debe estar firmado por una entidad de certificación de confianza. Si la aplicación web genera errores de validación del certificado, probablemente se esté usando un certificado autofirmado. Establezca una variable denominada VSTS_ARM_REST_IGNORE_SSL_ERRORS en el valor true de la canalización de compilación o versión para resolver el error.

Una versión se bloquea durante mucho tiempo y luego se produce un error.

Este problema podría ser el resultado de una capacidad insuficiente en el plan de App Service. Para resolverlo, puede escalar verticalmente la instancia de App Service para aumentar la CPU, la memoria RAM y el espacio en disco disponibles, o probar con un plan de App Service diferente.

Códigos de error 5xx

Si ve un error 5xx, compruebe el estado del servicio de Azure.

La función de Azure de repente dejó de funcionar

Azure Functions puede dejar de funcionar de repente si ha transcurrido más de un año desde la última implementación. Si implementa con "RunFromPackage" en "deploymentMethod", se genera una SAS con una fecha de expiración de 1 año y se establece como el valor de "WEBSITE_RUN_FROM_PACKAGE" en la configuración de la aplicación. Azure Functions usa esta SAS para hacer referencia al archivo de paquete para la ejecución de la función, por lo que si la SAS ha expirado, la función no se ejecutará. Para resolver este problema, vuelva a implementar para generar una SAS con una fecha de expiración de un año.

Error: No se encontró ningún paquete con el patrón especificado

Compruebe si el paquete mencionado en la tarea se publica como artefacto en la compilación o en una fase anterior y se descarga en el trabajo actual.

Error: la publicación mediante la opción de Implementación de archivo ZIP no se admite para el tipo de paquete MSBuild

Los paquetes web creados mediante la tarea MSBuild (con argumentos predeterminados) tienen una estructura de carpetas anidada que solo se puede implementar correctamente mediante Web Deploy. No se puede usar la opción de publicar en la implementación del archivo ZIP para implementar esos paquetes. Para convertir la estructura de empaquetado, siga estos pasos:

1. En la tarea Compilar solución, cambie los argumentos MSBuild a /p:DeployOnBuild=true /p:DeployDefaultTarget=WebPublish /p:WebPublishMethod=FileSystem /p:DeleteExistingFiles=True /p:publishUrl="$(System.DefaultWorkingDirectory)\\WebAppContent":

   

2. Agregue una tarea de archivar y cambie los valores de la siguiente manera:

   1. Cambie el archivo o carpeta raíz que se va a archivar a $(System.DefaultWorkingDirectory)\\WebAppContent.

   2. Desactive la casilla Anteponer el nombre de la carpeta raíz a las rutas de acceso de archivos:

      

Preguntas más frecuentes

¿Cuál es la diferencia entre las AzureWebApp tareas y AzureRmWebAppDeployment ?

La tarea Aplicación web de Azure (AzureWebApp) es la manera más sencilla de implementar en una aplicación web de Azure. De forma predeterminada, la implementación se produce en la aplicación raíz de la aplicación web de Azure.

La Azure App Service tarea Implementar (AzureRmWebAppDeployment) puede controlar escenarios más personalizados, como:

• Modifique las opciones de configuración dentro de paquetes web y archivos de parámetros XML.
• Implemente con Web Deploy, si se usa para el proceso de implementación de IIS.
• Implementación en aplicaciones virtuales.
• Implemente en otros tipos de aplicaciones, como aplicaciones de contenedor, aplicaciones de funciones, WebJobs o API y aplicaciones móviles.

Nota

Las transformaciones de archivos y la sustitución de variables también son compatibles con la tarea Transformación de archivos independiente para su uso en Azure Pipelines. Puede usar la tarea Transformación de archivos para aplicar transformaciones de archivo y sustituciones de variables en cualquier archivo de configuración y parámetros.

La implementación de la aplicación web en Windows se realizó correctamente, pero la aplicación no funciona

Esto puede deberse a que web.config no está presente en la aplicación. Puede agregar un archivo web.config al origen o generar uno automáticamente mediante la configuración y la aplicación.

• Haga clic en la tarea y vaya a Generar parámetros de web.config para python, Node.js, Aplicaciones de Go y Java.

  

• Haga clic en el botón ... más para editar los parámetros.

  

• Seleccione el tipo de aplicación en la lista desplegable.

• Haga clic en Aceptar. Esto rellenará los parámetros de web.config necesarios para generar web.config.

La implementación de la aplicación web en App Service Environment (ASE) no funciona

• Asegúrese de que el agente de compilación de Azure DevOps esté en la misma red virtual (la subred puede ser diferente) que la instancia interna de Load Balancer (ILB) de ASE. Esto permitirá que el agente extraiga el código de Azure DevOps e implemente en ASE.
• Si usa Azure DevOps, el agente no necesita ser accesible desde Internet, pero solo necesita acceso saliente para conectarse a Azure DevOps Service.
• Si usa TFS/Azure DevOps Server implementado en una red virtual, el agente se puede aislar completamente.
• El agente de compilación debe configurarse con la configuración DNS de la aplicación web en la que debe implementarse. Los recursos privados del Virtual Network no tienen entradas en Azure DNS, por lo que debe agregarse al archivo del host en el equipo del agente.
• Si se usa un certificado autofirmado para la configuración de ASE, la -allowUntrusted opción debe establecerse en la tarea de implementación para MSDeploy. También se recomienda establecer la variable VSTS_ARM_REST_IGNORE_SSL_ERRORS en true. Si se usa un certificado de una entidad de certificación para la configuración de ASE, no debería ser necesario.

¿Cómo debo configurar mi conexión de servicio?

Esta tarea requiere una conexión de servicio de Azure Resource Manager.

¿Cómo debo configurar la implementación de Webjob con Application Insights?

Al implementar en App Service, si tiene Application Insights configurado y ha habilitado Remove additional files at destination, también debe habilitar Exclude files from the App_Data folder. Al habilitar esta opción, la extensión de Application Insights se mantiene segura. Este paso es necesario porque el WebJob continuo de Application Insights está instalado en la carpeta App_Data.

¿Cómo debo configurar mi agente si está detrás de un proxy mientras se implementa en App Service?

Si el agente autohospedado requiere un proxy web, puede informar al agente sobre el proxy durante la configuración. Esto permite al agente conectarse a Azure Pipelines o Azure DevOps Server a través del proxy. Obtenga más información sobre cómo ejecutar un agente autohospedado detrás de un proxy web.

Ejemplos

A continuación se muestra un fragmento de código YAML de ejemplo para implementar la aplicación web en la App Service web de Azure que se ejecuta en Windows.

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

Para implementar Web App en Linux, agregue el appType parámetro y establézcalo appType: webAppLinuxen .

Para especificar el método de implementación como Implementación de archivo ZIP, agregue el parámetro deploymentMethod: zipDeploy. Otro valor admitido para este parámetro es runFromPackage.

Si no se especifica, auto es el valor predeterminado.

Requisitos

Requisito	Descripción
Tipos de canalización	YAML, compilación clásica, versión clásica
Se ejecuta en	Agente, DeploymentGroup
Peticiones	None
Capabilities	Esta tarea no satisface ninguna demanda de tareas posteriores en el trabajo.
Restricciones de comandos	Any
Variables que se pueden establecer	Any
Versión del agente	2.104.1 o superior
Categoría de la tarea:	Implementación