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.

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

paquete de aplicación de applicationPackagePath -
string. Obligatorio.

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

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

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

Para conectarse al clúster, la tarea de Service Fabric usa el almacén de certificados de la 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 afectará a la segunda versión.

publishProfilePath - de perfil de publicación
string.

Opcional. Especifica la ruta de acceso al archivo de perfil de publicación que define la configuración que se va a utilizar. variables y 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. variables y caracteres comodín se pueden usar en la ruta de acceso. Si se especifica, anula 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 - Anular parámetros de aplicación
boolean. Valor predeterminado: false.

Opcional. Especifica que las variables definidas en la canalización de compilación o versión coinciden con las entradas del Parameter Name archivo de manifiesto de la 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.

compressPackage - Paquete de compresión
boolean. Valor predeterminado: false.

Opcional. Especifica si el paquete de aplicación se debe comprimir antes de copiarlo en el almacén de imágenes. Si se habilita, anula el valor del perfil de publicación. Obtén más información sobre cómo comprimir paquetes.

copyPackageTimeoutSec - CopyPackageTimeoutSec
string.

Opcional. Especifica el tiempo de espera en segundos para copiar el paquete de la aplicación en el almacén de imágenes. Si se especifica, anula 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 - Comportamiento de sobrescritura
string. Obligatorio. Valores permitidos: Always, Never, SameAppTypeAndVersion. Valor predeterminado: SameAppTypeAndVersion.

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

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

Always eliminará la aplicación existente, incluso si su tipo y versión de aplicación son diferentes de la aplicación que se está creando.

SameAppTypeAndVersion eliminará la aplicación existente solo si el tipo y la versión de la aplicación son los mismos que los de la aplicación que se está creando.

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

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

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

Opcional. Especifica si el paquete debe validarse o no antes de la implementación. Obtén más información sobre la validación de paquetes.

useDiffPackage - Usar el paquete diff
boolean. Valor predeterminado: false.

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

Un paquete diff se crea comparando el paquete especificado en la entrada del paquete de aplicación con el paquete que está 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 eliminará del nuevo paquete de aplicación. Más información sobre los paquetes diff.

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

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

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

Sobrescribe la aplicación si el valor se establece en false.

unregisterUnusedVersions - Anular el registro de versiones no utilizadas
boolean. Valor predeterminado: true.

Opcional. Indica si todas las versiones no utilizadas del tipo de aplicación se eliminarán después de una actualización.

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

FailureAction - FailureAction (Error)
string. Obligatorio 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 - Configurar los ajustes de Docker
boolean. Valor predeterminado: false.

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

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

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

de conexión del servicio del Registro de Docker dockerRegistryConnection -
Alias de entrada: dockerRegistryEndpoint. string. Obligatorio cuando configureDockerSettings = true && registryCredentials = ContainerRegistryEndpoint.

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

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

Especifica una suscripción de Azure.

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

Especifica el nombre de usuario del registro de Docker.

de contraseña del Registro de registryPassword -
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 - cifrado de contraseñas
boolean. Opcional. Use cuando configureDockerSettings = true && registryCredentials = UsernamePassword. Valor predeterminado: true.

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

Ninguno.