Freigeben über

ServiceFabricComposeDeploy@0 – Service Fabric Compose v0-Aufgabe bereitstellen

  • Artikel

Verwenden Sie diese Aufgabe, um eine Docker Compose-Anwendung in einem Service Fabric-Cluster bereitzustellen. Diese Aufgabe stellt eine Azure Service Fabric-Anwendung gemäß den in der Verfassendatei definierten Einstellungen auf einem Cluster bereit.

Diese Aufgabe ist veraltet.

Hinweis

Diese Aufgabe unterstützt keine Azure Resource Manager-Authentifizierung mit Workflowidentitätsverbund.

Verwenden Sie diese Aufgabe, um eine Docker Compose-Anwendung in einem Service Fabric-Cluster bereitzustellen. Diese Aufgabe stellt eine Azure Service Fabric-Anwendung gemäß den in der Verfassendatei definierten Einstellungen auf einem Cluster bereit.

Hinweis

Diese Aufgabe unterstützt keine Azure Resource Manager-Authentifizierung mit Workflowidentitätsverbund.

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

Eingänge

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 zum Verfassen
string. Erforderlich. Standardwert: **/docker-compose.yml.

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

Hinweis

Das Kombinieren von Verfassendateien wird im Rahmen dieser Aufgabe nicht unterstützt.


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

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


registryCredentials - Registrierungsanmeldeinformationsquelle
string. Erforderlich. Zulässige Werte: AzureResourceManagerEndpoint (Azure Resource Manager-Dienstverbindung), ContainerRegistryEndpoint (Containerregistrierungsdienstverbindung), UsernamePassword (Benutzername und Kennwort), None. Standardwert: AzureResourceManagerEndpoint.

Gibt an, wie Anmeldeinformationen für die Docker-Containerregistrierung für die Bereitstellungsaufgabe bereitgestellt werden. Die zulässigen Werte sind:

  • AzureResourceManagerEndpoint (Azure Resource Manager-Dienstverbindung): Verwendet azureSubscription, um eine Dienstprinzipal-ID und einen Schlüssel für eine Azure-Containerregistrierung abzurufen.
  • ContainerRegistryEndpoint (Containerregistrierungsdienstverbindung): 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 Option Password Encrypted verschlüsselt werden. Wenn Kennwörter nicht mit Invoke-ServiceFabricEncryptTextverschlüsselt werden und ein Zertifikat, das dem Serverzertifikatfingerabdruck in der Clusterverbindung entspricht, auf dem Build-Agent installiert ist, wird das Zertifikat verwendet, um das Kennwort zu verschlüsseln. 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 Connection
Eingabealias: dockerRegistryEndpointName. string. Wahlfrei. Wird verwendet, 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. Wahlfrei. Wird verwendet, wenn registryCredentials = UsernamePassword.

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


registryPassword - Registrierungskennwort
string. Wahlfrei. Wird verwendet, wenn registryCredentials = UsernamePassword.

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


passwordEncrypted - kennwortverschlüsselte
boolean. Wahlfrei. Wird verwendet, 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 zum Verschlüsseln des Kennworts verwendet. andernfalls tritt ein Fehler auf.


upgrade - Upgrade-
boolean. Standardwert: false.

Aktualisiert eine vorhandene Bereitstellung, anstatt sie zu entfernen.


deployTimeoutSec - Bereitstellen von Timeouts (s)
string.

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


removeTimeoutSec - Entfernen von Timeouts (s)
string.

Gibt das Timeout in Sekunden zum Entfernen einer vorhandenen Anwendung an.


getStatusTimeoutSec - Statustimeout (s)
string.

Gibt das Timeout in Sekunden an, um den Status einer vorhandenen Anwendung zu erhalten.


Aufgabensteuerungsoptionen

Alle Aufgaben verfügen zusätzlich zu ihren Aufgabeneingaben über Steuerungsoptionen. Weitere Informationen finden Sie unter Steuerelementoptionen und allgemeinen Aufgabeneigenschaften.

Ausgabevariablen

Keiner.

Bemerkungen

Verwenden Sie diese Aufgabe, um eine Docker-Verfassen-Anwendung in einem Service Fabric-Cluster bereitzustellen. Diese Aufgabe stellt eine Azure Service Fabric-Anwendung gemäß den in der Verfassendatei definierten Einstellungen auf einem Cluster bereit.

Hinweis

Diese Aufgabe befindet sich derzeit in der Vorschau und erfordert eine Vorschauversion von Service Fabric, die die Bereitstellung zum Verfassen unterstützt. Siehe Docker Compose-Bereitstellungsunterstützung in Azure Service Fabric.

Service Fabric

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

Anforderungen

Anforderung BESCHREIBUNG
Pipelinetypen YAML, Classic Build, Classic Release
Läuft auf Agent, DeploymentGroup
Anforderungen Self-hosted agents must have capabilities that match the following anforderungen to run jobs that use this task: Cmd
Funktionen Dieser Vorgang erfüllt keine Anforderungen für nachfolgende Vorgänge im Auftrag.
Befehlseinschränkungen Jegliche
Settable-Variablen Jegliche
Agentversion 1.95.0 oder höher
Vorgangskategorie Einsetzen