ServiceFabricComposeDeploy@0 - Service Fabric Compose-taak v0 implementeren

Gebruik deze taak om een Docker Compose-toepassing te implementeren in een Service Fabric-cluster. Met deze taak wordt een Azure Service Fabric-toepassing geïmplementeerd in een cluster volgens de instellingen die zijn gedefinieerd in het compose-bestand.

Notitie

Deze taak biedt geen ondersteuning voor Azure Resource Manager-verificatie met werkstroomidentiteitsfederatie.

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

Invoerwaarden

clusterConnection - Verbinding met clusterservice
Invoeralias: serviceConnectionName. string. Vereist.

Hiermee geeft u een Azure Service Fabric-serviceverbinding op die moet worden gebruikt om verbinding te maken met het cluster. Kies ervoor Manage om een nieuwe serviceverbinding te registreren.

composeFilePath - Bestandspad opstellen
string. Vereist. Standaardwaarde: **/docker-compose.yml.

Hiermee geeft u het pad naar het opstelbestand dat moet worden geïmplementeerd. Variabelen en jokertekens kunnen worden gebruikt in het pad. Bijvoorbeeld: $(System.DefaultWorkingDirectory)/**/drop/projectartifacts/**/docker-compose.yml.

Notitie

Het combineren van opstelbestanden wordt niet ondersteund als onderdeel van deze taak.

applicationName - Toepassingsnaam
string. Vereist. Standaardwaarde: fabric:/Application1.

Hiermee geeft u de naam van de Service Fabric-toepassing van de geïmplementeerde toepassing. Gebruik fabric:/ als voorvoegsel. Toepassingsnamen binnen een Service Fabric-cluster moeten uniek zijn.

registryCredentials - Registerreferentiebron
string. Vereist. Toegestane waarden: AzureResourceManagerEndpoint (Azure Resource Manager-serviceverbinding), ContainerRegistryEndpoint (Container Registry-serviceverbinding), UsernamePassword (gebruikersnaam en wachtwoord), None. Standaardwaarde: AzureResourceManagerEndpoint.

Hiermee geeft u op hoe referenties voor het Docker-containerregister worden opgegeven voor de implementatietaak. De toegestane waarden zijn:

• AzureResourceManagerEndpoint(Azure Resource Manager-serviceverbinding): gebruikt azureSubscription om een service-principal-id en -sleutel voor een Azure Container Registry te verkrijgen.
• ContainerRegistryEndpoint (Container Registry-serviceverbinding): gebruikt dockerRegistryConnection om een Docker-registerserviceverbinding te selecteren. Als een certificaat dat overeenkomt met de vingerafdruk van het servercertificaat in de clusterserviceverbinding is geïnstalleerd op de build-agent, wordt dit gebruikt om het wachtwoord te versleutelen; Anders wordt het wachtwoord niet versleuteld.
• UsernamePassword (Gebruikersnaam en wachtwoord): gebruikt registryUsername en registryPassword om de gebruikersnaam en het wachtwoord voor het Docker-register op te slaan. Wachtwoorden moeten worden versleuteld met behulp van Invoke-ServiceFabricEncryptText met de Password Encrypted optie . Als wachtwoorden niet zijn versleuteld met en een certificaat dat overeenkomt met Invoke-ServiceFabricEncryptTextde vingerafdruk van het servercertificaat in de clusterverbinding is geïnstalleerd op de buildagent, wordt het certificaat gebruikt om het wachtwoord te versleutelen. Anders wordt het wachtwoord niet versleuteld en wordt het in tekst zonder opmaak verzonden.
• None: Er worden geen registerreferenties opgegeven. Dit wordt gebruikt voor toegang tot openbare containerregisters.

dockerRegistryConnection - Verbinding met Docker Registry-service
Invoeralias: dockerRegistryEndpointName. string. Optioneel. Gebruik wanneer registryCredentials = ContainerRegistryEndpoint.

Hiermee geeft u een Docker-registerserviceverbinding op. Als een certificaat dat overeenkomt met de vingerafdruk van het servercertificaat in de clusterserviceverbinding is geïnstalleerd op de build-agent, wordt dit gebruikt om het wachtwoord te versleutelen; Anders wordt het wachtwoord niet versleuteld.

azureSubscription - Azure-abonnement
Invoeralias: azureSubscriptionEndpoint. string. Vereist wanneer registryCredentials = AzureResourceManagerEndpoint.

Hiermee geeft u een Azure-abonnement op.

registryUserName - Registergebruikersnaam
string. Optioneel. Gebruik wanneer registryCredentials = UsernamePassword.

Hiermee geeft u de gebruikersnaam voor het Docker-register.

registryPassword - Registerwachtwoord
string. Optioneel. Gebruik wanneer registryCredentials = UsernamePassword.

Hiermee geeft u het wachtwoord voor het Docker-register op. Als het wachtwoord niet is versleuteld, is het raadzaam om een aangepaste releasepijplijngeheimvariabele te gebruiken om het wachtwoord op te slaan.

passwordEncrypted - Wachtwoord versleuteld
boolean. Optioneel. Gebruik wanneer registryCredentials = UsernamePassword. Standaardwaarde: true.

Versleutelt uw wachtwoord met behulp van Invoke-ServiceFabricEncryptText. Als u uw wachtwoord niet versleutelt en een certificaat dat overeenkomt met de vingerafdruk van het servercertificaat in de clusterserviceverbinding is geïnstalleerd op de build-agent, wordt dit gebruikt om het wachtwoord te versleutelen. anders treedt er een fout op.

upgrade - Upgrade
boolean. Standaardwaarde: false.

Hiermee wordt een bestaande implementatie bijgewerkt in plaats van deze te verwijderen.

deployTimeoutSec - Time-out (s) implementeren
string.

Hiermee geeft u de time-out in seconden op voor het implementeren van de toepassing.

removeTimeoutSec - Time-out (s) verwijderen
string.

Hiermee geeft u de time-out in seconden op voor het verwijderen van een bestaande toepassing.

getStatusTimeoutSec - Statustime-out (s) ophalen
string.

Hiermee geeft u de time-out in seconden op voor het ophalen van de status van een bestaande toepassing.

Opties voor taakbeheer

Alle taken hebben besturingsopties naast hun taakinvoer. Zie Besturingsopties en algemene taakeigenschappen voor meer informatie.

Uitvoervariabelen

Geen.

Opmerkingen

Gebruik deze taak om een Docker-compose-toepassing te implementeren in een Service Fabric-cluster. Met deze taak wordt een Azure Service Fabric-toepassing geïmplementeerd in een cluster volgens de instellingen die zijn gedefinieerd in het opstelbestand.

Notitie

Deze taak is momenteel in preview en vereist een preview-versie van Service Fabric die ondersteuning biedt voor opstellen implementeren. Zie Ondersteuning voor Docker Compose-implementatie in Azure Service Fabric.

Service Fabric

• Deze taak maakt gebruik van een Service Fabric-installatie om verbinding te maken en te implementeren in een Service Fabric-cluster.
• Download en installeer de Azure Service Fabric Core SDK op de buildagent.

Vereisten

Vereiste	Beschrijving
Pijplijntypen	YAML, klassieke build, klassieke release
Wordt uitgevoerd op	Agent, DeploymentGroup
Eisen	Zelf-hostende agents moeten mogelijkheden hebben die voldoen aan de volgende vereisten om taken uit te voeren die deze taak gebruiken: Cmd
Functies	Deze taak voldoet niet aan eventuele vereisten voor volgende taken in de taak.
Opdrachtbeperkingen	Alle
Instelbare variabelen	Alle
Agentversie	1.95.0 of hoger
Taakcategorie	Implementeren