ServiceFabricDeploy@1 - Service Fabric-toepassingsimplementatie v1-taak

Gebruik deze taak om een Service Fabric-toepassing te implementeren in een cluster. Met deze taak wordt een Azure Service Fabric-toepassing geïmplementeerd in een cluster volgens de instellingen die zijn gedefinieerd in het publicatieprofiel.

Notitie

Deze taak biedt geen ondersteuning voor Azure Resource Manager-verificatie met werkstroomidentiteitsfederatie.

Syntax

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

Invoerwaarden

applicationPackagePath - Toepassingspakket
string. Vereist.

Hiermee geeft u het pad naar het toepassingspakket dat moet worden geïmplementeerd. Variabelen en jokertekens kunnen worden gebruikt in het pad.

serviceConnectionName - Verbinding met clusterservice
string. Vereist.

Hiermee geeft u de Azure Service Fabric-serviceverbinding op die moet worden gebruikt om verbinding te maken met het cluster. De instellingen die zijn gedefinieerd in deze serviceverbinding waarnaar wordt verwezen, overschrijven de instellingen die zijn gedefinieerd in het publicatieprofiel. Kies ervoor Manage om een nieuwe serviceverbinding te registreren.

Om verbinding te maken met het cluster, gebruikt de Service Fabric-taak het certificaatarchief van de machine om de informatie over het certificaat op te slaan. Als twee releases samen worden uitgevoerd op één computer met hetzelfde certificaat, worden ze correct gestart. Als een van de taken echter is voltooid, wordt het certificaat uit het certificaatarchief van de computer opgeschoond, wat van invloed is op de tweede release.

publishProfilePath - Profiel publiceren
string.

Optioneel. Hiermee geeft u het pad naar het publicatieprofielbestand op dat de instellingen definieert die moeten worden gebruikt. Variabelen en jokertekens kunnen worden gebruikt in het pad. Meer informatie over het maken van publicatieprofielen in Visual Studio.

applicationParameterPath - Toepassingsparameters
string.

Optioneel. Hiermee geeft u het pad naar het bestand met toepassingsparameters. Variabelen en jokertekens kunnen worden gebruikt in het pad. Indien opgegeven, overschrijft dit de waarde in het publicatieprofiel. Meer informatie over het maken van een toepassingsparametersbestand in Visual Studio.

overrideApplicationParameter - Toepassingsparameters overschrijven
boolean. Standaardwaarde: false.

Optioneel. Hiermee geeft u de variabelen die zijn gedefinieerd in de build- of release-pijplijn worden vergeleken met de Parameter Name vermeldingen in het manifestbestand van de toepassing. Meer informatie over het maken van een toepassingsparametersbestand in Visual Studio. Voorbeeld:

 <Parameters> 
 <Parameter Name="SampleApp_PartitionCount" Value="1" /> 
 <Parameter Name="SampleApp_InstanceCount" DefaultValue="-1" /> 
 </Parameters>

Als voor uw toepassing een parameter is gedefinieerd zoals in het bovenstaande voorbeeld en u het aantal 2partities wilt wijzigen in , kunt u een release-pijplijn of een omgevingsvariabele SampleApp_PartitionCount en de bijbehorende waarde definiëren als 2.

Notitie

Als dezelfde variabelen zijn gedefinieerd in de releasepijplijn en in de omgeving, vervangen de omgevingsvariabelen de releasepijplijnvariabelen.

compressPackage - Pakket comprimeren
boolean. Standaardwaarde: false.

Optioneel. Hiermee geeft u op of het toepassingspakket moet worden gecomprimeerd voordat u naar het installatiekopiearchief kopieert. Als deze optie is ingeschakeld, wordt de waarde in het publicatieprofiel overschreven. Meer informatie over het comprimeren van pakketten.

copyPackageTimeoutSec - CopyPackageTimeoutSec
string.

Optioneel. Hiermee geeft u de time-out in seconden voor het kopiëren van het toepassingspakket naar het installatiekopiearchief. Indien opgegeven, overschrijft dit de waarde in het publicatieprofiel.

registerPackageTimeoutSec - RegisterPackageTimeoutSec
string.

Optioneel. Hiermee geeft u de time-out in seconden voor het registreren of ongedaan maken van de registratie van een toepassingspakket.

overwriteBehavior - Overschrijfgedrag
string. Vereist. Toegestane waarden: Always, Never, SameAppTypeAndVersion. Standaardwaarde: SameAppTypeAndVersion.

Overschrijft gedrag als er een toepassing in het cluster met dezelfde naam bestaat en er geen upgrades zijn geconfigureerd.

Never verwijdert de bestaande toepassing niet. Dit is de standaardinstelling.

Always verwijdert de bestaande toepassing, zelfs als het toepassingstype en de versie afwijken van de toepassing die wordt gemaakt.

SameAppTypeAndVersion verwijdert de bestaande toepassing alleen als het toepassingstype en de versie hetzelfde zijn als de toepassing die wordt gemaakt.

skipUpgradeSameTypeAndVersion - Upgrade overslaan voor hetzelfde type en dezelfde versie
boolean. Standaardwaarde: false.

Optioneel. Hiermee geeft u op of een upgrade wordt overgeslagen als hetzelfde toepassingstype en dezelfde versie al in het cluster bestaan; Anders mislukt de upgrade tijdens de validatie. Indien ingeschakeld, zijn herimplementaties idempotent.

skipPackageValidation - Pakketvalidatie overslaan
boolean. Standaardwaarde: false.

Optioneel. Hiermee geeft u op of het pakket moet worden gevalideerd of niet vóór de implementatie. Meer informatie over pakketvalidatie.

useDiffPackage - Diff-pakket gebruiken
boolean. Standaardwaarde: false.

Optioneel. Voert een upgrade uit met behulp van een diff-pakket dat alleen de bijgewerkte toepassingsbestanden, het bijgewerkte toepassingsmanifest en de servicemanifestbestanden bevat.

Een diff-pakket wordt gemaakt door het pakket dat is opgegeven in de invoer van het toepassingspakket te vergelijken met het pakket dat momenteel is geregistreerd in het doelcluster. Als een serviceversie in het huidige pakket van het cluster hetzelfde is als het nieuwe pakket, wordt dit servicepakket verwijderd uit het nieuwe toepassingspakket. Meer informatie over diff-pakketten.

overridePublishProfileSettings - Alle upgrade-instellingen voor het publiceren van het profiel overschrijven
boolean. Standaardwaarde: false.

Optioneel. Overschrijft alle upgrade-instellingen met opgegeven waarden of de standaardwaarde (indien niet opgegeven). Meer informatie over upgrade-instellingen.

isUpgrade - De toepassing upgraden
boolean. Optioneel. Gebruik wanneer overridePublishProfileSettings = true. Standaardwaarde: true.

Overschrijft de toepassing als de waarde is ingesteld op false.

unregisterUnusedVersions - Registratie van ongebruikte versies ongedaan maken
boolean. Standaardwaarde: true.

Optioneel. Hiermee wordt aangegeven of alle ongebruikte versies van het toepassingstype worden verwijderd na een upgrade.

upgradeMode - Upgrademodus
string. Vereist wanneer overridePublishProfileSettings = true && isUpgrade = true. Toegestane waarden: Monitored, UnmonitoredAuto, UnmonitoredManual. Standaardwaarde: Monitored.

FailureAction - FailureAction
string. Vereist wanneer overridePublishProfileSettings = true && isUpgrade = true && upgradeMode = Monitored. Toegestane waarden: Rollback, Manual. Standaardwaarde: Rollback.

UpgradeReplicaSetCheckTimeoutSec - UpgradeReplicaSetCheckTimeoutSec
string. Optioneel. Gebruik wanneer overridePublishProfileSettings = true && isUpgrade = true.

TimeoutSec - TimeoutSec
string. Optioneel. Gebruik wanneer overridePublishProfileSettings = true && isUpgrade = true.

ForceRestart - ForceRestart
boolean. Optioneel. Gebruik wanneer overridePublishProfileSettings = true && isUpgrade = true. Standaardwaarde: false.

HealthCheckRetryTimeoutSec - HealthCheckRetryTimeoutSec
string. Optioneel. Gebruik wanneer overridePublishProfileSettings = true && isUpgrade = true && upgradeMode = Monitored.

HealthCheckWaitDurationSec - HealthCheckWaitDurationSec
string. Optioneel. Gebruik wanneer overridePublishProfileSettings = true && isUpgrade = true && upgradeMode = Monitored.

HealthCheckStableDurationSec - HealthCheckStableDurationSec
string. Optioneel. Gebruik wanneer overridePublishProfileSettings = true && isUpgrade = true && upgradeMode = Monitored.

UpgradeDomainTimeoutSec - UpgradeDomainTimeoutSec
string. Optioneel. Gebruik wanneer overridePublishProfileSettings = true && isUpgrade = true && upgradeMode = Monitored.

ConsiderWarningAsError - ConsiderWarningAsError
boolean. Optioneel. Gebruik wanneer overridePublishProfileSettings = true && isUpgrade = true && upgradeMode = Monitored. Standaardwaarde: false.

DefaultServiceTypeHealthPolicy - DefaultServiceTypeHealthPolicy
string. Optioneel. Gebruik wanneer overridePublishProfileSettings = true && isUpgrade = true && upgradeMode = Monitored.

MaxPercentUnhealthyDeployedApplications - MaxPercentUnhealthyDeployedApplications
string. Optioneel. Gebruik wanneer overridePublishProfileSettings = true && isUpgrade = true && upgradeMode = Monitored.

UpgradeTimeoutSec - UpgradeTimeoutSec
string. Optioneel. Gebruik wanneer overridePublishProfileSettings = true && isUpgrade = true && upgradeMode = Monitored.

ServiceTypeHealthPolicyMap - ServiceTypeHealthPolicyMap
string. Optioneel. Gebruik wanneer overridePublishProfileSettings = true && isUpgrade = true && upgradeMode = Monitored.

configureDockerSettings - Docker-instellingen configureren
boolean. Standaardwaarde: false.

Hiermee configureert u de toepassing met de opgegeven Docker-instellingen.

registryCredentials - Registerreferentiebron
string. Vereist wanneer configureDockerSettings = true. Toegestane waarden: AzureResourceManagerEndpoint (Azure Resource Manager Service Connection), ContainerRegistryEndpoint (Container Registry Service Connection), UsernamePassword (gebruikersnaam en wachtwoord). Standaardwaarde: AzureResourceManagerEndpoint.

Hiermee geeft u op hoe referenties voor het Docker-register worden opgegeven.

dockerRegistryConnection - Verbinding met Docker Registry-service
Invoeralias: dockerRegistryEndpoint. string. Vereist wanneer configureDockerSettings = true && registryCredentials = ContainerRegistryEndpoint.

Hiermee geeft u een Docker-registerserviceverbinding op. Vereist voor opdrachten die moeten worden geverifieerd met een register.

Notitie

De taak probeert het registergeheim te versleutelen voordat het naar het Service Fabric-cluster wordt verzonden. Voor de taak moet echter het servercertificaat van het cluster zijn geïnstalleerd op de agentcomputer. Als het certificaat niet aanwezig is, wordt het registergeheim niet versleuteld.

azureSubscription - Azure-abonnement
Invoeralias: azureSubscriptionEndpoint. string. Vereist wanneer configureDockerSettings = true && registryCredentials = AzureResourceManagerEndpoint.

Hiermee geeft u een Azure-abonnement op.

Notitie

De taak probeert het registergeheim te versleutelen voordat het naar het Service Fabric-cluster wordt verzonden. Voor de taak moet echter het servercertificaat van het cluster zijn geïnstalleerd op de agentcomputer. Als het certificaat niet aanwezig is, wordt het registergeheim niet versleuteld.

registryUserName - Registergebruikersnaam
string. Optioneel. Gebruik wanneer configureDockerSettings = true && registryCredentials = UsernamePassword.

Hiermee geeft u de gebruikersnaam voor het Docker-register.

registryPassword - Registerwachtwoord
string. Optioneel. Gebruik wanneer configureDockerSettings = true && registryCredentials = UsernamePassword.

Hiermee geeft u het wachtwoord voor het Docker-register op. Als het wachtwoord niet is versleuteld, moet u een aangepaste releasepijplijngeheimvariabele gebruiken om het op te slaan.

passwordEncrypted - Wachtwoord versleuteld
boolean. Optioneel. Gebruik wanneer configureDockerSettings = true && registryCredentials = UsernamePassword. Standaardwaarde: true.

U moet uw wachtwoord versleutelen met behulp van Invoke-ServiceFabricEncryptText. Als u dat niet doet en een certificaat dat overeenkomt met de vingerafdruk van het servercertificaat in de clusterserviceverbinding is geïnstalleerd op de build-agent, wordt dat certificaat gebruikt om het wachtwoord te versleutelen; anders treedt er een fout op.

Opties voor taakbeheer

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

Uitvoervariabelen

Geen.

Opmerkingen

Gebruik deze taak om een Service Fabric-toepassing te implementeren in een cluster. Met deze taak wordt een Azure Service Fabric-toepassing geïmplementeerd in een cluster volgens de instellingen die zijn gedefinieerd in het publicatieprofiel.

Service Fabric

Deze taak maakt gebruik van een Service Fabric-installatie om verbinding te maken en te implementeren in een Service Fabric-cluster. Download en installeer Service Fabric op de buildagent.

Vereisten

Vereiste	Beschrijving
Pijplijntypen	YAML, klassieke build, klassieke release
Wordt uitgevoerd op	Agent, DeploymentGroup
Eisen	Zelf-hostende agents moeten mogelijkheden hebben die voldoen aan de volgende vereisten om taken uit te voeren die deze taak gebruiken: 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	Implementeren