Compartir vía


ServiceFabricComposeDeploy@0: tarea implementar v0 de Service Fabric Compose

Use esta tarea para implementar una aplicación de Docker Compose en un clúster de Service Fabric. Esta tarea implementa una aplicación de Azure Service Fabric en un clúster según la configuración definida en el archivo Compose.

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

Entradas

clusterConnection - Conexión de servicio de clúster
Alias de entrada: serviceConnectionName. string. Obligatorio.

Especifica una conexión de servicio de Azure Service Fabric que se usará para conectarse al clúster. Elija Manage registrar una nueva conexión de servicio.


composeFilePath - Ruta de acceso del archivo de redacción
string. Obligatorio. Valor predeterminado: **/docker-compose.yml.

Especifica la ruta de acceso al archivo de redacción que se va a implementar. Las variables y los caracteres comodín se pueden usar en la ruta de acceso. Ejemplo: $(System.DefaultWorkingDirectory)/**/drop/projectartifacts/**/docker-compose.yml.

Nota:

No se admite la combinación de archivos de redacción como parte de esta tarea.


applicationName - Nombre de la aplicación
string. Obligatorio. Valor predeterminado: fabric:/Application1.

Especifica el nombre de la aplicación de Service Fabric de la aplicación implementada. Use fabric:/ como prefijo. Los nombres de aplicación de un clúster de Service Fabric deben ser únicos.


registryCredentials - Origen de credenciales del Registro
string. Obligatorio. Valores permitidos: AzureResourceManagerEndpoint (conexión de servicio de Azure Resource Manager), ContainerRegistryEndpoint (conexión del servicio Container Registry), UsernamePassword (nombre de usuario y contraseña), None. Valor predeterminado: AzureResourceManagerEndpoint.

Especifica cómo se proporcionarán las credenciales del registro de contenedor de Docker a la tarea de implementación. Los valores permitidos son:

  • AzureResourceManagerEndpoint(Conexión de servicio de Azure Resource Manager): usa azureSubscription para obtener un identificador y una clave de entidad de servicio para un Azure Container Registry.
  • ContainerRegistryEndpoint (Conexión del servicio Container Registry): usa dockerRegistryConnection para seleccionar una conexión de servicio del registro de Docker. Si se instala un certificado que coincida con la huella digital del certificado de servidor en la conexión del servicio de clúster en el agente de compilación, se usará para cifrar la contraseña; de lo contrario, la contraseña no se cifrará.
  • UsernamePassword (Nombre de usuario y contraseña): usa registryUsername y registryPassword para almacenar el nombre de usuario y la contraseña del registro de Docker. Las contraseñas se deben cifrar mediante Invoke-ServiceFabricEncryptText con la Password Encrypted opción . Si las contraseñas no se cifran con Invoke-ServiceFabricEncryptTexty se instala un certificado que coincida con la huella digital del certificado de servidor en la conexión de clúster en el agente de compilación, el certificado se usará para cifrar la contraseña. De lo contrario, la contraseña no se cifrará y se enviará en texto no cifrado.
  • None: no se proporcionan credenciales del Registro. Se usa para acceder a registros de contenedor públicos.

dockerRegistryConnection - Conexión del servicio del registro de Docker
Alias de entrada: dockerRegistryEndpointName. string. Opcional. Use cuando registryCredentials = ContainerRegistryEndpoint.

Especifica una conexión de servicio del registro de Docker. Si se instala un certificado que coincida con la huella digital del certificado de servidor en la conexión del servicio de clúster en el agente de compilación, se usará para cifrar la contraseña; de lo contrario, la contraseña no se cifrará.


azureSubscription - Suscripción de Azure
Alias de entrada: azureSubscriptionEndpoint. string. Necesario cuando registryCredentials = AzureResourceManagerEndpoint.

Especifica una suscripción de Azure.


registryUserName - Nombre de usuario del Registro
string. Opcional. Use cuando registryCredentials = UsernamePassword.

Especifica el nombre de usuario del registro de Docker.


registryPassword - Contraseña del Registro
string. Opcional. Use cuando registryCredentials = UsernamePassword.

Especifica la contraseña del registro de Docker. Si la contraseña no está cifrada, se recomienda usar una variable secreta de canalización de versión personalizada para almacenarla.


passwordEncrypted - Contraseña cifrada
boolean. Opcional. Use cuando registryCredentials = UsernamePassword. Valor predeterminado: true.

Cifra la contraseña mediante Invoke-ServiceFabricEncryptText. Si no cifra la contraseña y se instala un certificado que coincida con la huella digital del certificado de servidor en la conexión del servicio de clúster en el agente de compilación, se usará para cifrar la contraseña; de lo contrario, se producirá un error.


upgrade - Actualizar
boolean. Valor predeterminado: false.

Actualiza una implementación existente en lugar de quitarla.


deployTimeoutSec - Implementación del tiempo de espera (s)
string.

Especifica el tiempo de espera, en segundos, para implementar la aplicación.


removeTimeoutSec - Quitar tiempo de espera (s)
string.

Especifica el tiempo de espera, en segundos, para quitar una aplicación existente.


getStatusTimeoutSec - Obtener tiempo de espera de estado (s)
string.

Especifica el tiempo de espera, en segundos, para obtener el estado de una aplicación existente.


Opciones de control de tareas

Todas las tareas tienen opciones de control además de las entradas de tareas. Para obtener más información, vea Opciones de control y propiedades de tareas comunes.

Variables de salida

Ninguno.

Comentarios

Use esta tarea para implementar una aplicación Docker-compose en un clúster de Service Fabric. Esta tarea implementa una aplicación de Azure Service Fabric en un clúster según la configuración definida en el archivo de Compose.

Nota

Esta tarea se encuentra actualmente en versión preliminar y requiere una versión preliminar de Service Fabric que admita la implementación de redacción. Consulte Compatibilidad con la implementación de Docker Compose en Azure Service Fabric.

Service Fabric

  • Esta tarea usa una instalación de Service Fabric para conectarse e implementar en un clúster de Service Fabric.
  • Descargue e instale el SDK de Azure Service Fabric Core en el agente de compilación.

Requisitos

Requisito Descripción
Tipos de canalización YAML, compilación clásica, versión clásica
Se ejecuta en Agente, DeploymentGroup
Peticiones Los agentes autohospedados deben tener funcionalidades que coincidan con las siguientes demandas para ejecutar trabajos que usen esta tarea: Cmd
Capabilities Esta tarea no satisface ninguna demanda de tareas posteriores en el trabajo.
Restricciones de comandos Any
Variables que se pueden establecer Any
Versión del agente 1.95.0 o superior
Categoría de la tarea: Implementación