ServiceFabricComposeDeploy@0 - Attività Distribuzione di Service Fabric Compose v0

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

Sintassi

# Service Fabric Compose deploy v0
# Deploy a Docker Compose application to an Azure Service Fabric cluster.
- task: ServiceFabricComposeDeploy@0
  inputs:
    clusterConnection: # string. Alias: serviceConnectionName. Required. Cluster Service Connection. 
    composeFilePath: '**/docker-compose.yml' # string. Required. Compose File Path. Default: **/docker-compose.yml.
    applicationName: 'fabric:/Application1' # string. Required. Application Name. Default: fabric:/Application1.
  # Registry Settings
    registryCredentials: 'AzureResourceManagerEndpoint' # 'AzureResourceManagerEndpoint' | 'ContainerRegistryEndpoint' | 'UsernamePassword' | 'None'. Required. Registry Credentials Source. Default: AzureResourceManagerEndpoint.
    #dockerRegistryConnection: # string. Alias: dockerRegistryEndpointName. Optional. Use when registryCredentials = ContainerRegistryEndpoint. Docker Registry Service Connection. 
    azureSubscription: # string. Alias: azureSubscriptionEndpoint. Required when registryCredentials = AzureResourceManagerEndpoint. Azure subscription. 
    #registryUserName: # string. Optional. Use when registryCredentials = UsernamePassword. Registry User Name. 
    #registryPassword: # string. Optional. Use when registryCredentials = UsernamePassword. Registry Password. 
    #passwordEncrypted: true # boolean. Optional. Use when registryCredentials = UsernamePassword. Password Encrypted. Default: true.
  # Advanced Settings
    #upgrade: false # boolean. Upgrade. Default: false.
    #deployTimeoutSec: # string. Deploy Timeout (s). 
    #removeTimeoutSec: # string. Remove Timeout (s). 
    #getStatusTimeoutSec: # string. Get Status Timeout (s).
# Service Fabric Compose Deploy v0
# Deploy a docker-compose application to a Service Fabric cluster.
- task: ServiceFabricComposeDeploy@0
  inputs:
    clusterConnection: # string. Alias: serviceConnectionName. Required. Cluster Service Connection. 
    composeFilePath: '**/docker-compose.yml' # string. Required. Compose File Path. Default: **/docker-compose.yml.
    applicationName: 'fabric:/Application1' # string. Required. Application Name. Default: fabric:/Application1.
  # Registry Settings
    registryCredentials: 'AzureResourceManagerEndpoint' # 'AzureResourceManagerEndpoint' | 'ContainerRegistryEndpoint' | 'UsernamePassword' | 'None'. Required. Registry Credentials Source. Default: AzureResourceManagerEndpoint.
    #dockerRegistryConnection: # string. Alias: dockerRegistryEndpointName. Optional. Use when registryCredentials = ContainerRegistryEndpoint. Docker Registry Service Connection. 
    azureSubscription: # string. Alias: azureSubscriptionEndpoint. Required when registryCredentials = AzureResourceManagerEndpoint. Azure subscription. 
    #registryUserName: # string. Optional. Use when registryCredentials = UsernamePassword. Registry User Name. 
    #registryPassword: # string. Optional. Use when registryCredentials = UsernamePassword. Registry Password. 
    #passwordEncrypted: true # boolean. Optional. Use when registryCredentials = UsernamePassword. Password Encrypted. Default: true.
  # Advanced Settings
    #upgrade: false # boolean. Upgrade. Default: false.
    #deployTimeoutSec: # string. Deploy Timeout (s). 
    #removeTimeoutSec: # string. Remove Timeout (s). 
    #getStatusTimeoutSec: # string. Get Status Timeout (s).

Input

clusterConnection - Connessione al servizio cluster
Alias di input: serviceConnectionName. string. Obbligatorio.

Specifica una connessione al servizio Azure Service Fabric da usare per connettersi al cluster. Scegliere Manage di registrare una nuova connessione al servizio.


composeFilePath - Compose File Path
string. Obbligatorio. Valore predefinito: **/docker-compose.yml.

Specifica il percorso del file compose da distribuire. Le variabili e i caratteri jolly possono essere usati nel percorso. Esempio: $(System.DefaultWorkingDirectory)/**/drop/projectartifacts/**/docker-compose.yml.

Nota

La combinazione di file compose non è supportata come parte di questa attività.


applicationName - Nome applicazione
string. Obbligatorio. Valore predefinito: fabric:/Application1.

Specifica il nome dell'applicazione di Service Fabric dell'applicazione distribuita. Usare fabric:/ come prefisso. I nomi delle applicazioni all'interno di un cluster di Service Fabric devono essere univoci.


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

Specifica come verranno fornite le credenziali per il registro contenitori Docker all'attività di distribuzione. Di seguito sono elencati i valori consentiti:

  • AzureResourceManagerEndpoint(Connessione al servizio Resource Manager di Azure): usa azureSubscription per ottenere un ID e una chiave dell'entità servizio per un Registro Azure Container.
  • ContainerRegistryEndpoint (connessione al servizio Registro Container): usa dockerRegistryConnection per selezionare una connessione al servizio registro Docker. Se un certificato corrispondente all'identificazione personale del certificato server nella connessione al servizio cluster è installato nell'agente di compilazione, verrà usato per crittografare la password; in caso contrario, la password non verrà crittografata.
  • UsernamePassword (Nome utente e password): usa registryUsername e registryPassword per archiviare il nome utente e la password per il registro Docker. Le password devono essere crittografate usando Invoke-ServiceFabricEncryptText con l'opzione Password Encrypted . Se le password non sono crittografate con Invoke-ServiceFabricEncryptTexte un certificato corrispondente all'identificazione personale del certificato del server nella connessione cluster è installato nell'agente di compilazione, il certificato verrà usato per crittografare la password. In caso contrario, la password non verrà crittografata e verrà inviata in testo non crittografato.
  • None: non vengono fornite credenziali del Registro di sistema. Viene usato per accedere ai registri contenitori pubblici.

dockerRegistryConnection - Connessione al servizio Registro di sistema Docker
Alias di input: dockerRegistryEndpointName. string. facoltativo. Usare quando registryCredentials = ContainerRegistryEndpoint.

Specifica una connessione al servizio del Registro di sistema Docker. Se un certificato corrispondente all'identificazione personale del certificato server nella connessione al servizio cluster è installato nell'agente di compilazione, verrà usato per crittografare la password; in caso contrario, la password non verrà crittografata.


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

Specifica una sottoscrizione di Azure.


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

Specifica il nome utente per il registro Docker.


registryPassword - Password del Registro di sistema
string. facoltativo. Usare quando 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 registryCredentials = UsernamePassword. Valore predefinito: true.

Crittografa la password usando Invoke-ServiceFabricEncryptText. Se non si crittografa la password e viene installato un certificato corrispondente all'identificazione personale del certificato del server nella connessione al servizio cluster nell'agente di compilazione, verrà usato per crittografare la password; in caso contrario, si verificherà un errore.


upgrade - Aggiornamento
boolean. Valore predefinito: false.

Aggiorna una distribuzione esistente anziché rimuoverla.


deployTimeoutSec - Distribuisci timeout (s)
string.

Specifica il timeout, espresso in secondi, per la distribuzione dell'applicazione.


removeTimeoutSec - Rimuovi timeout (s)
string.

Specifica il timeout, espresso in secondi, per la rimozione di un'applicazione esistente.


getStatusTimeoutSec - Get Status Timeout (s)
string.

Specifica il timeout, espresso in secondi, per ottenere lo stato di un'applicazione esistente.


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 Docker-compose in un cluster di Service Fabric. Questa attività distribuisce un'applicazione di Azure Service Fabric in un cluster in base alle impostazioni definite nel file compose.

Nota

Questa attività è attualmente in anteprima e richiede una versione di anteprima di Service Fabric che supporta la distribuzione compose. Vedere Supporto per la distribuzione di Docker Compose in Azure Service Fabric.

Service Fabric

  • Questa attività usa un'installazione di Service Fabric per connettersi e distribuire a un cluster di Service Fabric.
  • Scaricare e installare Azure Service Fabric Core SDK 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