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

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.

Syntax

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

Invoerwaarden

updateType - Updatetype
string. Vereist. Toegestane waarden: Manifest versions, Docker image settings. Standaardwaarde: Manifest versions.

Hiermee geeft u het type update dat moet worden gemaakt voor 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. Vereist.

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

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

Hiermee geeft u de versie in de manifestbestanden.

Tip

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

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

versionBehavior - Versiegedrag
string. Optioneel. Gebruik wanneer updateType = Manifest versions. Toegestane waarden: Append, Replace. Standaardwaarde: Append.

Hiermee geeft u op of de versiewaarde moet worden toegevoegd aan bestaande waarden in de manifestbestanden of deze vervangen.

updateOnlyChanged - Alleen bijwerken als deze is gewijzigd
boolean. Optioneel. Gebruik wanneer updateType = Manifest versions. Standaardwaarde: false.

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

Notitie

Standaard maakt de compiler verschillende uitvoerwaarden, 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 pakketartefact
string. Optioneel. Gebruik wanneer updateType = Manifest versions && updateOnlyChanged = true.

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

logAllChanges - Alle wijzigingen vastleggen
boolean. Optioneel. Gebruik 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 is gewijzigd. Anders vergelijkt deze Booleaanse waarde alleen bestanden in een pakket totdat de eerste wijziging wordt gevonden voor snellere prestaties.

compareType - Vergelijken met
string. Optioneel. Gebruik 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. Optioneel. Gebruik wanneer updateType = Manifest versions && compareType = Specific.

Hiermee geeft u het buildnummer voor vergelijking.

overwriteExistingPkgArtifact - Bestaand pakketartefact overschrijven
boolean. Optioneel. Gebruik wanneer updateType = Manifest versions && updateOnlyChanged = true. Standaardwaarde: true.

Hiermee downloadt u een nieuwe kopie van het artefact. Anders gebruikt deze Booleaanse waarde een bestaande kopie, indien aanwezig.

imageNamesPath - Pad naar afbeeldingsnamen
string. Optioneel. Gebruik 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 moeten worden bijgewerkt met digests. Elke afbeeldingsnaam moet op een eigen regel staan en moet in dezelfde volgorde staan 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 bepaald door de eigenschap BuiltDockerImagesFilePath.

imageDigestsPath - Pad naar samenvattingen van afbeeldingen
string. Vereist wanneer updateType = Docker image settings.

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

Opties voor taakbeheer

Alle taken hebben naast de taakinvoer besturingsopties. Zie Besturingsopties en algemene taakeigenschappen voor meer informatie.

Uitvoervariabelen

Geen.

Opmerkingen

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.

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 de versies van een verpakte Service Fabric-app automatisch bij te werken.

Deze taak ondersteunt twee typen updates:

1. Manifestversie: Updates service- en toepassingsversies die zijn opgegeven in manifestbestanden in een Service Fabric-toepassingspakket. Indien opgegeven, manifest version vergelijkt huidige bestanden met een eerdere build en werkt de versie alleen bij voor die gewijzigde services.

2. Instellingen voor Docker-installatiekopieën: Updates instellingen voor docker-containerinstallatiekopieën 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 digests van installatiekopieën: dit bestand wordt gegenereerd door de docker-taak wanneer installatiekopieën naar het register worden gepusht.

Voorbeelden

• *Implementatietaak voor Service Fabric-toepassing

Vereisten

Vereiste	Beschrijving
Pijplijntypen	YAML, klassieke build
Wordt uitgevoerd op	Agent, DeploymentGroup
Eisen	Zelf-hostende agents moeten mogelijkheden hebben die voldoen aan de volgende vereisten om taken uit te voeren die gebruikmaken van deze taak: Cmd
Functies	Deze taak voldoet niet aan eventuele vereisten voor volgende taken in de taak.
Opdrachtbeperkingen	Alle
Instelbare variabelen	Alle
Agentversie	1.95.0 of hoger
Taakcategorie	Hulpprogramma