ServiceFabricDeploy@1: Service Fabric-Anwendungsbereitstellung v1-Aufgabe

Verwenden Sie diese Aufgabe, um eine Service Fabric-Anwendung in einem Cluster bereitzustellen. Mit dieser Aufgabe wird eine Azure Service Fabric-Anwendung gemäß den im Veröffentlichungsprofil definierten Einstellungen in einem Cluster bereitgestellt.

Hinweis

Diese Aufgabe unterstützt keine Azure Resource Manager-Authentifizierung mit dem Workflowidentitätsverbund.

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.

Eingaben

applicationPackagePath - Anwendungspaket
string. Erforderlich.

Gibt den Pfad zu dem Anwendungspaket an, das bereitgestellt werden soll. Variablen und Wildcards können im Pfad verwendet werden.

serviceConnectionName - Clusterdienstverbindung
string. Erforderlich.

Gibt die Azure Service Fabric-Dienstverbindung an, die zum Herstellen einer Verbindung mit dem Cluster verwendet werden soll. Die in dieser Referenzdienstverbindung definierten Einstellungen setzen die im Veröffentlichungsprofil definierten Einstellungen außer Kraft. Wählen Sie Manage aus, um eine neue Dienstverbindung zu registrieren.

Um eine Verbindung mit dem Cluster herzustellen, verwendet die Service Fabric-Aufgabe den Computerzertifikatspeicher, um die Informationen zum Zertifikat zu speichern. Wenn zwei Releases zusammen auf einem Computer mit demselben Zertifikat ausgeführt werden, werden sie ordnungsgemäß gestartet. Wenn jedoch eine der Aufgaben abgeschlossen ist, wird das Zertifikat aus dem Computerzertifikatspeicher bereinigt, was sich auf die zweite Version auswirkt.

publishProfilePath - Veröffentlichungsprofil
string.

Optional. Gibt den Pfad zur Veröffentlichungsprofildatei an, die die zu verwendenden Einstellungen definiert. Variablen und Wildcards können im Pfad verwendet werden. Erfahren Sie mehr über das Erstellen von Veröffentlichungsprofilen in Visual Studio.

applicationParameterPath - Anwendungsparameter
string.

Optional. Gibt den Pfad zur Anwendungsparameterdatei an. Variablen und Wildcards können im Pfad verwendet werden. Wenn angegeben, überschreibt dies den Wert im Veröffentlichungsprofil. Erfahren Sie mehr über das Erstellen einer Anwendungsparameterdatei in Visual Studio.

overrideApplicationParameter - Überschreiben von Anwendungsparametern
boolean. Standardwert. false.

Optional. Gibt an, dass die in der Build- oder Releasepipeline definierten Variablen mit den Parameter Name Einträgen in der Anwendungsmanifestdatei abgeglichen werden. Erfahren Sie mehr über das Erstellen einer Anwendungsparameterdatei in Visual Studio. Beispiel:

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

Wenn Ihre Anwendung über einen Parameter verfügt, der wie im obigen Beispiel definiert ist, und Sie die Partitionsanzahl in 2ändern möchten, können Sie eine Releasepipeline oder eine Umgebungsvariable SampleApp_PartitionCount und deren Wert als 2definieren.

Hinweis

Wenn dieselben Variablen in der Releasepipeline und in der Umgebung definiert sind, ersetzen die Umgebungsvariablen die Releasepipelinevariablen.

compressPackage - Paket komprimieren
boolean. Standardwert. false.

Optional. Gibt an, ob das Anwendungspaket vor dem Kopieren in den Imagespeicher komprimiert werden soll. Wenn diese Option aktiviert ist, wird der Wert im Veröffentlichungsprofil überschrieben. Erfahren Sie mehr über das Komprimieren von Paketen.

copyPackageTimeoutSec - CopyPackageTimeoutSec
string.

Optional. Gibt das Timeout in Sekunden für das Kopieren des Anwendungspakets in den Imagespeicher an. Wenn angegeben, überschreibt dies den Wert im Veröffentlichungsprofil.

registerPackageTimeoutSec - RegisterPackageTimeoutSec
string.

Optional. Gibt das Timeout in Sekunden für das Registrieren oder Aufheben der Registrierung eines Anwendungspakets an.

overwriteBehavior - Überschreiben des Verhaltens
string. Erforderlich. Zulässige Werte: Always, Never und SameAppTypeAndVersion. Standardwert. SameAppTypeAndVersion.

Überschreibt das Verhalten, wenn im Cluster eine Anwendung mit demselben Namen vorhanden ist und Upgrades nicht konfiguriert wurden.

Never entfernt die vorhandene Anwendung nicht. Dies ist das Standardverhalten.

Always entfernt die vorhandene Anwendung, auch wenn sich ihr Anwendungstyp und die Version von der zu erstellenden Anwendung unterscheiden.

SameAppTypeAndVersion entfernt die vorhandene Anwendung nur, wenn ihr Anwendungstyp und die Version mit der zu erstellenden Anwendung identisch sind.

skipUpgradeSameTypeAndVersion - Überspringen des Upgrades für denselben Typ und dieselbe Version
boolean. Standardwert. false.

Optional. Gibt an, ob ein Upgrade übersprungen wird, wenn derselbe Anwendungstyp und dieselbe Version bereits im Cluster vorhanden sind; Andernfalls schlägt das Upgrade während der Überprüfung fehl. Ist dies aktiviert, sind erneute Bereitstellungen idempotent.

skipPackageValidation - Überspringen der Paketüberprüfung
boolean. Standardwert. false.

Optional. Gibt an, ob das Paket vor der Bereitstellung überprüft werden soll. Erfahren Sie mehr über die Paketvalidierung.

useDiffPackage - Verwenden des Diff-Pakets
boolean. Standardwert. false.

Optional. Upgrades mithilfe eines diff-Pakets, das nur die aktualisierten Anwendungsdateien, das aktualisierte Anwendungsmanifest und die Dienstmanifestdateien enthält.

Ein diff Paket wird erstellt, indem das in der Anwendungspaketeingabe angegebene Paket mit dem Paket verglichen wird, das derzeit im Zielcluster registriert ist. Wenn eine Dienstversion im aktuellen Paket des Clusters mit dem neuen Paket identisch ist, wird dieses Dienstpaket aus dem neuen Anwendungspaket entfernt. Erfahren Sie mehr über diff-Pakete.

overridePublishProfileSettings - Überschreiben aller Upgradeeinstellungen für Veröffentlichungsprofile
boolean. Standardwert. false.

Optional. Überschreibt alle Upgradeeinstellungen entweder mit angegebenen Werten oder dem Standardwert (falls nicht angegeben). Erfahren Sie mehr über Upgradeeinstellungen.

isUpgrade - Aktualisieren der Anwendung
boolean. Optional. Verwenden Sie , wenn overridePublishProfileSettings = true. Standardwert. true.

Überschreibt die Anwendung, wenn der Wert auf falsefestgelegt ist.

unregisterUnusedVersions - Aufheben der Registrierung nicht verwendeter Versionen
boolean. Standardwert. true.

Optional. Gibt an, ob alle nicht verwendeten Versionen des Anwendungstyps nach einem Upgrade entfernt werden.

upgradeMode - Upgrademodus
string. Erforderlich, wenn overridePublishProfileSettings = true && isUpgrade = true. Zulässige Werte: Monitored, UnmonitoredAuto und UnmonitoredManual. Standardwert. Monitored.

FailureAction - FailureAction
string. Erforderlich, wenn overridePublishProfileSettings = true && isUpgrade = true && upgradeMode = Monitored. Zulässige Werte: Rollback, Manual. Standardwert. Rollback.

UpgradeReplicaSetCheckTimeoutSec - UpgradeReplicaSetCheckTimeoutSec
string. Optional. Verwenden Sie , wenn overridePublishProfileSettings = true && isUpgrade = true.

TimeoutSec - TimeoutSec
string. Optional. Verwenden Sie , wenn overridePublishProfileSettings = true && isUpgrade = true.

ForceRestart - ForceRestart
boolean. Optional. Verwenden Sie , wenn overridePublishProfileSettings = true && isUpgrade = true. Standardwert. false.

HealthCheckRetryTimeoutSec - HealthCheckRetryTimeoutSec
string. Optional. Verwenden Sie , wenn overridePublishProfileSettings = true && isUpgrade = true && upgradeMode = Monitored.

HealthCheckWaitDurationSec - HealthCheckWaitDurationSec
string. Optional. Verwenden Sie , wenn overridePublishProfileSettings = true && isUpgrade = true && upgradeMode = Monitored.

HealthCheckStableDurationSec - HealthCheckStableDurationSec
string. Optional. Verwenden Sie , wenn overridePublishProfileSettings = true && isUpgrade = true && upgradeMode = Monitored.

UpgradeDomainTimeoutSec - UpgradeDomainTimeoutSec
string. Optional. Verwenden Sie , wenn overridePublishProfileSettings = true && isUpgrade = true && upgradeMode = Monitored.

ConsiderWarningAsError - ConsiderWarningAsError
boolean. Optional. Verwenden Sie , wenn overridePublishProfileSettings = true && isUpgrade = true && upgradeMode = Monitored. Standardwert. false.

DefaultServiceTypeHealthPolicy - DefaultServiceTypeHealthPolicy
string. Optional. Verwenden Sie , wenn overridePublishProfileSettings = true && isUpgrade = true && upgradeMode = Monitored.

MaxPercentUnhealthyDeployedApplications - MaxPercentUnhealthyDeployedApplications
string. Optional. Verwenden Sie , wenn overridePublishProfileSettings = true && isUpgrade = true && upgradeMode = Monitored.

UpgradeTimeoutSec - UpgradeTimeoutSec
string. Optional. Verwenden Sie , wenn overridePublishProfileSettings = true && isUpgrade = true && upgradeMode = Monitored.

ServiceTypeHealthPolicyMap - ServiceTypeHealthPolicyMap
string. Optional. Verwenden Sie , wenn overridePublishProfileSettings = true && isUpgrade = true && upgradeMode = Monitored.

configureDockerSettings - Konfigurieren von Docker-Einstellungen
boolean. Standardwert. false.

Konfiguriert die Anwendung mit den angegebenen Docker-Einstellungen.

registryCredentials - Quelle für Registrierungsanmeldeinformationen
string. Erforderlich, wenn configureDockerSettings = true. Zulässige Werte: AzureResourceManagerEndpoint (Azure Resource Manager Service Connection), ContainerRegistryEndpoint (Container Registry Service Connection), UsernamePassword (Benutzername und Kennwort). Standardwert. AzureResourceManagerEndpoint.

Gibt an, wie Anmeldeinformationen für die Docker-Registrierung bereitgestellt werden.

dockerRegistryConnection - Docker Registry Service-Verbindung
Eingabealias: dockerRegistryEndpoint. string. Erforderlich, wenn configureDockerSettings = true && registryCredentials = ContainerRegistryEndpoint.

Gibt eine Docker-Registrierungsdienstverbindung an. Erforderlich für Befehle, die bei einer Registrierung authentifiziert werden müssen.

Hinweis

Die Aufgabe versucht, das Registrierungsgeheimnis vor der Übertragung an den Service Fabric-Cluster zu verschlüsseln. Für die Aufgabe muss jedoch das Serverzertifikat des Clusters auf dem Agentcomputer installiert sein. Wenn das Zertifikat nicht vorhanden ist, wird das Registrierungsgeheimnis nicht verschlüsselt.

azureSubscription - Azure-Abonnement
Eingabealias: azureSubscriptionEndpoint. string. Erforderlich, wenn configureDockerSettings = true && registryCredentials = AzureResourceManagerEndpoint.

Gibt ein Azure-Abonnement an.

Hinweis

Die Aufgabe versucht, das Registrierungsgeheimnis zu verschlüsseln, bevor es an den Service Fabric-Cluster übertragen wird. Für die Aufgabe muss jedoch das Serverzertifikat des Clusters auf dem Agentcomputer installiert sein. Wenn das Zertifikat nicht vorhanden ist, wird das Registrierungsgeheimnis nicht verschlüsselt.

registryUserName - Registrierungsbenutzername
string. Optional. Verwenden Sie , wenn configureDockerSettings = true && registryCredentials = UsernamePassword.

Gibt den Benutzernamen für die Docker-Registrierung an.

registryPassword - Registrierungskennwort
string. Optional. Verwenden Sie , wenn configureDockerSettings = true && registryCredentials = UsernamePassword.

Gibt das Kennwort für die Docker-Registrierung an. Wenn das Kennwort nicht verschlüsselt ist, sollten Sie eine benutzerdefinierte Geheimnisvariable der Releasepipeline verwenden, um es zu speichern.

passwordEncrypted - Kennwort verschlüsselt
boolean. Optional. Verwenden Sie , wenn configureDockerSettings = true && registryCredentials = UsernamePassword. Standardwert. true.

Sie sollten Ihr Kennwort mit Invoke-ServiceFabricEncryptText verschlüsseln. Wenn dies nicht der Fehler ist, und ein Zertifikat, das dem Serverzertifikatfingerabdruck in der Clusterdienstverbindung entspricht, auf dem Build-Agent installiert ist, wird dieses Zertifikat zum Verschlüsseln des Kennworts verwendet. Andernfalls tritt ein Fehler auf.

Optionen für die Vorgangskontrolle

Alle Vorgänge verfügen zusätzlich zu ihren Eingaben über Steuerungsoptionen. Weitere Informationen finden Sie unter Steuerungsoptionen und allgemeine Aufgabeneigenschaften.

Ausgabevariablen

Keine.

Hinweise

Verwenden Sie diese Aufgabe, um eine Service Fabric-Anwendung in einem Cluster bereitzustellen. Mit dieser Aufgabe wird eine Azure Service Fabric-Anwendung gemäß den im Veröffentlichungsprofil definierten Einstellungen in einem Cluster bereitgestellt.

Service Fabric

Diese Aufgabe verwendet eine Service Fabric-Installation, um eine Verbindung mit einem Service Fabric-Cluster herzustellen und Elemente in diesem bereitzustellen. Laden Sie Service Fabric herunter, und installieren Sie Service Fabric auf dem Build-Agent.

Anforderungen

Anforderung	BESCHREIBUNG
Pipelinetypen	YAML, Klassischer Build, klassisches Release
Wird ausgeführt auf	Agent, DeploymentGroup
Forderungen	Selbstgehostete Agents müssen über Funktionen verfügen, die den folgenden Anforderungen entsprechen, um Aufträge auszuführen, die diese Aufgabe verwenden: Cmd
Capabilities	Diese Aufgabe erfüllt keine Anforderungen an nachfolgende Aufgaben im Auftrag.
Befehlseinschränkungen	Any
Setzbare Variablen	Any
Agent-Version	1.95.0 oder höher
Aufgabenkategorie	Bereitstellen