Compartir vía

ServiceFabricUpdateManifests@2: tarea Actualizar manifiestos de Service Fabric v2

  • Artículo

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.

# Update Service Fabric Manifests v2
# Automatically updates portions of the application and service manifests within a packaged 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

updateType - Tipo de actualización
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.


applicationPackagePath - Paquete de aplicación
string. Obligatorio.

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


versionSuffix - Valor de versión
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) definido en una tarea de PowerShell:

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

versionBehavior - Comportamiento de la versión
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 - Solo se actualiza si se cambia
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á salidas diferentes, 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.


pkgArtifactName - Nombre del artefacto del paquete
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 booleano compara los archivos de un paquete solo hasta que se encuentre el primer cambio para un rendimiento más rápido.


compareType - Comparación 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 Image Digests. Si el proyecto de Service Fabric crea las imágenes, este archivo se genera como parte del destino del paquete y su ubicación de salida se controla mediante la propiedad 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. La tarea docker puede generar este archivo al usar la acción de inserción. El archivo debe contener líneas de texto con 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 tareas. Para obtener más información, vea Opciones de control y propiedades de tareas comunes.

Variables de salida

Ninguno.

Comentarios

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 canalizaciones de versión .

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: Novedades versiones de servicio y aplicación especificadas en archivos de manifiesto en 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: Novedades configuración de imagen de contenedor de Docker especificada en archivos de manifiesto en un paquete de aplicación de Service Fabric. La configuración de 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 imagen: la tarea docker genera este archivo cuando inserta imágenes en el registro.

Ejemplos

Requisitos

Requisito Descripción
Tipos de canalización YAML, compilació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 usen 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: Utilidad