AzureFunctionApp@1: tarea azure Functions v1

Actualice una aplicación de funciones con .NET, Python, JavaScript, PowerShell, aplicaciones web basadas en Java.

Sintaxis

# Azure Functions Deploy v1
# Update a function app with .NET, Python, JavaScript, PowerShell, Java based web applications.
- task: AzureFunctionApp@1
  inputs:
    azureSubscription: # string. Required. Azure Resource Manager connection. 
    appType: # 'functionApp' | 'functionAppLinux'. Required. App type. 
    appName: # string. Required. Azure Functions App name. 
    #deployToSlotOrASE: false # boolean. 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.
    #runtimeStack: # 'DOTNET|6.0' | 'DOTNET-ISOLATED|6.0' | 'DOTNET-ISOLATED|7.0' | 'DOTNET-ISOLATED|8.0' | 'JAVA|8' | 'JAVA|11' | 'JAVA|17' | 'JAVA|21' | 'NODE|14' | 'NODE|16' | 'NODE|18' | 'NODE|20' | 'PYTHON|3.8' | 'PYTHON|3.9' | 'PYTHON|3.10' | 'PYTHON|3.11'. Optional. Use when appType = functionAppLinux. Runtime stack. 
    #startUpCommand: # string. Optional. Use when appType = functionAppLinux. Startup command. 
  # Application and Configuration Settings
    #customWebConfig: # string. Optional. Use when appType != functionAppLinux && 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 != functionAppLinux && appType != "" && package NotEndsWith .war && Package NotEndsWith .jar. Deployment method. Default: auto.

Entradas

azureSubscription - de conexión de Azure Resource Manager
string. Obligatorio.

Selecciona la suscripción de Azure Resource Manager para la implementación.

appType - tipo de aplicación
string. Obligatorio. Valores permitidos: functionApp (Function App en Windows), functionAppLinux (Function App en Linux).

appName - nombre de aplicación de Azure Functions
string. Obligatorio.

Escribe o selecciona el nombre de una aplicación de Azure Functions existente. Las aplicaciones de funciones enumeradas se basarán en el tipo de aplicación seleccionado.

deployToSlotOrASE - implementación en ranuras o app Service Environment
boolean. Valor predeterminado: false.

Implementa en una ranura de implementación existente o en Azure App Service Environment. Para ambos destinos, la tarea necesita un nombre de grupo de recursos.

Si el destino de implementación es una ranura, el valor predeterminado será el ranura de producción. También se puede proporcionar cualquier otro nombre de ranura existente.

Si el destino de implementación es un entorno de Azure App Service, deje el nombre de ranura como de producción y especifique el nombre del grupo de recursos.

del grupo de recursos de
string. Obligatorio cuando deployToSlotOrASE = true.

El nombre del grupo de recursos es necesario cuando el destino de implementación es una ranura de implementación o una instancia de App Service Environment.

Escribe o selecciona el grupo de recursos de Azure que contiene el Servicio de aplicaciones de Azure especificado anteriormente.

de ranura de
string. Obligatorio cuando deployToSlotOrASE = true. Valor predeterminado: production.

Especifica o selecciona una ranura existente, excepto la ranura producción.

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

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

de pila en tiempo de ejecución de
string. Opcional. Use cuando appType = functionAppLinux. Valores permitidos: DOTNET|6.0, DOTNET-ISOLATED|6.0, DOTNET-ISOLATED|7.0, DOTNET-ISOLATED|8.0, JAVA|8, JAVA|11, JAVA|17, JAVA|21, NODE|14, NODE|16, NODE|18, NODE|20, PYTHON|3.8, PYTHON|3.9, PYTHON|3.10, PYTHON|3.11.

Especifique el marco y la versión en la que se ejecutará la aplicación de funciones. Puede usar cualquiera de las versiones de tiempo de ejecución admitidas . Los valores antiguos como DOCKER|microsoft/azure-functions-* están en desuso. Los nuevos valores se muestran en la lista desplegable del asistente de tareas de . Si hay una versión más reciente de un marco disponible en la versiones en tiempo de ejecución compatibles puede especificarla incluso si no está en la lista.

startUpCommand - comando Startup
string. Opcional. Use cuando appType = functionAppLinux.

Escribe el comando de inicio. Por ejemplo:

dotnet run
dotnet filename.dll

customWebConfig - Generar parámetros de web.config para aplicaciones python, Node.js, Go y Java
string. Opcional. Use cuando appType != functionAppLinux && 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 generado web.config.

de configuración de la aplicación de
string.

Escriba la configuración de la aplicación con la sintaxis -key value (por ejemplo, -Port 5000-RequestTimeout 5000-WEBSITE_TIME_ZONE). Incluya valores que contengan espacios entre comillas dobles (por ejemplo: "Eastern Standard Time").

Para más información sobre la configuración de la aplicación, consulte Variables de entorno y configuración de la aplicación en Azure App Service.

configurationStrings - opciones de configuración
string.

Escriba las cadenas de configuración mediante la sintaxis -key value (por ejemplo: -phpVersion 5.6-linuxFxVersion: node|6.11). Incluya valores que contengan espacios entre comillas dobles.

de método de implementación de
string. Obligatorio cuando appType != functionAppLinux && appType != "" && package NotEndsWith .war && Package NotEndsWith .jar. Valores permitidos: auto (detección automática), zipDeploy (Implementación zip), runFromPackage (Implementación zip con ejecución desde paquete). Valor predeterminado: auto.

Elige el método de implementación para la aplicación.

Opciones de control de tareas

Todas las tareas tienen opciones de control además de sus entradas de tarea. Para obtener más información, consulte 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
La dirección URL de la aplicación del servicio de aplicaciones seleccionado.

Observaciones

Use la tarea Aplicación de funciones de Azure para implementar funciones de en Azure.

Métodos de implementación

Hay varios métodos de implementación disponibles en esta tarea. El valor predeterminado es auto.

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

En función del tipo de agente de Azure App Service y Azure Pipelines, la tarea usa una tecnología de implementación adecuada. Las tecnologías de implementación que usan las tareas son las siguientes:

• de la API REST de Kudu
• Zip Deploy
• ejecutar desde el paquete

De forma predeterminada, la tarea intenta seleccionar la tecnología de implementación adecuada en función del paquete de entrada, el tipo de App Service y el sistema operativo del agente.

• Si se proporciona un script posterior a la implementación, use Zip Deploy.
• Si el tipo de App Service es Aplicación web en Linux, use Zip Deploy.
• Si se proporciona un archivo .war, use War Deploy.
• Si se proporciona un archivo .jar, use Run-From-Zip.
• Para todas las demás tareas, use Ejecutar desde paquete (a través de Zip Deploy).

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

Kudu REST API

El API rest de Kudu funciona en agentes de automatización de Windows y Linux cuando el destino es una aplicación web en Windows, una aplicación web en Linux (origen integrado) o una aplicación de funciones. La tarea usa Kudu para copiar archivos en Azure App Service.

Implementación de Zip

Zip Deploy crea un paquete de implementación de .zip a partir del paquete o carpeta elegido. A continuación, implementa el contenido del archivo en la carpeta wwwroot de la aplicación de funciones de nombre de App Service en Azure. Esta opción sobrescribe todo el contenido existente en la carpeta wwwroot. Para más información, consulte implementación de Zip para Azure Functions.

Ejecutar desde el paquete

Ejecutar desde paquete crea el mismo paquete de implementación que Zip Deploy. En lugar de implementar archivos en la carpeta wwwroot, el entorno de ejecución de Functions monta todo el paquete. Cuando se usa esta opción, los archivos de la carpeta wwwroot se convierten en de solo lectura. Para más información, consulte Ejecución de Azure Functions desde un archivo de paquete.

Solución de problemas

Error: No se pudo capturar 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 un error en la tarea. Compruebe la validez de la entidad de servicio usada y que esté presente 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 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 ssl

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

Una versión se bloquea durante mucho tiempo y, a continuación, se produce un error

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

5 códigos de error xxxx

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

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

Azure Functions puede dejar de funcionar repentinamente 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 un artefacto en la compilación o una fase anterior y se descarga en el trabajo actual.

Error: No se admite publicar con la opción de implementación zip para el tipo de paquete msBuild.

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

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

   

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

   1. Cambie carpeta raíz o archivo para archivar a $(System.DefaultWorkingDirectory)\\WebAppContent.

   2. Desactive la casilla Nombre de carpeta raíz anteponer para archivar rutas de acceso:

      

La implementación de la aplicación de funciones en Windows se realiza correctamente, pero la aplicación no funciona

Este problema podría producirse si un archivo 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 de la tarea.

1. Seleccione la tarea y vaya a Generar parámetros de web.config para Python, Node.js, Go y Aplicaciones Java:

   

2. Seleccione el botón Más (...) en Generar parámetros de web.config para Python, Node.js, Go y Aplicaciones Java para editar los parámetros:

   

3. Seleccione el tipo de aplicación en la lista Application Framework.

4. Seleccione Aceptar. Al hacerlo, se rellenarán los parámetros web.config necesarios para generar el archivo web.config.

Preguntas más frecuentes

¿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 trabajos web con Application Insights?

Al implementar en una instancia de App Service, si ha configurado Application Insights 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 en un estado seguro. Este paso es necesario porque el trabajo web continuo de Application Insights se instala en la carpeta App_Data.

¿Cómo debo configurar mi agente si está detrás de un proxy mientras estoy implementando 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.

No puedo implementar en una instancia interna de App Service Environment mediante una conexión de servicio de Azure Resource Manager y un agente hospedado por Microsoft

Por diseño, un agente hospedado por Microsoft no funcionará con una instancia de App Service Environment. En su lugar, debe configurar un agente privado en una máquina virtual que se encuentra en la misma red virtual que App Service Environment. Además, establezca una zona DNS privada para habilitar la comunicación entre los recursos.

Ejemplos

Este es un fragmento de código YAML de ejemplo que implementa funciones de Azure en Windows:

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

steps:
- task: AzureFunctionApp@1
  displayName: Azure Function App Deploy
  inputs:
    azureSubscription: $(azureSubscription)
    appName: samplefunctionapp
    appType: functionApp
    package: $(System.DefaultWorkingDirectory)/**/*.zip

Para implementar una función en Linux, agregue el parámetro appType y establézcalo en appType: functionAppLinux. Si no especifica un valor, functionApp es el valor predeterminado.

Para especificar explícitamente el método de implementación como Zip Deploy, agregue el parámetro deploymentMethod: zipDeploy. Otro valor admitido para este parámetro es runFromPackage. Si no especifica un valor, auto es el valor predeterminado.

Para ver un tutorial que muestra cómo crear una canalización de CI/CD, consulte Compilación e implementación de Java en Azure Functions.

Requisitos

Requisito	Descripción
Tipos de canalización	YAML, compilación clásica, versión clásica
Se ejecuta en	Agente, DeploymentGroup
demandas	Ninguno
funcionalidades de	Esta tarea no satisface ninguna demanda de tareas posteriores en el trabajo.
restricciones de comandos	Cualquier
variables settable	Cualquier
Versión del agente	2.104.1 o superior
Categoría de tarea	Desplegar