ServiceFabricDeploy@1 - Attività distribuzione di applicazioni di Service Fabric v1

Usare questa attività per distribuire un'applicazione di Service Fabric in un cluster. Questa attività distribuisce un'applicazione di Azure Service Fabric in un cluster in base alle impostazioni definite nel profilo di pubblicazione.

Nota

Questa attività non supporta l'autenticazione di Azure Resource Manager con la federazione delle identità del flusso di lavoro.

Sintassi

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

Input

applicationPackagePath - Pacchetto applicazione
string. Obbligatorio.

Specifica il percorso del pacchetto dell'applicazione da distribuire. Le variabili e i caratteri jolly possono essere usati nel percorso.

serviceConnectionName - Connessione al servizio cluster
string. Obbligatorio.

Specifica la connessione al servizio Azure Service Fabric da usare per connettersi al cluster. Le impostazioni definite in questa connessione al servizio a cui si fa riferimento eseguono l'override di quelle definite nel profilo di pubblicazione. Scegliere di Manage registrare una nuova connessione al servizio.

Per connettersi al cluster, l'attività di Service Fabric usa l'archivio certificati del computer per archiviare le informazioni sul certificato. Se due versioni vengono eseguite insieme in un computer usando lo stesso certificato, verranno avviate correttamente. Tuttavia, se una delle attività è stata completata, il certificato dell'archivio certificati del computer verrà pulito, che influisce sulla seconda versione.

publishProfilePath - Pubblica profilo
string.

facoltativo. Specifica il percorso del file di profilo di pubblicazione che definisce le impostazioni da usare. Le variabili e i caratteri jolly possono essere usati nel percorso. Altre informazioni su come creare profili di pubblicazione in Visual Studio.

applicationParameterPath - Parametri dell'applicazione
string.

facoltativo. Specifica il percorso del file di parametri dell'applicazione. Le variabili e i caratteri jolly possono essere usati nel percorso. Se specificato, questo esegue l'override del valore nel profilo di pubblicazione. Altre informazioni su come creare un file di parametri dell'applicazione in Visual Studio.

overrideApplicationParameter - Eseguire l'override dei parametri dell'applicazione
boolean. Valore predefinito: false.

facoltativo. Specifica le variabili definite nella pipeline di compilazione o versione corrispondenti alle Parameter Name voci nel file manifesto dell'applicazione. Altre informazioni su come creare un file di parametri dell'applicazione in Visual Studio. Esempio:

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

Se l'applicazione ha un parametro definito come nell'esempio precedente e si vuole modificare il conteggio delle partizioni in 2, è possibile definire una pipeline di versione o una variabile SampleApp_PartitionCount di ambiente e il relativo valore come 2.

Nota

Se le stesse variabili sono definite nella pipeline di versione e nell'ambiente, le variabili di ambiente sostituiscono le variabili della pipeline di rilascio.

compressPackage - Comprimi pacchetto
boolean. Valore predefinito: false.

facoltativo. Specifica se il pacchetto dell'applicazione deve essere compresso prima della copia nell'archivio immagini. Se abilitata, il valore viene sottoposto a override nel profilo di pubblicazione. Altre informazioni sulla compressione dei pacchetti.

copyPackageTimeoutSec - CopyPackageTimeoutSec
string.

facoltativo. Specifica il timeout in secondi per la copia del pacchetto dell'applicazione nell'archivio immagini. Se specificato, questo esegue l'override del valore nel profilo di pubblicazione.

registerPackageTimeoutSec - RegisterPackageTimeoutSec
string.

facoltativo. Specifica il timeout in secondi per la registrazione o la registrazione di un pacchetto dell'applicazione.

overwriteBehavior - Sovrascrivere il comportamento
string. Obbligatorio. Valori consentiti: Always, Never, SameAppTypeAndVersion. Valore predefinito: SameAppTypeAndVersion.

Sovrascrive il comportamento se un'applicazione esiste nel cluster con lo stesso nome e gli aggiornamenti non sono stati configurati.

Never non rimuoverà l'applicazione esistente. Questo è il comportamento predefinito.

Always rimuoverà l'applicazione esistente, anche se il tipo di applicazione e la versione sono diversi dall'applicazione creata.

SameAppTypeAndVersion rimuoverà l'applicazione esistente solo se il relativo tipo di applicazione e la versione corrisponde all'applicazione creata.

skipUpgradeSameTypeAndVersion - Ignorare l'aggiornamento per lo stesso tipo e versione
boolean. Valore predefinito: false.

facoltativo. Specifica se un aggiornamento verrà ignorato se lo stesso tipo di applicazione e versione esiste già nel cluster; in caso contrario, l'aggiornamento ha esito negativo durante la convalida. Se abilitata, le distribuzioni sono idempotenti.

skipPackageValidation - Ignorare la convalida del pacchetto
boolean. Valore predefinito: false.

facoltativo. Specifica se il pacchetto deve essere convalidato o meno prima della distribuzione. Altre informazioni sulla convalida del pacchetto.

useDiffPackage - Usare il pacchetto Diff
boolean. Valore predefinito: false.

facoltativo. Gli aggiornamenti tramite un pacchetto diff che contiene solo i file dell'applicazione aggiornati, il manifesto dell'applicazione aggiornato e i file manifesto del servizio.

Un pacchetto diff viene creato confrontando il pacchetto specificato nell'input del pacchetto dell'applicazione rispetto al pacchetto attualmente registrato nel cluster di destinazione. Se una versione del servizio nel pacchetto corrente del cluster è uguale al nuovo pacchetto, il pacchetto del servizio verrà rimosso dal nuovo pacchetto dell'applicazione. Altre informazioni sui pacchetti diff.

overridePublishProfileSettings - Eseguire l'override di tutte le impostazioni di aggiornamento del profilo di pubblicazione
boolean. Valore predefinito: false.

facoltativo. Esegue l'override di tutte le impostazioni di aggiornamento con valori specificati o il valore predefinito (se non specificato). Altre informazioni sulle impostazioni di aggiornamento.

isUpgrade - Aggiornare l'applicazione
boolean. facoltativo. Usare quando overridePublishProfileSettings = true. Valore predefinito: true.

Sovrascrive l'applicazione se il valore è impostato su false.

unregisterUnusedVersions - Annullare la registrazione delle versioni inutilizzate
boolean. Valore predefinito: true.

facoltativo. Indica se tutte le versioni inutilizzate del tipo di applicazione verranno rimosse dopo un aggiornamento.

upgradeMode - Modalità di aggiornamento
string. Obbligatorio quando overridePublishProfileSettings = true && isUpgrade = true. Valori consentiti: Monitored, UnmonitoredAuto, UnmonitoredManual. Valore predefinito: Monitored.

FailureAction - ErroreAction
string. Obbligatorio quando overridePublishProfileSettings = true && isUpgrade = true && upgradeMode = Monitored. Valori consentiti: Rollback, Manual. Valore predefinito: Rollback.

UpgradeReplicaSetCheckTimeoutSec - UpgradeReplicaSetCheckTimeoutSec
string. facoltativo. Usare quando overridePublishProfileSettings = true && isUpgrade = true.

TimeoutSec - TimeoutSec
string. facoltativo. Usare quando overridePublishProfileSettings = true && isUpgrade = true.

ForceRestart - ForceRestart
boolean. facoltativo. Usare quando overridePublishProfileSettings = true && isUpgrade = true. Valore predefinito: false.

HealthCheckRetryTimeoutSec - HealthCheckRetryTimeoutSec
string. facoltativo. Usare quando overridePublishProfileSettings = true && isUpgrade = true && upgradeMode = Monitored.

HealthCheckWaitDurationSec - HealthCheckWaitDurationSec
string. facoltativo. Usare quando overridePublishProfileSettings = true && isUpgrade = true && upgradeMode = Monitored.

HealthCheckStableDurationSec - HealthCheckStableDurationSec
string. facoltativo. Usare quando overridePublishProfileSettings = true && isUpgrade = true && upgradeMode = Monitored.

UpgradeDomainTimeoutSec - UpgradeDomainTimeoutSec
string. facoltativo. Usare quando overridePublishProfileSettings = true && isUpgrade = true && upgradeMode = Monitored.

ConsiderWarningAsError - ConsiderWarningAsError
boolean. facoltativo. Usare quando overridePublishProfileSettings = true && isUpgrade = true && upgradeMode = Monitored. Valore predefinito: false.

DefaultServiceTypeHealthPolicy - DefaultServiceTypeHealthPolicy
string. facoltativo. Usare quando overridePublishProfileSettings = true && isUpgrade = true && upgradeMode = Monitored.

MaxPercentUnhealthyDeployedApplications - MaxPercentUnhealthyDeployedApplications
string. facoltativo. Usare quando overridePublishProfileSettings = true && isUpgrade = true && upgradeMode = Monitored.

UpgradeTimeoutSec - UpgradeTimeoutSec
string. facoltativo. Usare quando overridePublishProfileSettings = true && isUpgrade = true && upgradeMode = Monitored.

ServiceTypeHealthPolicyMap - ServiceTypeHealthPolicyMap
string. facoltativo. Usare quando overridePublishProfileSettings = true && isUpgrade = true && upgradeMode = Monitored.

configureDockerSettings - Configurare le impostazioni di Docker
boolean. Valore predefinito: false.

Configura l'applicazione con le impostazioni di Docker specificate.

registryCredentials - Origine credenziali del Registro di sistema
string. Obbligatorio quando configureDockerSettings = true. Valori consentiti: AzureResourceManagerEndpoint (connessione al servizio azure Resource Manager), ContainerRegistryEndpoint (connessione al servizio Registro Container), UsernamePassword (nome utente e password). Valore predefinito: AzureResourceManagerEndpoint.

Specifica come vengono fornite le credenziali per il Registro di sistema Docker.

dockerRegistryConnection - Connessione al servizio Registro di sistema Docker
Alias di input: dockerRegistryEndpoint. string. Obbligatorio quando configureDockerSettings = true && registryCredentials = ContainerRegistryEndpoint.

Specifica una connessione al servizio del Registro di sistema Docker. Obbligatorio per i comandi che devono eseguire l'autenticazione con un registro.

Nota

L'attività tenta di crittografare il segreto del Registro di sistema prima di trasmetterlo al cluster di Service Fabric. Tuttavia, l'attività richiede l'installazione del certificato server del cluster nel computer dell'agente. Se il certificato non è presente, il segreto del Registro di sistema non verrà crittografato.

azureSubscription - Sottoscrizione di Azure
Alias di input: azureSubscriptionEndpoint. string. Obbligatorio quando configureDockerSettings = true && registryCredentials = AzureResourceManagerEndpoint.

Specifica una sottoscrizione di Azure.

Nota

L'attività tenterà di crittografare il segreto del Registro di sistema prima di trasmetterlo al cluster di Service Fabric. Tuttavia, l'attività richiede l'installazione del certificato server del cluster nel computer dell'agente. Se il certificato non è presente, il segreto del Registro di sistema non verrà crittografato.

registryUserName - Nome utente del Registro di sistema
string. facoltativo. Usare quando configureDockerSettings = true && registryCredentials = UsernamePassword.

Specifica il nome utente per il registro Docker.

registryPassword - Password del Registro di sistema
string. facoltativo. Usare quando configureDockerSettings = true && registryCredentials = UsernamePassword.

Specifica la password per il Registro di sistema Docker. Se la password non è crittografata, è consigliabile usare una variabile privata della pipeline di versione personalizzata per archiviarla.

passwordEncrypted - Password crittografata
boolean. facoltativo. Usare quando configureDockerSettings = true && registryCredentials = UsernamePassword. Valore predefinito: true.

È consigliabile crittografare la password usando Invoke-ServiceFabricEncryptText. In caso contrario, nell'agente di compilazione verrà installato un certificato corrispondente all'identificazione personale del certificato del server nella connessione al servizio cluster, tale certificato verrà usato per crittografare la password; in caso contrario, si verificherà un errore.

Opzioni di controllo delle attività

Tutte le attività dispongono di opzioni di controllo oltre ai relativi input attività. Per altre informazioni, vedere Opzioni di controllo e proprietà comuni delle attività.

Variabili di output

Nessuno.

Osservazioni

Usare questa attività per distribuire un'applicazione di Service Fabric in un cluster. Questa attività distribuisce un'applicazione di Azure Service Fabric in un cluster in base alle impostazioni definite nel profilo di pubblicazione.

Service Fabric

Questa attività usa un'installazione di Service Fabric per connettersi e distribuire a un cluster di Service Fabric. Scaricare e installare Service Fabric nell'agente di compilazione.

Requisiti

Requisito	Descrizione
Tipi di pipeline	YAML, build classica, versione classica
Viene eseguito in	Agente, DeploymentGroup
Richieste	Gli agenti self-hosted devono avere funzionalità che soddisfano le richieste seguenti per eseguire processi che usano questa attività: Cmd
Capabilities	Questa attività non soddisfa le richieste per le attività successive nel processo.
Restrizioni dei comandi	Qualsiasi
Variabili impostabili	Qualsiasi
Versione agente	1.95.0 o versione successiva
Categoria attività	Distribuire