ServiceFabricDeploy@1: tarea de implementación de aplicaciones de Service Fabric v1

Use esta tarea para implementar una aplicación de Service Fabric en un clúster. Esta tarea implementa una aplicación de Azure Service Fabric en un clúster según la configuración definida en el perfil de publicación.

Nota:

Esta tarea no admite la autenticación de Azure Resource Manager con la federación de identidades de flujo de trabajo.

Syntax

# Service Fabric application deployment v1
# Deploy an Azure Service Fabric application to a cluster.
- task: ServiceFabricDeploy@1
  inputs:
    applicationPackagePath: # string. Required. Application Package. 
    serviceConnectionName: # string. Required. Cluster Service Connection. 
    #publishProfilePath: # string. Publish Profile. 
    #applicationParameterPath: # string. Application Parameters. 
    #overrideApplicationParameter: false # boolean. Override Application Parameters. Default: false.
  # Advanced Settings
    #compressPackage: false # boolean. Compress Package. Default: false.
    #copyPackageTimeoutSec: # string. CopyPackageTimeoutSec. 
    #registerPackageTimeoutSec: # string. RegisterPackageTimeoutSec. 
    overwriteBehavior: 'SameAppTypeAndVersion' # 'Always' | 'Never' | 'SameAppTypeAndVersion'. Required. Overwrite Behavior. Default: SameAppTypeAndVersion.
    #skipUpgradeSameTypeAndVersion: false # boolean. Skip upgrade for same Type and Version. Default: false.
    #skipPackageValidation: false # boolean. Skip package validation. Default: false.
  # Upgrade Settings
    #useDiffPackage: false # boolean. Use Diff Package. Default: false.
    #overridePublishProfileSettings: false # boolean. Override All Publish Profile Upgrade Settings. Default: false.
    #isUpgrade: true # boolean. Optional. Use when overridePublishProfileSettings = true. Upgrade the Application. Default: true.
    #unregisterUnusedVersions: true # boolean. Unregister Unused Versions. Default: true.
    #upgradeMode: 'Monitored' # 'Monitored' | 'UnmonitoredAuto' | 'UnmonitoredManual'. Required when overridePublishProfileSettings = true && isUpgrade = true. Upgrade Mode. Default: Monitored.
    #FailureAction: 'Rollback' # 'Rollback' | 'Manual'. Required when overridePublishProfileSettings = true && isUpgrade = true && upgradeMode = Monitored. FailureAction. Default: Rollback.
    #UpgradeReplicaSetCheckTimeoutSec: # string. Optional. Use when overridePublishProfileSettings = true && isUpgrade = true. UpgradeReplicaSetCheckTimeoutSec. 
    #TimeoutSec: # string. Optional. Use when overridePublishProfileSettings = true && isUpgrade = true. TimeoutSec. 
    #ForceRestart: false # boolean. Optional. Use when overridePublishProfileSettings = true && isUpgrade = true. ForceRestart. Default: false.
    #HealthCheckRetryTimeoutSec: # string. Optional. Use when overridePublishProfileSettings = true && isUpgrade = true && upgradeMode = Monitored. HealthCheckRetryTimeoutSec. 
    #HealthCheckWaitDurationSec: # string. Optional. Use when overridePublishProfileSettings = true && isUpgrade = true && upgradeMode = Monitored. HealthCheckWaitDurationSec. 
    #HealthCheckStableDurationSec: # string. Optional. Use when overridePublishProfileSettings = true && isUpgrade = true && upgradeMode = Monitored. HealthCheckStableDurationSec. 
    #UpgradeDomainTimeoutSec: # string. Optional. Use when overridePublishProfileSettings = true && isUpgrade = true && upgradeMode = Monitored. UpgradeDomainTimeoutSec. 
    #ConsiderWarningAsError: false # boolean. Optional. Use when overridePublishProfileSettings = true && isUpgrade = true && upgradeMode = Monitored. ConsiderWarningAsError. Default: false.
    #DefaultServiceTypeHealthPolicy: # string. Optional. Use when overridePublishProfileSettings = true && isUpgrade = true && upgradeMode = Monitored. DefaultServiceTypeHealthPolicy. 
    #MaxPercentUnhealthyDeployedApplications: # string. Optional. Use when overridePublishProfileSettings = true && isUpgrade = true && upgradeMode = Monitored. MaxPercentUnhealthyDeployedApplications. 
    #UpgradeTimeoutSec: # string. Optional. Use when overridePublishProfileSettings = true && isUpgrade = true && upgradeMode = Monitored. UpgradeTimeoutSec. 
    #ServiceTypeHealthPolicyMap: # string. Optional. Use when overridePublishProfileSettings = true && isUpgrade = true && upgradeMode = Monitored. ServiceTypeHealthPolicyMap. 
  # Docker Settings
    #configureDockerSettings: false # boolean. Configure Docker settings. Default: false.
    #registryCredentials: 'AzureResourceManagerEndpoint' # 'AzureResourceManagerEndpoint' | 'ContainerRegistryEndpoint' | 'UsernamePassword'. Required when configureDockerSettings = true. Registry Credentials Source. Default: AzureResourceManagerEndpoint.
    #dockerRegistryConnection: # string. Alias: dockerRegistryEndpoint. Required when configureDockerSettings = true && registryCredentials = ContainerRegistryEndpoint. Docker Registry Service Connection. 
    #azureSubscription: # string. Alias: azureSubscriptionEndpoint. Required when configureDockerSettings = true && registryCredentials = AzureResourceManagerEndpoint. Azure subscription. 
    #registryUserName: # string. Optional. Use when configureDockerSettings = true && registryCredentials = UsernamePassword. Registry User Name. 
    #registryPassword: # string. Optional. Use when configureDockerSettings = true && registryCredentials = UsernamePassword. Registry Password. 
    #passwordEncrypted: true # boolean. Optional. Use when configureDockerSettings = true && registryCredentials = UsernamePassword. Password Encrypted. Default: true.

Entradas

applicationPackagePath - Paquete de aplicación
string. Obligatorio.

Especifica la ruta de acceso al paquete de aplicación que se va a implementar. Las variables y los caracteres comodín se pueden usar en la ruta de acceso.

serviceConnectionName - Conexión de servicio de clúster
string. Obligatorio.

Especifica la conexión de servicio de Azure Service Fabric que se va a usar para conectarse al clúster. La configuración definida en esta conexión de servicio a la que se hace referencia invalida las definidas en el perfil de publicación. Elija Manage registrar una nueva conexión de servicio.

Para conectarse al clúster, la tarea de Service Fabric usa el almacén de certificados de máquina para almacenar la información sobre el certificado. Si dos versiones se ejecutan juntas en un equipo con el mismo certificado, se iniciarán correctamente. Sin embargo, si se completa una de las tareas, se limpiará el certificado del almacén de certificados de la máquina, lo que afecta a la segunda versión.

publishProfilePath - Publicar perfil
string.

Opcional. Especifica la ruta de acceso al archivo de perfil de publicación que define la configuración que se va a usar. Las variables y los caracteres comodín se pueden usar en la ruta de acceso. Obtenga más información sobre cómo crear perfiles de publicación en Visual Studio.

applicationParameterPath - Parámetros de la aplicación
string.

Opcional. Especifica la ruta de acceso al archivo de parámetros de la aplicación. Las variables y los caracteres comodín se pueden usar en la ruta de acceso. Si se especifica, esto invalida el valor del perfil de publicación. Obtenga más información sobre cómo crear un archivo de parámetros de aplicación en Visual Studio.

overrideApplicationParameter - Invalidar parámetros de aplicación
boolean. Valor predeterminado: false.

Opcional. Especifica las variables definidas en la canalización de compilación o versión que coinciden con las Parameter Name entradas del archivo de manifiesto de aplicación. Obtenga más información sobre cómo crear un archivo de parámetros de aplicación en Visual Studio. Ejemplo:

 <Parameters> 
 <Parameter Name="SampleApp_PartitionCount" Value="1" /> 
 <Parameter Name="SampleApp_InstanceCount" DefaultValue="-1" /> 
 </Parameters>

Si la aplicación tiene un parámetro definido como en el ejemplo anterior y desea cambiar el recuento de particiones a 2, puede definir una canalización de versión o una variable SampleApp_PartitionCount de entorno y su valor como 2.

Nota

Si las mismas variables se definen en la canalización de versión y en el entorno, las variables de entorno reemplazarán las variables de canalización de versión.

compressPackage - Comprimir paquete
boolean. Valor predeterminado: false.

Opcional. Especifica si el paquete de aplicación debe comprimirse antes de copiarlo en el almacén de imágenes. Si está habilitado, esto invalida el valor en el perfil de publicación. Obtenga más información sobre la compresión de paquetes.

copyPackageTimeoutSec - CopyPackageTimeoutSec
string.

Opcional. Especifica el tiempo de espera en segundos para copiar el paquete de aplicación en el almacén de imágenes. Si se especifica, esto invalida el valor del perfil de publicación.

registerPackageTimeoutSec - RegisterPackageTimeoutSec
string.

Opcional. Especifica el tiempo de espera en segundos para registrar o anular el registro de un paquete de aplicación.

overwriteBehavior - Sobrescribir el comportamiento
string. Obligatorio. Valores permitidos: Always, Never y SameAppTypeAndVersion. Valor predeterminado: SameAppTypeAndVersion.

Sobrescribe el comportamiento si una aplicación existe en el clúster con el mismo nombre y no se han configurado las actualizaciones.

Never no quitará la aplicación existente. Este es el comportamiento predeterminado.

Always quitará la aplicación existente, incluso si su tipo de aplicación y la versión son diferentes de la aplicación que se va a crear.

SameAppTypeAndVersion quitará la aplicación existente solo si su tipo de aplicación y la versión son iguales que la aplicación que se va a crear.

skipUpgradeSameTypeAndVersion - Omitir la actualización para el mismo tipo y versión
boolean. Valor predeterminado: false.

Opcional. Especifica si se omitirá una actualización si el mismo tipo de aplicación y versión ya existe en el clúster; de lo contrario, se produce un error en la actualización durante la validación. Si se habilita esta opción, las reimplementaciones son idempotentes.

skipPackageValidation - Omitir validación de paquetes
boolean. Valor predeterminado: false.

Opcional. Especifica si el paquete se debe validar o no antes de la implementación. Obtenga más información sobre la validación de paquetes.

useDiffPackage - Uso del paquete diff
boolean. Valor predeterminado: false.

Opcional. Actualiza mediante un paquete de diferencias que contiene solo los archivos de aplicación actualizados, el manifiesto de aplicación actualizado y los archivos de manifiesto de servicio.

Se crea un paquete de diferencias comparando el paquete especificado en la entrada del paquete de aplicación con el paquete registrado actualmente en el clúster de destino. Si una versión de servicio del paquete actual del clúster es la misma que el nuevo paquete, este paquete de servicio se quitará del nuevo paquete de aplicación. Obtenga más información sobre los paquetes de diferencias.

overridePublishProfileSettings - Invalidar toda la configuración de actualización del perfil de publicación
boolean. Valor predeterminado: false.

Opcional. Invalida toda la configuración de actualización con valores especificados o con el valor predeterminado (si no se especifica). Obtenga más información sobre la configuración de actualización.

isUpgrade - Actualización de la aplicación
boolean. Opcional. Use cuando overridePublishProfileSettings = true. Valor predeterminado: true.

Sobrescribe la aplicación si el valor está establecido en false.

unregisterUnusedVersions - Anular el registro de versiones sin usar
boolean. Valor predeterminado: true.

Opcional. Indica si todas las versiones sin usar del tipo de aplicación se quitarán después de una actualización.

upgradeMode - Modo de actualización
string. Necesario cuando overridePublishProfileSettings = true && isUpgrade = true. Valores permitidos: Monitored, UnmonitoredAuto y UnmonitoredManual. Valor predeterminado: Monitored.

FailureAction - FailureAction
string. Necesario cuando overridePublishProfileSettings = true && isUpgrade = true && upgradeMode = Monitored. Valores permitidos: Rollback, Manual. Valor predeterminado: Rollback.

UpgradeReplicaSetCheckTimeoutSec - UpgradeReplicaSetCheckTimeoutSec
string. Opcional. Use cuando overridePublishProfileSettings = true && isUpgrade = true.

TimeoutSec - TimeoutSec
string. Opcional. Use cuando overridePublishProfileSettings = true && isUpgrade = true.

ForceRestart - ForceRestart
boolean. Opcional. Use cuando overridePublishProfileSettings = true && isUpgrade = true. Valor predeterminado: false.

HealthCheckRetryTimeoutSec - HealthCheckRetryTimeoutSec
string. Opcional. Use cuando overridePublishProfileSettings = true && isUpgrade = true && upgradeMode = Monitored.

HealthCheckWaitDurationSec - HealthCheckWaitDurationSec
string. Opcional. Use cuando overridePublishProfileSettings = true && isUpgrade = true && upgradeMode = Monitored.

HealthCheckStableDurationSec - HealthCheckStableDurationSec
string. Opcional. Use cuando overridePublishProfileSettings = true && isUpgrade = true && upgradeMode = Monitored.

UpgradeDomainTimeoutSec - UpgradeDomainTimeoutSec
string. Opcional. Use cuando overridePublishProfileSettings = true && isUpgrade = true && upgradeMode = Monitored.

ConsiderWarningAsError - ConsiderWarningAsError
boolean. Opcional. Use cuando overridePublishProfileSettings = true && isUpgrade = true && upgradeMode = Monitored. Valor predeterminado: false.

DefaultServiceTypeHealthPolicy - DefaultServiceTypeHealthPolicy
string. Opcional. Use cuando overridePublishProfileSettings = true && isUpgrade = true && upgradeMode = Monitored.

MaxPercentUnhealthyDeployedApplications - MaxPercentUnhealthyDeployedApplications
string. Opcional. Use cuando overridePublishProfileSettings = true && isUpgrade = true && upgradeMode = Monitored.

UpgradeTimeoutSec - UpgradeTimeoutSec
string. Opcional. Use cuando overridePublishProfileSettings = true && isUpgrade = true && upgradeMode = Monitored.

ServiceTypeHealthPolicyMap - ServiceTypeHealthPolicyMap
string. Opcional. Use cuando overridePublishProfileSettings = true && isUpgrade = true && upgradeMode = Monitored.

configureDockerSettings - Configuración de los valores de Docker
boolean. Valor predeterminado: false.

Configura la aplicación con la configuración de Docker especificada.

registryCredentials - Origen de credenciales del Registro
string. Necesario cuando configureDockerSettings = true. Valores permitidos: AzureResourceManagerEndpoint (Conexión de servicio de Azure Resource Manager), ContainerRegistryEndpoint (conexión del servicio Container Registry) UsernamePassword (nombre de usuario y contraseña). Valor predeterminado: AzureResourceManagerEndpoint.

Especifica cómo se proporcionan las credenciales del registro de Docker.

dockerRegistryConnection - Conexión del servicio del registro de Docker
Alias de entrada: dockerRegistryEndpoint. string. Necesario cuando configureDockerSettings = true && registryCredentials = ContainerRegistryEndpoint.

Especifica una conexión de servicio del registro de Docker. Obligatorio para los comandos que necesitan autenticarse con un registro.

Nota

La tarea intenta cifrar el secreto del Registro antes de transmitirlo al clúster de Service Fabric. Sin embargo, la tarea necesita que el certificado de servidor del clúster se instale en el equipo del agente. Si el certificado no está presente, el secreto del Registro no se cifrará.

azureSubscription - Suscripción de Azure
Alias de entrada: azureSubscriptionEndpoint. string. Necesario cuando configureDockerSettings = true && registryCredentials = AzureResourceManagerEndpoint.

Especifica una suscripción de Azure.

Nota

La tarea intentará cifrar el secreto del Registro antes de transmitirlo al clúster de Service Fabric. Sin embargo, la tarea necesita que el certificado de servidor del clúster se instale en el equipo del agente. Si el certificado no está presente, el secreto del Registro no se cifrará.

registryUserName - Nombre de usuario del Registro
string. Opcional. Use cuando configureDockerSettings = true && registryCredentials = UsernamePassword.

Especifica el nombre de usuario del registro de Docker.

registryPassword - Contraseña del Registro
string. Opcional. Use cuando configureDockerSettings = true && registryCredentials = UsernamePassword.

Especifica la contraseña del registro de Docker. Si la contraseña no está cifrada, debe usar una variable secreta de canalización de versión personalizada para almacenarla.

passwordEncrypted - Contraseña cifrada
boolean. Opcional. Use cuando configureDockerSettings = true && registryCredentials = UsernamePassword. Valor predeterminado: true.

Debe cifrar la contraseña mediante Invoke-ServiceFabricEncryptText. Si no lo hace y se instala un certificado que coincida con la huella digital del certificado de servidor en la conexión del servicio de clúster en el agente de compilación, ese certificado se usará para cifrar la contraseña; de lo contrario, se producirá un error.

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

Ninguno.

Comentarios

Use esta tarea para implementar una aplicación de Service Fabric en un clúster. Esta tarea implementa una aplicación de Azure Service Fabric en un clúster según la configuración definida en el perfil de publicación.

Service Fabric

Esta tarea usa una instalación de Service Fabric para conectarse e implementarse en un clúster de Service Fabric. Descargue e instale Service Fabric en el agente de compilación.

Requisitos

Requisito	Descripción
Tipos de canalización	YAML, compilación clásica, versión clásica
Se ejecuta en	Agente, DeploymentGroup
Peticiones	Los agentes autohospedados deben tener funcionalidades que coincidan con las siguientes demandas para ejecutar trabajos que usan esta tarea: Cmd
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	1.95.0 o superior
Categoría de la tarea:	Implementación