ServiceFabricDeploy@1 – Service Fabric-programdistribution v1-uppgift

Använd den här uppgiften för att distribuera ett Service Fabric-program till ett kluster. Den här uppgiften distribuerar ett Azure Service Fabric-program till ett kluster enligt de inställningar som definierats i publiceringsprofilen.

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

# Service Fabric Application Deployment v1
# Deploy a 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 - Programpaket
string. Krävs.

Anger sökvägen till det programpaket som ska distribueras. Variabler och jokertecken kan användas i sökvägen.

serviceConnectionName - Klustertjänstanslutning
string. Krävs.

Anger den Azure Service Fabric-tjänstanslutning som ska användas för att ansluta till klustret. Inställningarna som definieras i den här refererade tjänstanslutningen åsidosätter de som definierats i publiceringsprofilen. Välj Manage att registrera en ny tjänstanslutning.

För att ansluta till klustret använder service fabric-uppgiften datorcertifikatarkivet för att lagra information om certifikatet. Om två versioner körs tillsammans på en dator med samma certifikat startar de korrekt. Men om en av uppgifterna är klar rensas certifikatet från datorcertifikatarkivet, vilket påverkar den andra versionen.

publishProfilePath - Publicera profil
string.

Valfritt. Anger sökvägen till publiceringsprofilfilen som definierar de inställningar som ska användas. Variabler och jokertecken kan användas i sökvägen. Läs mer om hur du skapar publiceringsprofiler i Visual Studio.

applicationParameterPath - Programparametrar
string.

Valfritt. Anger sökvägen till filen med programparametrar. Variabler och jokertecken kan användas i sökvägen. Om det anges åsidosätter detta värdet i publiceringsprofilen. Läs mer om hur du skapar en programparametrarfil i Visual Studio.

overrideApplicationParameter - Åsidosätta programparametrar
boolean. Standardvärde: false.

Valfritt. Anger att variablerna som definierats i bygg- eller versionspipelinen matchas mot posterna Parameter Name i programmanifestfilen. Läs mer om hur du skapar en programparametrarfil i Visual Studio. Exempel:

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

Om ditt program har en parameter definierad som i exemplet ovan och du vill ändra partitionsantalet till 2kan du definiera en versionspipeline eller en miljövariabel SampleApp_PartitionCount och dess värde som 2.

compressPackage - Komprimera paket
boolean. Standardvärde: false.

Valfritt. Anger om programpaketet ska komprimeras innan du kopierar till avbildningsarkivet. Om aktiverad åsidosätter detta värdet i publiceringsprofilen. Läs mer om att komprimera paket.

copyPackageTimeoutSec - CopyPackageTimeoutSec
string.

Valfritt. Anger tidsgränsen i sekunder för kopiering av programpaket till avbildningsarkivet. Om det anges åsidosätter detta värdet i publiceringsprofilen.

registerPackageTimeoutSec - RegisterPackageTimeoutSec
string.

Valfritt. Anger tidsgränsen i sekunder för registrering eller avregistrering av ett programpaket.

overwriteBehavior - Skriv över beteende
string. Krävs. Tillåtna värden: Always, Never, SameAppTypeAndVersion. Standardvärde: SameAppTypeAndVersion.

Skriver över beteendet om ett program finns i klustret med samma namn och uppgraderingar inte har konfigurerats.

Never tar inte bort det befintliga programmet. Det här är standardbeteendet.

Always tar bort det befintliga programmet, även om dess programtyp och version skiljer sig från det program som skapas.

SameAppTypeAndVersion tar bara bort det befintliga programmet om dess programtyp och version är samma som programmet som skapas.

skipUpgradeSameTypeAndVersion - Hoppa över uppgradering för samma typ och version
boolean. Standardvärde: false.

Valfritt. Anger om en uppgradering ska hoppas över om samma programtyp och version redan finns i klustret. Annars misslyckas uppgraderingen under valideringen. Om det är aktiverat är omdistributioner idempotent.

skipPackageValidation - Hoppa över paketvalidering
boolean. Standardvärde: false.

Valfritt. Anger om paketet ska verifieras eller inte före distributionen. Läs mer om paketvalidering.

useDiffPackage - Använda Diff-paket
boolean. Standardvärde: false.

Valfritt. Uppgraderingar med hjälp av ett diff-paket som endast innehåller de uppdaterade programfilerna, det uppdaterade programmanifestet och tjänstmanifestfilerna.

Ett diff-paket skapas genom att jämföra paketet som anges i programpaketets indata med det paket som för närvarande är registrerat i målklustret. Om en tjänstversion i klustrets aktuella paket är samma som det nya paketet tas det här tjänstpaketet bort från det nya programpaketet. Läs mer om diff-paket.

overridePublishProfileSettings - Åsidosätta alla uppgraderingsinställningar för publiceringsprofil
boolean. Standardvärde: false.

Valfritt. Åsidosätter alla uppgraderingsinställningar med antingen angivna värden eller standardvärdet (om det inte anges). Läs mer om uppgraderingsinställningar.

isUpgrade - Uppgradera programmet
boolean. Valfritt. Använd när overridePublishProfileSettings = true. Standardvärde: true.

Skriver över programmet om värdet är inställt på false.

unregisterUnusedVersions - Avregistrera oanvända versioner
boolean. Standardvärde: true.

Valfritt. Anger om alla oanvända versioner av programtypen tas bort efter en uppgradering.

upgradeMode - Uppgraderingsläge
string. Krävs när overridePublishProfileSettings = true && isUpgrade = true. Tillåtna värden: Monitored, UnmonitoredAuto, UnmonitoredManual. Standardvärde: Monitored.

FailureAction - FailureAction
string. Krävs när overridePublishProfileSettings = true && isUpgrade = true && upgradeMode = Monitored. Tillåtna värden: Rollback, Manual. Standardvärde: Rollback.

UpgradeReplicaSetCheckTimeoutSec - UpgradeReplicaSetCheckTimeoutSec
string. Valfritt. Använd när overridePublishProfileSettings = true && isUpgrade = true.

TimeoutSec - TimeoutSec
string. Valfritt. Använd när overridePublishProfileSettings = true && isUpgrade = true.

ForceRestart - ForceRestart
boolean. Valfritt. Använd när overridePublishProfileSettings = true && isUpgrade = true. Standardvärde: false.

HealthCheckRetryTimeoutSec - HealthCheckRetryTimeoutSec
string. Valfritt. Använd när overridePublishProfileSettings = true && isUpgrade = true && upgradeMode = Monitored.

HealthCheckWaitDurationSec - HealthCheckWaitDurationSec
string. Valfritt. Använd när overridePublishProfileSettings = true && isUpgrade = true && upgradeMode = Monitored.

HealthCheckStableDurationSec - HealthCheckStableDurationSec
string. Valfritt. Använd när overridePublishProfileSettings = true && isUpgrade = true && upgradeMode = Monitored.

UpgradeDomainTimeoutSec - UpgradeDomainTimeoutSec
string. Valfritt. Använd när overridePublishProfileSettings = true && isUpgrade = true && upgradeMode = Monitored.

ConsiderWarningAsError - ConsiderWarningAsError
boolean. Valfritt. Använd när overridePublishProfileSettings = true && isUpgrade = true && upgradeMode = Monitored. Standardvärde: false.

DefaultServiceTypeHealthPolicy - DefaultServiceTypeHealthPolicy
string. Valfritt. Använd när overridePublishProfileSettings = true && isUpgrade = true && upgradeMode = Monitored.

MaxPercentUnhealthyDeployedApplications - MaxPercentUnhealthyDeployedApplications
string. Valfritt. Använd när overridePublishProfileSettings = true && isUpgrade = true && upgradeMode = Monitored.

UpgradeTimeoutSec - UpgradeTimeoutSec
string. Valfritt. Använd när overridePublishProfileSettings = true && isUpgrade = true && upgradeMode = Monitored.

ServiceTypeHealthPolicyMap - ServiceTypeHealthPolicyMap
string. Valfritt. Använd när overridePublishProfileSettings = true && isUpgrade = true && upgradeMode = Monitored.

configureDockerSettings - Konfigurera Docker-inställningar
boolean. Standardvärde: false.

Konfigurerar programmet med de angivna Docker-inställningarna.

registryCredentials - Källa för registerautentiseringsuppgifter
string. Krävs när configureDockerSettings = true. Tillåtna värden: AzureResourceManagerEndpoint (Azure Resource Manager Service Connection), ContainerRegistryEndpoint (Container Registry Service Connection), UsernamePassword (användarnamn och lösenord). Standardvärde: AzureResourceManagerEndpoint.

Anger hur autentiseringsuppgifter för Docker-registret tillhandahålls.

dockerRegistryConnection - Docker Registry Service-anslutning
Indataalias: dockerRegistryEndpoint. string. Krävs när configureDockerSettings = true && registryCredentials = ContainerRegistryEndpoint.

Anger en Docker-registertjänstanslutning. Krävs för kommandon som behöver autentiseras med ett register.

azureSubscription - Azure-prenumeration
Indataalias: azureSubscriptionEndpoint. string. Krävs när configureDockerSettings = true && registryCredentials = AzureResourceManagerEndpoint.

Anger en Azure-prenumeration.

registryUserName - Registeranvändarnamn
string. Valfritt. Använd när configureDockerSettings = true && registryCredentials = UsernamePassword.

Anger användarnamnet för Docker-registret.

registryPassword - Registerlösenord
string. Valfritt. Använd när configureDockerSettings = true && registryCredentials = UsernamePassword.

Anger lösenordet för Docker-registret. Om lösenordet inte är krypterat bör du använda en anpassad versionspipelinehemlighetsvariabel för att lagra det.

passwordEncrypted - Lösenord krypterat
boolean. Valfritt. Använd när configureDockerSettings = true && registryCredentials = UsernamePassword. Standardvärde: true.

Du bör kryptera lösenordet med Invoke-ServiceFabricEncryptText. Om du inte gör det och ett certifikat som matchar servercertifikatets tumavtryck i klustertjänstanslutningen installeras på byggagenten används certifikatet för att kryptera lösenordet. annars uppstår ett fel.

Inga.