ServiceFabricDeploy@1 – úloha nasazení aplikace Service Fabric verze 1

Tuto úlohu použijte k nasazení aplikace Service Fabric do clusteru. Tato úloha nasadí aplikaci Azure Service Fabric do clusteru podle nastavení definovaného v profilu publikování.

Poznámka

Tato úloha nepodporuje ověřování azure Resource Manager s federací identit pracovního postupu.

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.

Vstupy

applicationPackagePath - Balíček aplikace
string. Povinná hodnota.

Určuje cestu k balíčku aplikace, který se má nasadit. V cestě je možné použít proměnné a zástupné é ho.

serviceConnectionName - Připojení clusterové služby
string. Povinná hodnota.

Určuje připojení služby Azure Service Fabric, které se má použít pro připojení ke clusteru. Nastavení definovaná v tomto odkazovaném připojení služby přepíší nastavení definovaná v profilu publikování. Zvolte Manage registraci nového připojení služby.

Pokud se chcete připojit ke clusteru, úloha Service Fabric používá úložiště certifikátů počítače k uložení informací o certifikátu. Pokud dvě verze běží společně na jednom počítači pomocí stejného certifikátu, spustí se správně. Pokud se ale jedna z úloh dokončí, certifikát z úložiště certifikátů počítače se vyčistí, což má vliv na druhou verzi.

publishProfilePath - Publikovat profil
string.

Nepovinný parametr. Určuje cestu k souboru profilu publikování, který definuje nastavení, která se mají použít. V cestě je možné použít proměnné a zástupné é ho. Přečtěte si další informace o vytváření profilů publikování v sadě Visual Studio.

applicationParameterPath - Parametry aplikace
string.

Nepovinný parametr. Určuje cestu k souboru parametrů aplikace. V cestě je možné použít proměnné a zástupné é ho. Pokud je tato hodnota zadána, přepíše se hodnota v profilu publikování. Přečtěte si další informace o tom, jak vytvořit soubor parametrů aplikace v sadě Visual Studio.

overrideApplicationParameter - Přepsání parametrů aplikace
boolean. Výchozí hodnota: false.

Nepovinný parametr. Určuje, že proměnné definované v kanálu sestavení nebo verze se shodují s Parameter Name položkami v souboru manifestu aplikace. Přečtěte si další informace o tom, jak vytvořit soubor parametrů aplikace v sadě Visual Studio. Příklad:

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

Pokud má vaše aplikace parametr definovaný jako v předchozím příkladu a chcete změnit počet oddílů na 2, můžete definovat kanál verze nebo proměnnou SampleApp_PartitionCount prostředí a jeho hodnotu jako 2.

Poznámka

Pokud jsou stejné proměnné definované v kanálu verze a v prostředí, proměnné prostředí nahradí proměnné kanálu verze.

compressPackage - Komprimovat balíček
boolean. Výchozí hodnota: false.

Nepovinný parametr. Určuje, zda má být balíček aplikace před zkopírováním do úložiště imagí komprimován. Pokud je tato možnost povolená, přepíše se hodnota v profilu publikování. Přečtěte si další informace o komprimaci balíčků.

copyPackageTimeoutSec - CopyPackageTimeoutSec
string.

Nepovinný parametr. Určuje časový limit v sekundách pro kopírování balíčku aplikace do úložiště imagí. Pokud je tato hodnota zadána, přepíše se hodnota v profilu publikování.

registerPackageTimeoutSec - RegisterPackageTimeoutSec
string.

Nepovinný parametr. Určuje časový limit v sekundách pro registraci nebo zrušení registrace balíčku aplikace.

overwriteBehavior - Chování přepsání
string. Povinná hodnota. Povolené hodnoty: Always, Never, SameAppTypeAndVersion. Výchozí hodnota: SameAppTypeAndVersion.

Chování přepsání, pokud v clusteru existuje aplikace se stejným názvem a nebyly nakonfigurovány upgrady.

Never stávající aplikaci neodebere. Toto je výchozí chování.

Always odebere existující aplikaci, i když se její typ a verze liší od vytvářené aplikace.

SameAppTypeAndVersion odebere existující aplikaci pouze v případě, že její typ a verze aplikace je stejná jako vytvářená aplikace.

skipUpgradeSameTypeAndVersion - Přeskočit upgrade pro stejný typ a verzi
boolean. Výchozí hodnota: false.

Nepovinný parametr. Určuje, zda bude upgrade vynechán, pokud již v clusteru existuje stejný typ aplikace a verze. v opačném případě upgrade během ověřování selže. Pokud je tato možnost povolená, opětovná nasazení jsou idempotentní.

skipPackageValidation - Přeskočit ověření balíčku
boolean. Výchozí hodnota: false.

Nepovinný parametr. Určuje, jestli se má balíček ověřit před nasazením. Přečtěte si další informace o ověřování balíčků.

useDiffPackage - Použití rozdílových balíčků
boolean. Výchozí hodnota: false.

Nepovinný parametr. Upgraduje pomocí rozdílového balíčku, který obsahuje pouze aktualizované soubory aplikace, aktualizovaný manifest aplikace a soubory manifestu služby.

Rozdílový balíček se vytvoří porovnáním balíčku zadaného ve vstupu balíčku aplikace s balíčkem, který je aktuálně zaregistrovaný v cílovém clusteru. Pokud je verze služby v aktuálním balíčku clusteru stejná jako nový balíček, odebere se tento balíček služby z nového balíčku aplikace. Přečtěte si další informace o rozdílových balíčcích.

overridePublishProfileSettings - Přepsat všechna nastavení upgradu profilu publikování
boolean. Výchozí hodnota: false.

Nepovinný parametr. Přepíše všechna nastavení upgradu buď zadanými hodnotami, nebo výchozí hodnotou (pokud není zadaný). Přečtěte si další informace o nastavení upgradu.

isUpgrade - Upgrade aplikace
boolean. Nepovinný parametr. Použijte, když overridePublishProfileSettings = true. Výchozí hodnota: true.

Pokud je hodnota nastavená na , přepíše aplikaci.false

unregisterUnusedVersions - Zrušení registrace nepoužívaných verzí
boolean. Výchozí hodnota: true.

Nepovinný parametr. Určuje, jestli se po upgradu odeberou všechny nepoužívané verze typu aplikace.

upgradeMode - Režim upgradu
string. Vyžaduje se, když overridePublishProfileSettings = true && isUpgrade = true. Povolené hodnoty: Monitored, UnmonitoredAuto, UnmonitoredManual. Výchozí hodnota: Monitored.

FailureAction - FailureAction
string. Vyžaduje se, když overridePublishProfileSettings = true && isUpgrade = true && upgradeMode = Monitored. Povolené hodnoty: Rollback, Manual. Výchozí hodnota: Rollback.

UpgradeReplicaSetCheckTimeoutSec - UpgradeReplicaSetCheckTimeoutSec
string. Nepovinný parametr. Použijte, když overridePublishProfileSettings = true && isUpgrade = true.

TimeoutSec - TimeoutSec
string. Nepovinný parametr. Použijte, když overridePublishProfileSettings = true && isUpgrade = true.

ForceRestart - ForceRestart
boolean. Nepovinný parametr. Použijte, když overridePublishProfileSettings = true && isUpgrade = true. Výchozí hodnota: false.

HealthCheckRetryTimeoutSec - HealthCheckRetryTimeoutSec
string. Nepovinný parametr. Použijte, když overridePublishProfileSettings = true && isUpgrade = true && upgradeMode = Monitored.

HealthCheckWaitDurationSec - HealthCheckWaitDurationSec
string. Nepovinný parametr. Použijte, když overridePublishProfileSettings = true && isUpgrade = true && upgradeMode = Monitored.

HealthCheckStableDurationSec - HealthCheckStableDurationSec
string. Nepovinný parametr. Použijte, když overridePublishProfileSettings = true && isUpgrade = true && upgradeMode = Monitored.

UpgradeDomainTimeoutSec - UpgradeDomainTimeoutSec
string. Nepovinný parametr. Použijte, když overridePublishProfileSettings = true && isUpgrade = true && upgradeMode = Monitored.

ConsiderWarningAsError - Zvažte chybuWarningAsError
boolean. Nepovinný parametr. Použijte, když overridePublishProfileSettings = true && isUpgrade = true && upgradeMode = Monitored. Výchozí hodnota: false.

DefaultServiceTypeHealthPolicy - DefaultServiceTypeHealthPolicy
string. Nepovinný parametr. Použijte, když overridePublishProfileSettings = true && isUpgrade = true && upgradeMode = Monitored.

MaxPercentUnhealthyDeployedApplications - MaxPercentUnhealthyDeployedApplications
string. Nepovinný parametr. Použijte, když overridePublishProfileSettings = true && isUpgrade = true && upgradeMode = Monitored.

UpgradeTimeoutSec - UpgradeTimeoutSec
string. Nepovinný parametr. Použijte, když overridePublishProfileSettings = true && isUpgrade = true && upgradeMode = Monitored.

ServiceTypeHealthPolicyMap - ServiceTypeHealthPolicyMap
string. Nepovinný parametr. Použijte, když overridePublishProfileSettings = true && isUpgrade = true && upgradeMode = Monitored.

configureDockerSettings - Konfigurace nastavení Dockeru
boolean. Výchozí hodnota: false.

Nakonfiguruje aplikaci se zadaným nastavením Dockeru.

registryCredentials - Zdroj přihlašovacích údajů registru
string. Vyžaduje se, když configureDockerSettings = true. Povolené hodnoty: AzureResourceManagerEndpoint (Připojení služby Azure Resource Manager), ContainerRegistryEndpoint (Připojení ke službě Container Registry Service), UsernamePassword (uživatelské jméno a heslo). Výchozí hodnota: AzureResourceManagerEndpoint.

Určuje, jak se poskytují přihlašovací údaje pro registr Dockeru.

dockerRegistryConnection - Připojení služby Registru Dockeru
Vstupní alias: dockerRegistryEndpoint. string. Vyžaduje se, když configureDockerSettings = true && registryCredentials = ContainerRegistryEndpoint.

Určuje připojení služby registru Dockeru. Vyžaduje se pro příkazy, které se potřebují ověřit pomocí registru.

Poznámka

Úloha se pokusí zašifrovat tajný kód registru před jeho přenosem do clusteru Service Fabric. Úloha ale potřebuje, aby byl na počítači agenta nainstalovaný certifikát serveru clusteru. Pokud certifikát neexistuje, tajný klíč registru nebude zašifrován.

azureSubscription - Předplatné Azure
Vstupní alias: azureSubscriptionEndpoint. string. Vyžaduje se, když configureDockerSettings = true && registryCredentials = AzureResourceManagerEndpoint.

Určuje předplatné Azure.

Poznámka

Úloha se pokusí tajný klíč registru před přenosem do clusteru Service Fabric zašifrovat. Úloha ale potřebuje, aby byl na počítači agenta nainstalovaný certifikát serveru clusteru. Pokud certifikát neexistuje, tajný klíč registru nebude zašifrován.

registryUserName - Uživatelské jméno registru
string. Nepovinný parametr. Použijte, když configureDockerSettings = true && registryCredentials = UsernamePassword.

Určuje uživatelské jméno pro registr Dockeru.

registryPassword - Heslo registru
string. Nepovinný parametr. Použijte, když configureDockerSettings = true && registryCredentials = UsernamePassword.

Určuje heslo pro registr Dockeru. Pokud heslo není šifrované, měli byste k jeho uložení použít vlastní proměnnou tajného klíče kanálu verze.

passwordEncrypted - Zašifrováno heslem
boolean. Nepovinný parametr. Použijte, když configureDockerSettings = true && registryCredentials = UsernamePassword. Výchozí hodnota: true.

Heslo byste měli zašifrovat pomocí funkce Invoke-ServiceFabricEncryptText. Pokud ne a certifikát odpovídající kryptografickému otisku certifikátu serveru v připojení clusterové služby je nainstalován na agenta sestavení, bude tento certifikát použit k šifrování hesla. jinak dojde k chybě.

Možnosti ovládání úloh

Všechny úlohy mají kromě vstupů také možnosti ovládání. Další informace najdete v tématu Možnosti ovládacího prvku a běžné vlastnosti úlohy.

Výstupní proměnné

Žádné

Poznámky

Tuto úlohu použijte k nasazení aplikace Service Fabric do clusteru. Tato úloha nasadí aplikaci Azure Service Fabric do clusteru podle nastavení definovaného v profilu publikování.

Service Fabric

Tato úloha používá instalaci Service Fabric k připojení a nasazení do clusteru Service Fabric. Stáhněte a nainstalujte Service Fabric na agenta sestavení.

Požadavky

Požadavek	Popis
Typy kanálů	YAML, classic build, verze Classic
Spustí se	Agent, DeploymentGroup
Požadavky	Agenti v místním prostředí musí mít funkce , které odpovídají následujícím požadavkům , aby mohli spouštět úlohy, které používají tuto úlohu: Cmd
Možnosti	Tento úkol nesplňuje žádné požadavky na následné úkoly v úloze.
Omezení příkazů	Všechny
Nastavitelné proměnné	Všechny
Verze agenta	1.95.0 nebo vyšší
Kategorie úloh	Nasazení