Delen via

ServiceFabricDeploy@1 - Service Fabric-toepassingsimplementatie v1-taak

  • Artikel

Gebruik deze taak om een Service Fabric-toepassing in een cluster te implementeren. 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 metvoor werkstroomidentiteitsfederatie.

Syntaxis

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

Invoer

applicationPackagePath - toepassingspakket
string. Verplicht.

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


serviceConnectionName - clusterserviceverbinding
string. Verplicht.

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 Manage om een nieuwe serviceverbinding te registreren.

Als u verbinding wilt 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 machine opgeschoond, wat van invloed is op de tweede release.


publishProfilePath - Profiel publiceren
string.

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


applicationParameterPath - toepassingsparameters
string.

Facultatief. Hiermee geeft u het pad naar het toepassingsparametersbestand. Variabelen en jokertekens kunnen in het pad worden gebruikt. Indien opgegeven, wordt de waarde in het publicatieprofiel overschreven. Meer informatie over het maken van een toepassingsparametersbestand in Visual Studio.


overrideApplicationParameter - toepassingsparameters overschrijven
boolean. Standaardwaarde: false.

Facultatief. Hiermee geeft u de variabelen die in de build- of release-pijplijn zijn gedefinieerd, overeenkomen 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 uw toepassing een parameter heeft die is gedefinieerd zoals in het bovenstaande voorbeeld en u het aantal partities wilt wijzigen in 2, kunt u een release-pijplijn of een omgevingsvariabele definiëren SampleApp_PartitionCount en de waarde ervan als 2.

Notitie

Als dezelfde variabelen zijn gedefinieerd in de release-pijplijn en in de omgeving, vervangen de omgevingsvariabelen de releasepijplijnvariabelen.


compressPackage - pakket comprimeren
boolean. Standaardwaarde: false.

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


copyPackageTimeoutSec - CopyPackageTimeoutSec-
string.

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


registerPackageTimeoutSec - RegisterPackageTimeoutSec-
string.

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


overwriteBehavior - Gedrag overschrijven
string. Verplicht. Toegestane waarden: Always, Never, SameAppTypeAndVersion. Standaardwaarde: SameAppTypeAndVersion.

Overschrijft gedrag als een toepassing in het cluster met dezelfde naam en upgrades niet is geconfigureerd.

Never verwijdert de bestaande toepassing niet. Dit is het standaardgedrag.

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

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


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

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


skipPackageValidation - pakketvalidatie overslaan
boolean. Standaardwaarde: false.

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


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

Facultatief. Upgrades met behulp van een diff-pakket dat alleen de bijgewerkte toepassingsbestanden, het bijgewerkte toepassingsmanifest en de manifestbestanden van de service bevat.

Er wordt een diff-pakket 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 profielen overschrijven
boolean. Standaardwaarde: false.

Facultatief. Hiermee overschrijft u alle upgrade-instellingen met opgegeven waarden of de standaardwaarde (indien niet opgegeven). Meer informatie over upgrade-instellingen.


isUpgrade - de toepassings- bijwerken
boolean. Facultatief. Gebruiken wanneer overridePublishProfileSettings = true. Standaardwaarde: true.

Overschrijft de toepassing als de waarde is ingesteld op false.


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

Facultatief. Geeft aan of alle ongebruikte versies van het toepassingstype na een upgrade worden verwijderd.


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. Facultatief. Gebruiken wanneer overridePublishProfileSettings = true && isUpgrade = true.


TimeoutSec - TimeoutSec-
string. Facultatief. Gebruiken wanneer overridePublishProfileSettings = true && isUpgrade = true.


ForceRestart - ForceRestart-
boolean. Facultatief. Gebruiken wanneer overridePublishProfileSettings = true && isUpgrade = true. Standaardwaarde: false.


HealthCheckRetryTimeoutSec - HealthCheckRetryTimeoutSec-
string. Facultatief. Gebruiken wanneer overridePublishProfileSettings = true && isUpgrade = true && upgradeMode = Monitored.


HealthCheckWaitDurationSec - HealthCheckWaitDurationSec-
string. Facultatief. Gebruiken wanneer overridePublishProfileSettings = true && isUpgrade = true && upgradeMode = Monitored.


HealthCheckStableDurationSec - HealthCheckStableDurationSec
string. Facultatief. Gebruiken wanneer overridePublishProfileSettings = true && isUpgrade = true && upgradeMode = Monitored.


UpgradeDomainTimeoutSec - UpgradeDomainTimeoutSec-
string. Facultatief. Gebruiken wanneer overridePublishProfileSettings = true && isUpgrade = true && upgradeMode = Monitored.


ConsiderWarningAsError - ConsiderWarningAsError-
boolean. Facultatief. Gebruiken wanneer overridePublishProfileSettings = true && isUpgrade = true && upgradeMode = Monitored. Standaardwaarde: false.


DefaultServiceTypeHealthPolicy - DefaultServiceTypeHealthPolicy-
string. Facultatief. Gebruiken wanneer overridePublishProfileSettings = true && isUpgrade = true && upgradeMode = Monitored.


MaxPercentUnhealthyDeployedApplications - MaxPercentUnhealthyDeployedApplications
string. Facultatief. Gebruiken wanneer overridePublishProfileSettings = true && isUpgrade = true && upgradeMode = Monitored.


UpgradeTimeoutSec - UpgradeTimeoutSec-
string. Facultatief. Gebruiken wanneer overridePublishProfileSettings = true && isUpgrade = true && upgradeMode = Monitored.


ServiceTypeHealthPolicyMap - ServiceTypeHealthPolicyMap
string. Facultatief. Gebruiken 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 - bron van registerreferenties
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 - docker-registerserviceverbinding
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 het servercertificaat van het cluster echter op de agentcomputer worden geïnstalleerd. 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 het servercertificaat van het cluster echter op de agentcomputer worden geïnstalleerd. Als het certificaat niet aanwezig is, wordt het registergeheim niet versleuteld.


registryUserName - registergebruikersnaam
string. Facultatief. Gebruiken wanneer configureDockerSettings = true && registryCredentials = UsernamePassword.

Hiermee geeft u de gebruikersnaam voor het Docker-register.


registryPassword - registerwachtwoord
string. Facultatief. Gebruiken wanneer configureDockerSettings = true && registryCredentials = UsernamePassword.

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


passwordEncrypted - met wachtwoord versleutelde
boolean. Facultatief. Gebruiken wanneer configureDockerSettings = true && registryCredentials = UsernamePassword. Standaardwaarde: true.

U moet uw wachtwoord versleutelen met Invoke-ServiceFabricEncryptText. Als u dit niet doet en een certificaat dat overeenkomt met de vingerafdruk van het servercertificaat in de clusterserviceverbinding is geïnstalleerd op de buildagent, 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 Opties en algemene taakeigenschappenvoor meer informatie.

Uitvoervariabelen

Geen.

Opmerkingen

Gebruik deze taak om een Service Fabric-toepassing in een cluster te implementeren. 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. Service Fabric- downloaden en installeren op de buildagent.

Vereisten

Voorwaarde Beschrijving
Pijplijntypen YAML, klassieke build, klassieke release
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 Implementeren