ServiceFabricUpdateManifests@2: tarea Actualizar manifiestos de Service Fabric v2

Use esta tarea en una canalización de compilación para actualizar automáticamente las versiones de una aplicación empaquetada de Service Fabric. Esta tarea anexa un sufijo de versión a todas las versiones de servicio y aplicación, especificadas en los archivos de manifiesto, en un paquete de aplicación de Azure Service Fabric.

Sintaxis

# Update Service Fabric manifests v2
# Automatically update portions of application and service manifests in a packaged Azure Service Fabric application.
- task: ServiceFabricUpdateManifests@2
  inputs:
    updateType: 'Manifest versions' # 'Manifest versions' | 'Docker image settings'. Required. Update Type. Default: Manifest versions.
    applicationPackagePath: # string. Required. Application Package. 
    #versionSuffix: '.$(Build.BuildNumber)' # string. Required when updateType = Manifest versions. Version Value. Default: .$(Build.BuildNumber).
    #versionBehavior: 'Append' # 'Append' | 'Replace'. Optional. Use when updateType = Manifest versions. Version Behavior. Default: Append.
    #updateOnlyChanged: false # boolean. Optional. Use when updateType = Manifest versions. Update only if changed. Default: false.
    #pkgArtifactName: # string. Optional. Use when updateType = Manifest versions && updateOnlyChanged = true. Package Artifact Name. 
    #logAllChanges: true # boolean. Optional. Use when updateType = Manifest versions && updateOnlyChanged = true. Log all changes. Default: true.
    #compareType: 'LastSuccessful' # 'LastSuccessful' | 'Specific'. Optional. Use when updateType = Manifest versions && updateOnlyChanged = true. Compare against. Default: LastSuccessful.
    #buildNumber: # string. Optional. Use when updateType = Manifest versions && compareType = Specific. Build Number. 
    #overwriteExistingPkgArtifact: true # boolean. Optional. Use when updateType = Manifest versions && updateOnlyChanged = true. Overwrite Existing Package Artifact. Default: true.
    #imageNamesPath: # string. Optional. Use when updateType = Docker image settings. Image Names Path. 
    #imageDigestsPath: # string. Required when updateType = Docker image settings. Image Digests Path.

Entradas

de tipo de actualización de updateType -
string. Obligatorio. Valores permitidos: Manifest versions, Docker image settings. Valor predeterminado: Manifest versions.

Especifica el tipo de actualización que se debe realizar en los archivos de manifiesto. Para usar ambos tipos de actualización, agregue una instancia de esta tarea a la canalización de compilación para cada tipo de actualización que se va a ejecutar.

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

Especifica la ruta de acceso al paquete de aplicación. variables y caracteres comodín se pueden usar en la ruta de acceso. applicationPackagePath no debe tener una barra diagonal final, ya sea \ o /.

valor de versión de versionSuffix -
string. Obligatorio cuando updateType = Manifest versions. Valor predeterminado: .$(Build.BuildNumber).

Especifica la versión de los archivos de manifiesto.

Sugerencia

Puede modificar el formato de número de compilación directamente o usar un comando de registro para establecer dinámicamente una variable en un formato. Por ejemplo, puede usar $(VersionSuffix) definidos en una tarea de PowerShell:

$versionSuffix = ".$([DateTimeOffset]::UtcNow.ToString('yyyyMMdd.HHmmss'))"
Write-Host "##vso[task.setvariable variable=VersionSuffix;]$versionSuffix"

comportamiento de la versión de versionBehavior -
string. Opcional. Use cuando updateType = Manifest versions. Valores permitidos: Append, Replace. Valor predeterminado: Append.

Especifica si se va a anexar el valor de versión a los valores existentes en los archivos de manifiesto o reemplazarlos.

updateOnlyChanged - Actualizar solo si se ha cambiado
boolean. Opcional. Use cuando updateType = Manifest versions. Valor predeterminado: false.

Anexa el sufijo de nueva versión solo a los paquetes que han cambiado de una compilación anterior. Si no se encuentra ningún cambio, se anexará el sufijo de versión de la compilación anterior.

Nota:

De forma predeterminada, el compilador creará diferentes salidas incluso si no se realizaron cambios. Use la marca del compilador determinista para asegurarse de que las compilaciones con las mismas entradas producen las mismas salidas.

nombre de artefacto del paquete de pkgArtifactName -
string. Opcional. Use cuando updateType = Manifest versions && updateOnlyChanged = true.

Especifica el nombre del artefacto que contiene el paquete de aplicación para la comparación.

logAllChanges - Registrar todos los cambios
boolean. Opcional. Use cuando updateType = Manifest versions && updateOnlyChanged = true. Valor predeterminado: true.

Compara todos los archivos de cada paquete y registro si el archivo se ha agregado, quitado o si ha cambiado su contenido. De lo contrario, este valor booleano compara los archivos de un paquete solo hasta que se encuentra el primer cambio para un rendimiento más rápido.

compareType - Comparar con
string. Opcional. Use cuando updateType = Manifest versions && updateOnlyChanged = true. Valores permitidos: LastSuccessful (última compilación correcta), Specific (compilación específica). Valor predeterminado: LastSuccessful.

Especifica si se va a comparar con la última compilación completada y correcta o con una compilación específica.

buildNumber - número de compilación
string. Opcional. Use cuando updateType = Manifest versions && compareType = Specific.

Especifica el número de compilación para la comparación.

overwriteExistingPkgArtifact - sobrescribir el artefacto de paquete existente
boolean. Opcional. Use cuando updateType = Manifest versions && updateOnlyChanged = true. Valor predeterminado: true.

Descarga una nueva copia del artefacto. De lo contrario, este valor booleano usa una copia existente si está presente.

imageNamesPath - ruta de acceso de nombres de imagen
string. Opcional. Use cuando updateType = Docker image settings.

Especifica la ruta de acceso a un archivo de texto que contiene los nombres de las imágenes de Docker asociadas a la aplicación de Service Fabric que se deben actualizar con resúmenes. Cada nombre de imagen debe estar en su propia línea y debe estar en el mismo orden que los resúmenes del archivo de resúmenes de imagen. Si el proyecto de Service Fabric crea las imágenes, este archivo se genera como parte del destino del paquete y la propiedad controla su ubicación de salida BuiltDockerImagesFilePath.

imageDigestsPath - ruta de acceso de resúmenes de imágenes
string. Obligatorio cuando updateType = Docker image settings.

Especifica la ruta de acceso a un archivo de texto que contiene los valores de resumen de las imágenes de Docker asociadas a la aplicación de Service Fabric. El tarea docker puede generar este archivo al usar la acción de inserción. El archivo debe contener líneas de texto en el formato de registry/image_name@digest_value.

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

Ninguno.

Observaciones

Use esta tarea en una canalización de compilación para actualizar automáticamente las versiones de una aplicación empaquetada de Service Fabric. Esta tarea anexa un sufijo de versión a todas las versiones de servicio y aplicación, especificadas en los archivos de manifiesto, en un paquete de aplicación de Azure Service Fabric.

Nota:

Esta tarea requiere Windows PowerShell.

Esta tarea no está disponible en versión canalizaciones.

Esta tarea solo se puede usar en una canalización de compilación para actualizar automáticamente las versiones de una aplicación empaquetada de Service Fabric.

Esta tarea admite dos tipos de actualizaciones:

1. versión del manifiesto: actualiza las versiones de servicio y aplicación especificadas en los archivos de manifiesto de un paquete de aplicación de Service Fabric. Si se especifica, manifest version compara los archivos actuales con una compilación anterior y actualiza la versión solo para esos servicios modificados.

2. configuración de la imagen de Docker: actualiza la configuración de la imagen de contenedor de Docker especificada en los archivos de manifiesto de un paquete de aplicación de Service Fabric. La configuración de la imagen que se va a colocar se selecciona de dos archivos:

   a. archivo de nombres de imagen: la tarea de compilación genera este archivo.

   b. archivo de resúmenes de imágenes: la tarea docker genera este archivo cuando inserta imágenes en el registro.

Ejemplos

• * tarea implementación de aplicaciones de Service Fabric

Requisitos

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