Nota
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
Actualice una aplicación de funciones con un contenedor de Docker.
Sintaxis
# Azure Functions for container v1
# Update a function app with a Docker container.
- task: AzureFunctionAppContainer@1
inputs:
azureSubscription: # string. Required. Azure subscription.
appName: # string. Required. 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.
imageName: # string. Required. Image name.
#containerCommand: # string. Startup command.
# Application and Configuration Settings
#appSettings: # string. App settings.
#configurationStrings: # string. Configuration settings.
Entradas
azureSubscription
-
de suscripción de Azure
string
. Obligatorio.
Selecciona el de suscripción de Azure Resource Manager para la implementación.
de nombre de aplicación de
string
. Obligatorio.
Nombre de function App for Containers.
deployToSlotOrASE
-
implementación en ranuras o app Service Environment
boolean
. Valor predeterminado: false
.
Establezca esta entrada en true
para implementar en una ranura de implementación existente o azure App Service Environment. La tarea necesita un nombre de grupo de recursos para ambos destinos. Para la opción de ranura de implementación, el valor predeterminado se implementa en el ranura de producción, o puede especificar cualquier otro nombre de ranura existente. Si el destino de implementación es un entorno de Azure App Service, deje el nombre de la ranura como de producción y especifique el nombre del grupo de recursos.
del grupo de recursos de resourceGroupName
-
string
. Obligatorio cuando deployToSlotOrASE = true
.
Nombre del grupo de recursos que contiene function App for Containers.
de ranura de
string
. Obligatorio cuando deployToSlotOrASE = true
. Valor predeterminado: production
.
Especifica o selecciona una ranura existente, excluyendo la ranura de producción.
imageName
-
nombre de imagen
string
. Obligatorio.
Un nombre de dominio de nivel superior único global para su registro o espacio de nombres específico.
Nota: Un nombre de imagen completo tendrá el formato: <registry or namespace> <repository> <tag>
. Por ejemplo: myregistry.azurecr.io/nginx:latest
.
containerCommand
-
comando Startup
string
.
Comando de inicio que se ejecuta después de la implementación. Por ejemplo, dotnet run
dotnet filename.dll.
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"
).
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.
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 esta tarea para implementar una función de Azure en Linux mediante una imagen personalizada .
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 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 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.
¿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.
Ejemplos
En este ejemplo se implementa Azure Functions en Linux mediante contenedores:
variables:
imageName: contoso.azurecr.io/azurefunctions-containers:$(build.buildId)
azureSubscription: Contoso
# To ignore SSL error uncomment the following variable
# VSTS_ARM_REST_IGNORE_SSL_ERRORS: true
steps:
- task: AzureFunctionAppContainer@1
displayName: Azure Function App on Container deploy
inputs:
azureSubscription: $(azureSubscription)
appName: functionappcontainers
imageName: $(imageName)
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 | Cualquiera |
variables settable | Cualquiera |
Versión del agente | 2.104.1 o superior |
Categoría de tarea | Desplegar |