ServiceFabricUpdateManifests@2 - Service Fabric-manifesten v2-taak bijwerken

Artikel
2025-03-24

Gebruik deze taak in een build-pijplijn om automatisch de versies van een verpakte Service Fabric-app bij te werken. Met deze taak wordt een versieachtervoegsel toegevoegd aan alle service- en app-versies, die zijn opgegeven in de manifestbestanden, in een Azure Service Fabric-app-pakket.

Syntaxis

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

Invoer

updateType - type bijwerken
string. Verplicht. Toegestane waarden: Manifest versions, Docker image settings. Standaardwaarde: Manifest versions.

Hiermee geeft u het type update dat moet worden aangebracht in de manifestbestanden. Als u beide updatetypen wilt gebruiken, voegt u een exemplaar van deze taak toe aan de build-pijplijn voor elk type update dat moet worden uitgevoerd.

applicationPackagePath - toepassingspakket
string. Verplicht.

Hiermee geeft u het pad naar het toepassingspakket. Variabelen en jokertekens kunnen in het pad worden gebruikt. applicationPackagePath mag geen afsluitende slash hebben, hetzij \ of /.

versionSuffix - versiewaarde
string. Vereist wanneer updateType = Manifest versions. Standaardwaarde: .$(Build.BuildNumber).

Hiermee geeft u de versie in de manifestbestanden.

Hint

U kunt de indeling van het buildnummer rechtstreeks wijzigen of een opdracht voor logboekregistratie gebruiken om een variabele dynamisch in te stellen in een indeling. U kunt bijvoorbeeld $(VersionSuffix) gebruiken die zijn gedefinieerd in een PowerShell-taak:

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

versionBehavior - versiegedrag
string. Facultatief. Gebruiken wanneer updateType = Manifest versions. Toegestane waarden: Append, Replace. Standaardwaarde: Append.

Hiermee geeft u op of u de versiewaarde wilt toevoegen aan bestaande waarden in de manifestbestanden of deze wilt vervangen.

updateOnlyChanged - alleen bijwerken als deze is gewijzigd
boolean. Facultatief. Gebruiken wanneer updateType = Manifest versions. Standaardwaarde: false.

Voegt het achtervoegsel van de nieuwe versie toe aan alleen de pakketten die zijn gewijzigd van een vorige build. Als er geen wijzigingen worden gevonden, wordt het versieachtervoegsel van de vorige build toegevoegd.

Notitie

Standaard maakt de compiler verschillende uitvoer, zelfs als er geen wijzigingen zijn aangebracht. Gebruik de deterministische compilervlag om ervoor te zorgen dat builds met dezelfde invoer dezelfde uitvoer produceren.

pkgArtifactName - naam van pakketartefacten
string. Facultatief. Gebruiken wanneer updateType = Manifest versions && updateOnlyChanged = true.

Hiermee geeft u de naam van het artefact met het toepassingspakket voor vergelijking.

logAllChanges - alle wijzigingen vastleggen
boolean. Facultatief. Gebruiken wanneer updateType = Manifest versions && updateOnlyChanged = true. Standaardwaarde: true.

Vergelijkt alle bestanden in elk pakket en logboek als het bestand is toegevoegd, verwijderd of als de inhoud ervan is gewijzigd. Anders vergelijkt deze Booleaanse waarde bestanden alleen in een pakket totdat de eerste wijziging wordt gevonden voor snellere prestaties.

compareType - vergelijken met
string. Facultatief. Gebruiken wanneer updateType = Manifest versions && updateOnlyChanged = true. Toegestane waarden: LastSuccessful (laatste geslaagde build), Specific (specifieke build). Standaardwaarde: LastSuccessful.

Hiermee geeft u op of moet worden vergeleken met de laatste voltooide en geslaagde build of met een specifieke build.

buildNumber - buildnummer
string. Facultatief. Gebruiken wanneer updateType = Manifest versions && compareType = Specific.

Hiermee geeft u het buildnummer voor vergelijking.

overwriteExistingPkgArtifact - bestaande pakketartefacten overschrijven
boolean. Facultatief. Gebruiken wanneer updateType = Manifest versions && updateOnlyChanged = true. Standaardwaarde: true.

Hiermee downloadt u een nieuwe kopie van het artefact. Anders maakt deze Booleaanse waarde gebruik van een bestaande kopie als deze aanwezig is.

imageNamesPath - pad naar afbeeldingsnamen
string. Facultatief. Gebruiken wanneer updateType = Docker image settings.

Hiermee geeft u het pad naar een tekstbestand met de namen van de Docker-installatiekopieën die zijn gekoppeld aan de Service Fabric-toepassing die moet worden bijgewerkt met digests. Elke afbeeldingsnaam moet zich op een eigen regel bevinden en moet zich in dezelfde volgorde bevinden als de samenvattingen in het bestand Image Digests. Als de installatiekopieën worden gemaakt door het Service Fabric-project, wordt dit bestand gegenereerd als onderdeel van het pakketdoel en wordt de uitvoerlocatie beheerd door de eigenschap BuiltDockerImagesFilePath.

Pad naar imageDigestsPath - afbeeldingssamenvatten
string. Vereist wanneer updateType = Docker image settings.

Hiermee geeft u het pad naar een tekstbestand met de samenvattingswaarden van de Docker-installatiekopieën die zijn gekoppeld aan de Service Fabric-toepassing. Dit bestand kan worden uitgevoerd door de Docker-taak bij het gebruik van de pushactie. Het bestand moet regels met tekst bevatten in de indeling van registry/image_name@digest_value.

Opties voor taakbeheer

Alle taken hebben besturingsopties naast hun taakinvoer. Zie Opties en algemene taakeigenschappenvoor meer informatie.

Uitvoervariabelen

Geen.

Opmerkingen

Notitie

Voor deze taak is Windows PowerShell vereist.

Deze taak is niet beschikbaar in release pijplijnen.

Deze taak kan alleen worden gebruikt in een build-pijplijn om automatisch de versies van een verpakte Service Fabric-app bij te werken.

Deze taak ondersteunt twee soorten updates:

manifestversie: updates van service- en toepassingsversies die zijn opgegeven in manifestbestanden in een Service Fabric-toepassingspakket. Indien opgegeven, vergelijkt manifest version huidige bestanden met een eerdere build en werkt de versie alleen bij voor die gewijzigde services.
Instellingen voor Docker-installatiekopieën: hiermee worden docker-containerinstallatiekopieën bijgewerkt die zijn opgegeven in manifestbestanden in een Service Fabric-toepassingspakket. De afbeeldingsinstellingen die moeten worden geplaatst, worden gekozen uit twee bestanden:

a. bestand met namen van installatiekopieën: dit bestand wordt gegenereerd door de build-taak.

b. bestand met installatiekopieën wordt: dit bestand wordt gegenereerd door de docker-taak wanneer installatiekopieën naar het register worden gepusht.

Voorbeelden

taak voor *service fabric-toepassingsimplementatie

Vereisten

Voorwaarde	Beschrijving
Pijplijntypen	YAML, klassieke build
Wordt uitgevoerd op	Agent, DeploymentGroup
eisen	Zelf-hostende agents moeten mogelijkheden hebben die overeenkomen met de volgende eisen taken uit te voeren die gebruikmaken van deze taak: Cmd
mogelijkheden	Deze taak voldoet niet aan de vereisten voor volgende taken in de taak.
opdrachtbeperkingen	Welk dan ook
variabelen instellen	Welk dan ook
Agentversie	1.95.0 of hoger
Taakcategorie	Nutsvoorzieningen

Delen via