Dela via


ServiceFabricComposeDeploy@0 – Service Fabric Compose distribuera v0-uppgift

Använd den här uppgiften för att distribuera ett Docker Compose-program till ett Service Fabric-kluster. Den här uppgiften distribuerar ett Azure Service Fabric-program till ett kluster enligt inställningarna som definieras i Compose-filen.

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

Indata

clusterConnection - Klustertjänstanslutning
Indataalias: serviceConnectionName. string. Krävs.

Anger en Azure Service Fabric-tjänstanslutning som ska användas för att ansluta till klustret. Välj Manage att registrera en ny tjänstanslutning.


composeFilePath - Skriv filsökväg
string. Krävs. Standardvärde: **/docker-compose.yml.

Anger sökvägen till den skrivfil som ska distribueras. Variabler och jokertecken kan användas i sökvägen. Exempel: $(System.DefaultWorkingDirectory)/**/drop/projectartifacts/**/docker-compose.yml.

Anteckning

Det går inte att kombinera skrivfiler som en del av den här uppgiften.


applicationName - Programnamn
string. Krävs. Standardvärde: fabric:/Application1.

Anger Service Fabric-programnamnet för det distribuerade programmet. Använd fabric:/ som prefix. Programnamn i ett Service Fabric-kluster måste vara unika.


registryCredentials - Källa för registerautentiseringsuppgifter
string. Krävs. Tillåtna värden: AzureResourceManagerEndpoint (Azure Resource Manager tjänstanslutning), ContainerRegistryEndpoint (Container Registry-tjänstanslutning), UsernamePassword (användarnamn och lösenord), None. Standardvärde: AzureResourceManagerEndpoint.

Anger hur autentiseringsuppgifter för Docker-containerregistret ska anges för distributionsaktiviteten. De tillåtna värdena är:

  • AzureResourceManagerEndpoint(Azure Resource Manager-tjänstanslutning): använder azureSubscription för att hämta ett tjänsthuvudnamns-ID och en nyckel för en Azure Container Registry.
  • ContainerRegistryEndpoint (Tjänstanslutning för Container Registry): används dockerRegistryConnection för att välja en Docker-registertjänstanslutning. Om ett certifikat som matchar servercertifikatets tumavtryck i klustertjänstanslutningen installeras på byggagenten används det för att kryptera lösenordet. Annars krypteras inte lösenordet.
  • UsernamePassword (Användarnamn och lösenord): använder registryUsername och registryPassword för att lagra användarnamn och lösenord för Docker-registret. Lösenord ska krypteras med hjälp av Invoke-ServiceFabricEncryptText med alternativet Password Encrypted . Om lösenord inte krypteras med Invoke-ServiceFabricEncryptTextoch ett certifikat som matchar tumavtrycket för servercertifikatet i klusteranslutningen installeras på byggagenten används certifikatet för att kryptera lösenordet. Annars krypteras inte lösenordet och skickas i klartext.
  • None: Inga registerautentiseringsuppgifter anges. Detta används för åtkomst till offentliga containerregister.

dockerRegistryConnection - Docker Registry Service-anslutning
Indataalias: dockerRegistryEndpointName. string. Valfritt. Använd när registryCredentials = ContainerRegistryEndpoint.

Anger en Docker-registertjänstanslutning. Om ett certifikat som matchar servercertifikatets tumavtryck i klustertjänstanslutningen installeras på byggagenten används det för att kryptera lösenordet. Annars krypteras inte lösenordet.


azureSubscription - Azure-prenumeration
Indataalias: azureSubscriptionEndpoint. string. Krävs när registryCredentials = AzureResourceManagerEndpoint.

Anger en Azure-prenumeration.


registryUserName - Registeranvändarnamn
string. Valfritt. Använd när registryCredentials = UsernamePassword.

Anger användarnamnet för Docker-registret.


registryPassword - Registerlösenord
string. Valfritt. Använd när registryCredentials = UsernamePassword.

Anger lösenordet för Docker-registret. Om lösenordet inte är krypterat rekommenderar vi att du använder en anpassad versionspipelinehemlighetsvariabel för att lagra det.


passwordEncrypted - Lösenord krypterat
boolean. Valfritt. Använd när registryCredentials = UsernamePassword. Standardvärde: true.

Krypterar ditt lösenord med Invoke-ServiceFabricEncryptText. Om du inte krypterar ditt lösenord och ett certifikat som matchar servercertifikatets tumavtryck i klustertjänstanslutningen installeras på byggagenten används det för att kryptera lösenordet. annars uppstår ett fel.


upgrade - Uppgradera
boolean. Standardvärde: false.

Uppgraderar en befintlig distribution i stället för att ta bort den.


deployTimeoutSec - Distribuera tidsgräns (s)
string.

Anger tidsgränsen i sekunder för distribution av programmet.


removeTimeoutSec - Ta bort tidsgräns (s)
string.

Anger tidsgränsen i sekunder för att ta bort ett befintligt program.


getStatusTimeoutSec - Hämta tidsgräns för status (s)
string.

Anger tidsgränsen i sekunder för att få status för ett befintligt program.


Kontrollalternativ för aktivitet

Alla aktiviteter har kontrollalternativ utöver sina aktivitetsindata. Mer information finns i Kontrollalternativ och vanliga uppgiftsegenskaper.

Utdatavariabler

Inga.

Kommentarer

Använd den här uppgiften för att distribuera ett Docker-compose-program till ett Service Fabric-kluster. Den här uppgiften distribuerar ett Azure Service Fabric-program till ett kluster enligt de inställningar som definierats i skrivfilen.

Anteckning

Den här uppgiften är för närvarande i förhandsversion och kräver en förhandsversion av Service Fabric som stöder kompileringsdistribution. Se Stöd för Docker Compose-distribution i Azure Service Fabric.

Service Fabric

  • Den här uppgiften använder en Service Fabric-installation för att ansluta och distribuera till ett Service Fabric-kluster.
  • Ladda ned och installera Azure Service Fabric Core SDK på byggagenten.

Krav

Krav Beskrivning
Pipelinetyper YAML, klassisk version, klassisk version
Körs på Agent, DeploymentGroup
Krav Lokalt installerade agenter måste ha funktioner som matchar följande krav för att köra jobb som använder den här uppgiften: Cmd
Funktioner Den här aktiviteten uppfyller inte några krav för efterföljande uppgifter i jobbet.
Kommandobegränsningar Valfri
Inställningsbara variabler Valfri
Agentversion 1.95.0 eller senare
Uppgiftskategori Distribuera