ServiceFabricDeploy@1 – Dienst Fabric-Anwendungsbereitstellung v1-Aufgabe

Verwenden Sie diese Aufgabe, um eine Service Fabric-Anwendung in einem Cluster bereitzustellen. Diese Aufgabe stellt eine Azure Service Fabric-Anwendung gemäß den im Veröffentlichungsprofil definierten Einstellungen auf einem Cluster bereit.

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

applicationPackagePath - Anwendungspaket-
string. Erforderlich.

Gibt den Pfad zum 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 referenzierten Dienstverbindung definierten Einstellungen überschreiben diejenigen, die im Veröffentlichungsprofil definiert sind. Wählen Sie Manage aus, um eine neue Dienstverbindung zu registrieren.

Um eine Verbindung mit dem Cluster herzustellen, verwendet die Dienst fabric-Aufgabe den Computerzertifikatspeicher, um die Informationen zum Zertifikat zu speichern. Wenn zwei Versionen auf einem Computer mit demselben Zertifikat zusammen 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 - Profil veröffentlichen
string.

Wahlfrei. 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 Erstellen von Veröffentlichungsprofilen in Visual Studio.

applicationParameterPath - Anwendungsparameter
string.

Wahlfrei. 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 , wie Sie eine Anwendungsparameterdatei in Visual Studioerstellen.

overrideApplicationParameter - Außerkraftsetzen von Anwendungsparametern
boolean. Standardwert: false.

Wahlfrei. Gibt die variablen an, die in der Build- oder Releasepipeline definiert sind, werden mit den Parameter Name Einträgen in der Anwendungsmanifestdatei abgeglichen. Erfahren Sie mehr über , wie Sie eine Anwendungsparameterdatei in Visual Studioerstellen. Beispiel:

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

Wenn Ihre Anwendung einen Parameter wie im obigen Beispiel definiert hat und Sie die Partitionsanzahl in 2ändern möchten, können Sie eine Releasepipeline oder eine Umgebungsvariable SampleApp_PartitionCount und dessen Wert als 2definieren.

compressPackage - Paket komprimieren
boolean. Standardwert: false.

Wahlfrei. Gibt an, ob das Anwendungspaket vor dem Kopieren in den Bildspeicher komprimiert werden soll. Wenn diese Option aktiviert ist, überschreibt dies den Wert im Veröffentlichungsprofil. Erfahren Sie mehr über Komprimieren von Paketen.

copyPackageTimeoutSec - CopyPackageTimeoutSec-
string.

Wahlfrei. Gibt das Timeout in Sekunden zum Kopieren des Anwendungspakets in den Bildspeicher an. Wenn angegeben, überschreibt dies den Wert im Veröffentlichungsprofil.

registerPackageTimeoutSec - RegisterPackageTimeoutSec-
string.

Wahlfrei. Gibt das Timeout in Sekunden zum Registrieren oder Aufheben der Registrierung eines Anwendungspakets an.

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

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

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

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

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

skipUpgradeSameTypeAndVersion - Upgrade für denselben Typ und dieselbe Version überspringen
boolean. Standardwert: false.

Wahlfrei. 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. Wenn diese Option aktiviert ist, sind erneute Bereitstellungen idempotent.

skipPackageValidation - Paketüberprüfung überspringen
boolean. Standardwert: false.

Wahlfrei. Gibt an, ob das Paket vor der Bereitstellung überprüft werden soll oder nicht. Erfahren Sie mehr über Paketüberprüfung.

useDiffPackage - Diff-Paket- verwenden
boolean. Standardwert: false.

Wahlfrei. 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 übereinstimmt, wird dieses Dienstpaket aus dem neuen Anwendungspaket entfernt. Erfahren Sie mehr über Diff-Pakete.

overridePublishProfileSettings - alle Einstellungen für das Upgrade von Veröffentlichungsprofilen außer Kraft setzen
boolean. Standardwert: false.

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

isUpgrade - Upgrade der Anwendungs-
boolean. Wahlfrei. Wird verwendet, wenn overridePublishProfileSettings = true. Standardwert: true.

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

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

Wahlfrei. 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, UnmonitoredManual. Standardwert: Monitored.

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

UpgradeReplicaSetCheckTimeoutSec - UpgradeReplicaSetCheckTimeoutSec-
string. Wahlfrei. Wird verwendet, wenn overridePublishProfileSettings = true && isUpgrade = true.

TimeoutSec - TimeoutSec-
string. Wahlfrei. Wird verwendet, wenn overridePublishProfileSettings = true && isUpgrade = true.

ForceRestart - ForceRestart-
boolean. Wahlfrei. Wird verwendet, wenn overridePublishProfileSettings = true && isUpgrade = true. Standardwert: false.

HealthCheckRetryTimeoutSec - HealthCheckRetryTimeoutSec
string. Wahlfrei. Wird verwendet, wenn overridePublishProfileSettings = true && isUpgrade = true && upgradeMode = Monitored.

HealthCheckWaitDurationSec - HealthCheckWaitDurationSec
string. Wahlfrei. Wird verwendet, wenn overridePublishProfileSettings = true && isUpgrade = true && upgradeMode = Monitored.

HealthCheckStableDurationSec - HealthCheckStableDurationSec-
string. Wahlfrei. Wird verwendet, wenn overridePublishProfileSettings = true && isUpgrade = true && upgradeMode = Monitored.

UpgradeDomainTimeoutSec - UpgradeDomainTimeoutSec-
string. Wahlfrei. Wird verwendet, wenn overridePublishProfileSettings = true && isUpgrade = true && upgradeMode = Monitored.

ConsiderWarningAsError - ConsiderWarningAsError-
boolean. Wahlfrei. Wird verwendet, wenn overridePublishProfileSettings = true && isUpgrade = true && upgradeMode = Monitored. Standardwert: false.

DefaultServiceTypeHealthPolicy - DefaultServiceTypeHealthPolicy-
string. Wahlfrei. Wird verwendet, wenn overridePublishProfileSettings = true && isUpgrade = true && upgradeMode = Monitored.

MaxPercentUnhealthyDeployedApplications - MaxPercentUnhealthyDeployedApplications-
string. Wahlfrei. Wird verwendet, wenn overridePublishProfileSettings = true && isUpgrade = true && upgradeMode = Monitored.

UpgradeTimeoutSec - UpgradeTimeoutSec-
string. Wahlfrei. Wird verwendet, wenn overridePublishProfileSettings = true && isUpgrade = true && upgradeMode = Monitored.

ServiceTypeHealthPolicyMap - ServiceTypeHealthPolicyMap-
string. Wahlfrei. Wird verwendet, wenn overridePublishProfileSettings = true && isUpgrade = true && upgradeMode = Monitored.

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

Konfiguriert die Anwendung mit den angegebenen Docker-Einstellungen.

registryCredentials - Registrierungsanmeldeinformationsquelle
string. Erforderlich, wenn configureDockerSettings = true. Zulässige Werte: AzureResourceManagerEndpoint (Azure Resource Manager Service Connection), ContainerRegistryEndpoint (ContainerRegistrierungsdienstverbindung), UsernamePassword (Benutzername und Kennwort). Standardwert: AzureResourceManagerEndpoint.

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

dockerRegistryConnection - Verbindung mit dem Docker-Registrierungsdienst
Eingabealias: dockerRegistryEndpoint. string. Erforderlich, wenn configureDockerSettings = true && registryCredentials = ContainerRegistryEndpoint.

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

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

Gibt ein Azure-Abonnement an.

registryUserName - Registrierungsbenutzername
string. Wahlfrei. Wird verwendet, wenn configureDockerSettings = true && registryCredentials = UsernamePassword.

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

registryPassword - Registrierungskennwort
string. Wahlfrei. Wird verwendet, 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 Geheimvariable für die Freigabepipeline verwenden, um es zu speichern.

passwordEncrypted - kennwortverschlüsselte
boolean. Wahlfrei. Wird verwendet, wenn configureDockerSettings = true && registryCredentials = UsernamePassword. Standardwert: true.

Sie sollten Ihr Kennwort mit Invoke-ServiceFabricEncryptTextverschlüsseln. Wenn Sie dies nicht tun und ein Zertifikat, das mit dem Serverzertifikatfingerabdruck in der Clusterdienstverbindung übereinstimmt, auf dem Build-Agent installiert ist, wird dieses Zertifikat verwendet, um das Kennwort zu verschlüsseln; andernfalls tritt ein Fehler auf.

Keiner.