Compartir vía


AzureMysqlDeployment@1: tarea Azure Database for MySQL implementación v1

Use esta tarea para ejecutar los scripts y realice cambios en la base de datos en Azure Database for MySQL. La tarea Implementación de Azure Database for MySQL solo funciona con Azure Database for MySQL: servidor único.

Syntax

# Azure Database for MySQL deployment v1
# Run your scripts and make changes to your Azure Database for MySQL.
- task: AzureMysqlDeployment@1
  inputs:
    azureSubscription: # string. Alias: ConnectedServiceName. Required. Azure Subscription. 
  # DB Details
    ServerName: # string. Required. Host Name. 
    #DatabaseName: # string. Database Name. 
    SqlUsername: # string. Required. Server Admin Login. 
    SqlPassword: # string. Required. Password. 
  # Deployment Package
    #TaskNameSelector: 'SqlTaskFile' # 'SqlTaskFile' | 'InlineSqlTask'. Type. Default: SqlTaskFile.
    SqlFile: # string. Required when TaskNameSelector = SqlTaskFile. MySQL Script. 
    #SqlInline: # string. Required when TaskNameSelector = InlineSqlTask. Inline MySQL Script. 
    #SqlAdditionalArguments: # string. Additional MySQL Arguments. 
  # Firewall
    IpDetectionMethod: 'AutoDetect' # 'AutoDetect' | 'IPAddressRange'. Required. Specify Firewall Rules Using. Default: AutoDetect.
    #StartIpAddress: # string. Required when IpDetectionMethod = IPAddressRange. Start IP Address. 
    #EndIpAddress: # string. Required when IpDetectionMethod = IPAddressRange. End IP Address. 
    #DeleteFirewallRule: true # boolean. Delete Rule After Task Ends. Default: true.
# Azure Database for MySQL Deployment v1
# Run your scripts and make changes to your Azure Database for MySQL.
- task: AzureMysqlDeployment@1
  inputs:
    azureSubscription: # string. Alias: ConnectedServiceName. Required. Azure Subscription. 
  # DB Details
    ServerName: # string. Required. Host Name. 
    #DatabaseName: # string. Database Name. 
    SqlUsername: # string. Required. Server Admin Login. 
    SqlPassword: # string. Required. Password. 
  # Deployment Package
    #TaskNameSelector: 'SqlTaskFile' # 'SqlTaskFile' | 'InlineSqlTask'. Type. Default: SqlTaskFile.
    SqlFile: # string. Required when TaskNameSelector = SqlTaskFile. MySQL Script. 
    #SqlInline: # string. Required when TaskNameSelector = InlineSqlTask. Inline MySQL Script. 
    #SqlAdditionalArguments: # string. Additional MySQL Arguments. 
  # Firewall
    IpDetectionMethod: 'AutoDetect' # 'AutoDetect' | 'IPAddressRange'. Required. Specify Firewall Rules Using. Default: AutoDetect.
    #StartIpAddress: # string. Required when IpDetectionMethod = IPAddressRange. Start IP Address. 
    #EndIpAddress: # string. Required when IpDetectionMethod = IPAddressRange. End IP Address. 
    #DeleteFirewallRule: true # boolean. Delete Rule After Task Ends. Default: true.

Entradas

azureSubscription - Suscripción de Azure
Alias de entrada: ConnectedServiceName. string. Obligatorio.

Esto es necesario para conectarse a su cuenta de Azure.

Para configurar una nueva conexión de servicio, seleccione la suscripción de Azure en la lista y haga clic en Authorize.

Si la suscripción no aparece o si desea usar una entidad de servicio existente, puede configurar una conexión de servicio de Azure mediante los Add botones o Manage .


ServerName - Nombre de host
string. Obligatorio.

Nombre del servidor de Azure Database for MySQL.

Ejemplo: fabrikam.mysql.database.azure.com

El nombre del servidor se proporciona en Azure Portal en la hoja "Información general" del recurso de servidor Azure Database for MySQL.

Al conectarse mediante MySQL Workbench, este es el mismo valor que se usa para Hostname en Parameters.


DatabaseName - Nombre de la base de datos
string.

Opcional. El nombre de la base de datos. El script creará un nombre de base de datos si no existe uno.

Si no se especifica, asegúrese de que se hace referencia a la base de datos en el archivo SQL proporcionado o SQL insertado, cuando sea necesario.

Nota: Los nombres de base de datos MySQL distinguen mayúsculas de minúsculas.


SqlUsername - Inicio de sesión de Administración de servidor
string. Obligatorio.

El servidor Azure Database for MySQL admite la autenticación nativa de MySQL. Puede conectarse a un servidor y autenticarse en él con el inicio de sesión de administrador del servidor. Ejemplo: bbo1@fabrikam.

Al conectarse mediante MySQL Workbench, este es el mismo valor que se usa para Username en Parameters.


SqlPassword - Contraseña
string. Obligatorio.

Contraseña de administrador para Azure Database for MySQL. En caso de que no recupere la contraseña, puede cambiar la contraseña de Azure Portal.

Esta cadena se puede definir con una variable en la canalización. Ejemplo: $(password).

Además, puede marcar el tipo de variable como secret para protegerlo.


TaskNameSelector - Tipo
string. Valores permitidos: SqlTaskFile (Archivo de script mySQL), InlineSqlTask (script mySQL insertado). Valor predeterminado: SqlTaskFile.

Opcional. Selecciona una de las opciones entre Script File & Inline Script.

  • SqlTaskFile (valor predeterminado), para su uso con el argumento SqlFile.
  • InlineSqlTask, para su uso con el argumento SqlInline.

Nota: estos valores distinguen mayúsculas de minúsculas.


SqlFile - MySQL Script
string. Necesario cuando TaskNameSelector = SqlTaskFile.

Ruta de acceso completa del archivo de script en el agente de automatización o en una ruta de acceso UNC accesible para el agente de automatización. Por ejemplo: \BudgetIT\DeployBuilds\script.sql.

Las variables del sistema predefinidas, como $(agent.releaseDirectory), y los archivos que contienen instrucciones SQL se pueden usar aquí.

Nota: El cliente MySQL prefiere rutas de acceso de estilo Unix, por lo que, a partir de la versión 1.183.0 activada, la tarea convertirá las rutas de acceso de estilo de Windows a las rutas de acceso de estilo unix. Ejemplo: de c:\foo\bar\myscript.sql a c:/foo/bar/myscript.sql.

Cuando la tarea se usa en plataformas Linux, las rutas de acceso no cambian. No es necesario escapar caracteres especiales en las rutas de acceso.


SqlInline - Script MySQL insertado
string. Necesario cuando TaskNameSelector = InlineSqlTask.

Escribe el script MySQL que se va a ejecutar en la base de datos seleccionada anteriormente.


SqlAdditionalArguments - Argumentos adicionales de MySQL
string.

Opcional. Las opciones adicionales admitidas por el cliente MySQL. Estas opciones se aplican al ejecutar el archivo especificado en el Azure Database for MySQL.

Ejemplo: Puede cambiar al formato de salida separado por tabulaciones predeterminada, a HTML o incluso al formato XML. Otros ejemplos son:

  • --comments para quitar comentarios enviados del cliente al servidor.
  • --quick para evitar el almacenamiento en caché de resultados.
  • --xml para generar resultados como XML.

Todas las opciones disponibles se describen en la documentación del cliente de MySQL.


IpDetectionMethod - Especificación de reglas de firewall mediante
string. Obligatorio. Valores permitidos: AutoDetect, IPAddressRange. Valor predeterminado: AutoDetect.

Para la ejecución correcta de la tarea, es necesario permitir que los administradores accedan al servidor Azure Database for MySQL desde la dirección IP del agente de automatización.

Al seleccionar detección automática, puede agregar automáticamente una excepción de firewall para el intervalo de posibles direcciones IP de los agentes de automatización, o bien puede especificar explícitamente el intervalo.

Valores aceptados:

  • AutoDetect para detectar automáticamente la dirección IP pública del agente de automatización.
  • IPAddressRange para especificar explícitamente el intervalo de direcciones IP que se va a configurar. Establezca el intervalo de direcciones IP mediante los parámetros StartIpAddress y EndIpAddress.

Nota: Estos valores distinguen mayúsculas de minúsculas.


StartIpAddress - Iniciar dirección IP
string. Necesario cuando IpDetectionMethod = IPAddressRange.

Dirección IP inicial del grupo de máquinas del agente de automatización. Por ejemplo: 196.21.30.50.


EndIpAddress - Dirección IP final
string. Necesario cuando IpDetectionMethod = IPAddressRange.

Dirección IP final del grupo de máquinas del agente de automation. Por ejemplo: 196.21.30.65.


DeleteFirewallRule - Eliminar regla después de que finalice la tarea
boolean. Valor predeterminado: true.

Opcional. Si está seleccionada, se quitará la excepción agregada para las direcciones IP del agente de automatización para el Azure Database for MySQL correspondiente.


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 ejecutar los scripts y realice cambios en la base de datos en Azure Database for MySQL. Tenga en cuenta que se trata de una versión preliminar. La tarea Implementación de Azure Database for MySQL solo funciona con Azure Database for MySQL: servidor único.

Requisitos

Requisito Descripción
Tipos de canalización YAML, compilación clásica, versión clásica
Se ejecuta en Agente
Peticiones None
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.100.0 o superior
Categoría de la tarea: Implementación