Freigeben über


ServiceFabricComposeDeploy@0– Service Fabric Compose deploy v0 task

Verwenden Sie diese Aufgabe, um eine Docker Compose-Anwendung in einem Service Fabric-Cluster bereitzustellen. Mit dieser Aufgabe wird eine Azure Service Fabric-Anwendung gemäß den in der Compose-Datei definierten Einstellungen in einem Cluster bereitgestellt.

Syntax

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

Eingaben

clusterConnection - Clusterdienstverbindung
Eingabealias: serviceConnectionName. string. Erforderlich.

Gibt eine Azure Service Fabric-Dienstverbindung an, die zum Herstellen einer Verbindung mit dem Cluster verwendet werden soll. Wählen Sie Manage aus, um eine neue Dienstverbindung zu registrieren.


composeFilePath - Dateipfad verfassen
string. Erforderlich. Standardwert. **/docker-compose.yml.

Gibt den Pfad zur compose-Datei an, die bereitgestellt werden soll. Variablen und Feldhalter können im Pfad verwendet werden. Beispiel: $(System.DefaultWorkingDirectory)/**/drop/projectartifacts/**/docker-compose.yml.

Hinweis

Das Kombinieren von Compose-Dateien wird im Rahmen dieser Aufgabe nicht unterstützt.


applicationName - Anwendungsname
string. Erforderlich. Standardwert. fabric:/Application1.

Gibt den Service Fabric-Anwendungsnamen der bereitgestellten Anwendung an. Verwenden Sie fabric:/ als Präfix. Anwendungsnamen in einem Service Fabric-Cluster müssen eindeutig sein.


registryCredentials - Quelle für Registrierungsanmeldeinformationen
string. Erforderlich. Zulässige Werte: AzureResourceManagerEndpoint (Azure Resource Manager-Dienstverbindung), ContainerRegistryEndpoint (Container Registry-Dienstverbindung), UsernamePassword (Benutzername und Kennwort), None. Standardwert. AzureResourceManagerEndpoint.

Gibt an, wie Anmeldeinformationen für die Docker-Containerregistrierung für den Bereitstellungstask bereitgestellt werden. Zulässige Werte sind:

  • AzureResourceManagerEndpoint(Azure Resource Manager-Dienstverbindung): wird verwendetazureSubscription, um eine Dienstprinzipal-ID und einen Schlüssel für eine Azure Container Registry abzurufen.
  • ContainerRegistryEndpoint (Container Registry-Dienstverbindung): wird verwendet dockerRegistryConnection , um eine Docker-Registrierungsdienstverbindung auszuwählen. Wenn ein Zertifikat, das dem Serverzertifikatfingerabdruck in der Clusterdienstverbindung entspricht, auf dem Build-Agent installiert ist, wird es verwendet, um das Kennwort zu verschlüsseln. Andernfalls wird das Kennwort nicht verschlüsselt.
  • UsernamePassword (Benutzername und Kennwort): verwendet registryUsername und registryPassword , um den Benutzernamen und das Kennwort für die Docker-Registrierung zu speichern. Kennwörter sollten mit Invoke-ServiceFabricEncryptText mit der Password Encrypted Option verschlüsselt werden. Wenn Kennwörter nicht mit Invoke-ServiceFabricEncryptTextverschlüsselt sind und ein Zertifikat mit dem Serverzertifikatfingerabdruck in der Clusterverbindung auf dem Build-Agent installiert ist, wird das Zertifikat zum Verschlüsseln des Kennworts verwendet. Andernfalls wird das Kennwort nicht verschlüsselt und in Klartext gesendet.
  • None: Es werden keine Registrierungsanmeldeinformationen angegeben. Dies wird für den Zugriff auf öffentliche Containerregistrierungen verwendet.

dockerRegistryConnection - Docker Registry Service-Verbindung
Eingabealias: dockerRegistryEndpointName. string. Optional. Verwenden Sie , wenn registryCredentials = ContainerRegistryEndpoint.

Gibt eine Docker-Registrierungsdienstverbindung an. Wenn ein Zertifikat, das dem Serverzertifikatfingerabdruck in der Clusterdienstverbindung entspricht, auf dem Build-Agent installiert ist, wird es verwendet, um das Kennwort zu verschlüsseln. Andernfalls wird das Kennwort nicht verschlüsselt.


azureSubscription - Azure-Abonnement
Eingabealias: azureSubscriptionEndpoint. string. Erforderlich, wenn registryCredentials = AzureResourceManagerEndpoint.

Gibt ein Azure-Abonnement an.


registryUserName - Registrierungsbenutzername
string. Optional. Verwenden Sie , wenn registryCredentials = UsernamePassword.

Gibt den Benutzernamen für die Docker-Registrierung an.


registryPassword - Registrierungskennwort
string. Optional. Verwenden Sie , wenn registryCredentials = UsernamePassword.

Gibt das Kennwort für die Docker-Registrierung an. Wenn das Kennwort nicht verschlüsselt ist, empfiehlt es sich, eine benutzerdefinierte Geheimnisvariable für die Releasepipeline zu verwenden, um es zu speichern.


passwordEncrypted - Kennwort verschlüsselt
boolean. Optional. Verwenden Sie , wenn registryCredentials = UsernamePassword. Standardwert. true.

Verschlüsselt Ihr Kennwort mithilfe von Invoke-ServiceFabricEncryptText. Wenn Sie Ihr Kennwort nicht verschlüsseln und ein Zertifikat, das dem Serverzertifikatfingerabdruck in der Clusterdienstverbindung entspricht, auf dem Build-Agent installiert ist, wird es verwendet, um das Kennwort zu verschlüsseln. andernfalls tritt ein Fehler auf.


upgrade - Upgrade
boolean. Standardwert. false.

Statt sie zu entfernen, wird eine vorhandene Bereitstellung aktualisiert.


deployTimeoutSec - Bereitstellen von Timeout(s)
string.

Gibt das Timeout in Sekunden für die Bereitstellung der Anwendung an.


removeTimeoutSec - Timeout entfernen
string.

Gibt das Timeout in Sekunden für das Entfernen einer vorhandenen Anwendung an.


getStatusTimeoutSec - Statustimeout (s) abrufen
string.

Gibt das Timeout in Sekunden an, um die status einer vorhandenen Anwendung zu erhalten.


Optionen für die Vorgangskontrolle

Alle Vorgänge verfügen zusätzlich zu ihren Eingaben über Steuerungsoptionen. Weitere Informationen finden Sie unter Steuerungsoptionen und allgemeine Aufgabeneigenschaften.

Ausgabevariablen

Keine.

Hinweise

Verwenden Sie diese Aufgabe, um eine Docker-Compose-Anwendung in einem Service Fabric-Cluster bereitzustellen. Mit dieser Aufgabe wird eine Azure Service Fabric-Anwendung gemäß den in der Compose-Datei definierten Einstellungen in einem Cluster bereitgestellt.

Hinweis

Diese Aufgabe befindet sich derzeit in der Vorschauphase und erfordert eine Vorschauversion von Service Fabric, die die Bereitstellung von Compose unterstützt. Siehe Unterstützung für die Bereitstellung von Docker Compose in Azure Service Fabric.

Service Fabric

  • Diese Aufgabe verwendet eine Service Fabric-Installation, um eine Verbindung herzustellen und in einem Service Fabric-Cluster bereitzustellen.
  • Laden Sie das Azure Service Fabric Core SDK herunter, und installieren Sie es auf dem Build-Agent.

Anforderungen

Anforderung BESCHREIBUNG
Pipelinetypen YAML, Klassischer Build, klassische Version
Wird ausgeführt auf Agent, DeploymentGroup
Forderungen Selbstgehostete Agents müssen über Funktionen verfügen, die den folgenden Anforderungen entsprechen , um Aufträge auszuführen, die diese Aufgabe verwenden: Cmd
Capabilities Diese Aufgabe erfüllt keine Anforderungen an nachfolgende Aufgaben im Auftrag.
Befehlseinschränkungen Any
Einstellbare Variablen Any
Agent-Version 1.95.0 oder höher
Aufgabenkategorie Bereitstellen