Nota
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare ad accedere o modificare le directory.
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare a modificare le directory.
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 'autenticazione di Azure Resource Manager con la federazione dell'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.
Ingressi dati
applicationPackagePath
-
pacchetto dell'applicazione
string. Obbligatorio.
Specifica il percorso del pacchetto dell'applicazione da distribuire. le variabili e i caratteri jolly possono essere usati nel percorso.
connessione al servizio cluster serviceConnectionName -
string. Obbligatorio.
Specifica la connessione al servizio Azure Service Fabric da usare per connettersi al cluster. Le impostazioni definite in questa connessione al servizio di riferimento sostituiscono quelle definite nel profilo di pubblicazione. Scegliere Manage per 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 dall'archivio certificati del computer verrà pulito, che influisce sulla seconda versione.
profilo di pubblicazione publishProfilePath -
string.
Opzionale. Specifica il percorso del file del 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.
parametri dell'applicazione applicationParameterPath -
string.
Opzionale. Specifica il percorso del file dei parametri dell'applicazione. le variabili e i caratteri jolly possono essere usati nel percorso. Se specificato, viene eseguito 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
Opzionale. Specifica che le variabili definite nella pipeline di compilazione o versione vengono confrontate con le voci Parameter Name 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 numero di partizioni in 2, è possibile definire una pipeline di versione o una variabile di ambiente SampleApp_PartitionCount e il relativo valore come 2.
Nota
Se le stesse variabili sono definite nella pipeline di versione e nell'ambiente, le variabili di ambiente supereranno le variabili della pipeline di versione.
compressPackage
-
Comprimi pacchetto
boolean. Valore predefinito: false
Opzionale. Specifica se il pacchetto dell'applicazione deve essere compresso prima della copia nell'archivio immagini. Se abilitata, viene eseguito l'override del valore nel profilo di pubblicazione. Altre informazioni sulla compressione dei pacchetti .
copyPackageTimeoutSec
-
copyPackageTimeoutSec
string.
Opzionale. Specifica il timeout in secondi per la copia del pacchetto dell'applicazione nell'archivio immagini. Se specificato, viene eseguito l'override del valore nel profilo di pubblicazione.
registerPackageTimeoutSec
-
RegisterPackageTimeoutSec
string.
Opzionale. Specifica il timeout in secondi per la registrazione o la annullamento della 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. Si tratta del 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 tipo di applicazione e la versione corrispondono a quello dell'applicazione in fase di creazione.
skipUpgradeSameTypeAndVersion
-
Ignorare l'aggiornamento per lo stesso tipo e versione
boolean. Valore predefinito: false
Opzionale. Specifica se un aggiornamento verrà ignorato se lo stesso tipo di applicazione e la stessa versione esistono già nel cluster; in caso contrario, l'aggiornamento non riesce durante la convalida. Se abilitata, le distribuzioni di nuovo sono idempotenti.
skipPackageValidation
-
Ignorare la convalida del pacchetto
boolean. Valore predefinito: false
Opzionale. Specifica se il pacchetto deve essere convalidato o meno prima della distribuzione. Altre informazioni sulla convalida dei pacchetti .
useDiffPackage
-
Usare pacchetto Diff
boolean. Valore predefinito: false
Opzionale. Gli aggiornamenti usano un pacchetto diff che contiene solo i file dell'applicazione aggiornati, il manifesto dell'applicazione aggiornato e i file manifesto del servizio.
Viene creato un pacchetto diff confrontando il pacchetto specificato nell'input del pacchetto dell'applicazione con il pacchetto attualmente registrato nel cluster di destinazione. Se una versione del servizio nel pacchetto corrente del cluster corrisponde al nuovo pacchetto, questo 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
Opzionale. Esegue l'override di tutte le impostazioni di aggiornamento con i valori specificati o il valore predefinito (se non specificato). Altre informazioni sulle impostazioni di aggiornamento .
isUpgrade
-
Aggiornare il dell'applicazione
boolean. Opzionale. 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
Opzionale. 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
-
Azione di errore
string. Obbligatorio quando overridePublishProfileSettings = true && isUpgrade = true && upgradeMode = Monitored. Valori consentiti: Rollback, Manual. Valore predefinito: Rollback
UpgradeReplicaSetCheckTimeoutSec
-
UpgradeReplicaSetCheckTimeoutSec
string. Opzionale. Usare quando overridePublishProfileSettings = true && isUpgrade = true.
TimeoutSec
-
TimeoutSec
string. Opzionale. Usare quando overridePublishProfileSettings = true && isUpgrade = true.
ForceRestart
-
ForzaRiavvio
boolean. Opzionale. Usare quando overridePublishProfileSettings = true && isUpgrade = true. Valore predefinito: false
HealthCheckRetryTimeoutSec
-
HealthCheckRetryTimeoutSec
string. Opzionale. Usare quando overridePublishProfileSettings = true && isUpgrade = true && upgradeMode = Monitored.
HealthCheckWaitDurationSec
-
HealthCheckWaitDurationSec
string. Opzionale. Usare quando overridePublishProfileSettings = true && isUpgrade = true && upgradeMode = Monitored.
HealthCheckStableDurationSec
-
HealthCheckStableDurationSec
string. Opzionale. Usare quando overridePublishProfileSettings = true && isUpgrade = true && upgradeMode = Monitored.
UpgradeDomainTimeoutSec
-
UpgradeDomainTimeoutSec
string. Opzionale. Usare quando overridePublishProfileSettings = true && isUpgrade = true && upgradeMode = Monitored.
ConsiderWarningAsError
-
ConsiderWarningAsError
boolean. Opzionale. Usare quando overridePublishProfileSettings = true && isUpgrade = true && upgradeMode = Monitored. Valore predefinito: false
DefaultServiceTypeHealthPolicy
-
DefaultServiceTypeHealthPolicy
string. Opzionale. Usare quando overridePublishProfileSettings = true && isUpgrade = true && upgradeMode = Monitored.
MaxPercentUnhealthyDeployedApplications
-
MaxPercentUnhealthyDeployedApplications
string. Opzionale. Usare quando overridePublishProfileSettings = true && isUpgrade = true && upgradeMode = Monitored.
UpgradeTimeoutSec
-
UpgradeTimeoutSec
string. Opzionale. Usare quando overridePublishProfileSettings = true && isUpgrade = true && upgradeMode = Monitored.
ServiceTypeHealthPolicyMap
-
ServiceTypeHealthPolicyMap
string. Opzionale. Usare quando overridePublishProfileSettings = true && isUpgrade = true && upgradeMode = Monitored.
configureDockerSettings
-
Configurare le impostazioni di Docker
boolean. Valore predefinito: false
Configura l'applicazione con le impostazioni docker specificate.
registryCredentials
-
'origine delle 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 il modo in cui vengono fornite le credenziali per il Registro di sistema Docker.
dockerRegistryConnection
-
di connessione al servizio registro 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 che il certificato server del cluster sia installato 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 che il certificato server del cluster sia installato 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. Opzionale. Usare quando configureDockerSettings = true && registryCredentials = UsernamePassword.
Specifica il nome utente per il Registro di sistema Docker.
registryPassword
-
password del Registro di sistema
string. Opzionale. Usare quando configureDockerSettings = true && registryCredentials = UsernamePassword.
Specifica la password per il Registro di sistema Docker. Se la password non è crittografata, è necessario usare una variabile del segreto della pipeline di versione personalizzata per archiviarla.
passwordEncrypted
-
password crittografate
boolean. Opzionale. Usare quando configureDockerSettings = true && registryCredentials = UsernamePassword. Valore predefinito: true
È consigliabile crittografare la password usando Invoke-ServiceFabricEncryptText. In caso contrario, e un certificato corrispondente all'identificazione personale del certificato del server nella connessione al servizio cluster viene installato nell'agente di compilazione, 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 in un cluster di Service Fabric. Scaricare e installare di 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 corrispondono alle seguenti richiedono di eseguire processi che usano questa attività: Cmd |
| funzionalità di | Questa attività non soddisfa alcuna richiesta di attività successive nel processo. |
| restrizioni dei comandi | Qualunque |
| variabili impostabili | Qualunque |
| Versione dell'agente | 1.95.0 o versione successiva |
| Categoria attività | Distribuire |