AzureMysqlDeployment@2 - Tarea de despliegue de Azure Database for MySQL v2

Esta tarea despliega scripts en Azure Database for MySQL Flexible Server. Puedes desplegar usando un archivo de script SQL o escribiendo el script en línea.

Sintaxis

# Azure Database for MySQL deployment v2
# Run your scripts and make changes to your Azure Database for MySQL Flexible Server.
- task: AzureMysqlDeployment@2
  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 - de suscripción de Azure
Alias de entrada: ConnectedServiceName. string. Obligatorio.

Esto es necesario para conectarte a tu cuenta de Azure.

Para configurar una nueva conexión de servicio, seleccione la suscripción de Azure de 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 botones Add o Manage.


ServerName - Nombre del anfitrión
string. Obligatorio.

El nombre de tu servidor Azure Database for MySQL.

Ejemplo: fabrikam.mysql.database.azure.com

El nombre del servidor se proporciona en el portal de Azure en la hoja 'Visión general' de tu recurso de servidor Azure Database for MySQL.

Cuando conectas usando MySQL Workbench, este es el mismo valor que se usa en HostnameParameters.


DatabaseName - Nombre de la base de datos
string.

Optional. 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 la base de datos esté referenciada en el archivo SQL suministrado o en SQL en línea, cuando sea necesario.

Nota: Los nombres de las bases de datos MySQL son sensibles a mayúsculas y minúsculas.


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

El servidor Azure Database for MySQL soporta autenticación MySQL nativa. Puedes conectarte y autenticarte a un servidor con el inicio de sesión de administrador del servidor. Ejemplo: bbo1@fabrikam.

Cuando conectas usando MySQL Workbench, este es el mismo valor que se usa en UsernameParameters.


de contraseña de SqlPassword -
string. Obligatorio.

La contraseña de administrador para Azure Database for MySQL. Por si no recuerdas la contraseña, puedes cambiarla desde Azure portal.

Esta cadena puede definirse con una variable en la pipeline. Ejemplo: $(password).

Además, puedes marcar el tipo de variable como secret para asegurarlo.


tipo de TaskNameSelector -
string. Valores permitidos: SqlTaskFile (MySQL Script File), InlineSqlTask (Inline MySQL Script). Valor predeterminado: SqlTaskFile.

Optional. Selecciona una de las opciones entre Archivo de Script y Script en línea.

  • SqlTaskFile (por defecto), para su uso con el SqlFile argumento
  • InlineSqlTask, para usarse con el SqlInline argumento.

Nota: estos valores son sensibles a mayúsculas y mayúsculas.


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

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

Aquí se pueden usar variables del sistema predefinidas, como $(agent.releaseDirectory), y archivos que contienen sentencias SQL.

Nota: El cliente MySQL prefiere rutas de estilo Unix, así que desde la versión 1.183.0 en adelante, la tarea convertirá rutas de estilo Windows en rutas de estilo Unix. Ejemplo: de c:\foo\bar\myscript.sql a c:/foo/bar/myscript.sql.

Cuando la tarea se utiliza en plataformas Linux, los caminos permanecen sin cambios. No hay necesidad de escapar de personajes especiales en caminos.


SqlInline - Script MySQL en línea
string. Obligatorio cuando TaskNameSelector = InlineSqlTask.

Entra el script MySQL para ejecutarse en la base de datos seleccionada arriba.


SqlAdditionalArguments - Argumentos adicionales de MySQL
string.

Optional. Las opciones adicionales soportadas por el cliente MySQL. Estas opciones se aplican al ejecutar el archivo dado en la base de datos de Azure Database for MySQL.

Ejemplo: puedes cambiar al formato de salida separado por pestañas por defecto, a HTML o incluso al formato XML. Otros ejemplos son:

  • --comments eliminar los comentarios enviados desde el cliente al servidor.
  • --quick para evitar el almacenamiento en caché de resultados.
  • --xml para generar resultados en XML.

Todas las opciones disponibles están descritas en la documentación del cliente MySQL.


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

Para la ejecución exitosa de la tarea, necesitamos 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, puedes añadir automáticamente una excepción de firewall para el rango de posibles direcciones IP de los agentes de automatización, o puedes especificar explícitamente el rango.

Valores aceptados:

  • AutoDetect para detectar automáticamente la dirección IP pública del agente de automatización.
  • IPAddressRange para especificar explícitamente el rango de direcciones IP a configurar. Establece el rango de direcciones IP usando los StartIpAddress parámetros y EndIpAddress .

Nota: Estos valores son sensibles a mayúsculas y mayúsculas.


StartIpAddress - inicio de la dirección IP
string. Obligatorio cuando IpDetectionMethod = IPAddressRange.

La dirección IP inicial del pool de máquinas de agentes de automatización. Por ejemplo: 196.21.30.50.


EndIpAddress - dirección IP final
string. Obligatorio cuando IpDetectionMethod = IPAddressRange.

La dirección IP final del pool de máquinas de agentes de automatización. Por ejemplo: 196.21.30.65.


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

Optional. Si se selecciona, la excepción añadida para las direcciones IP del agente de automatización se eliminará para la correspondiente Azure Database for MySQL.


Opciones de control de tareas

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

Variables de salida

Ninguna.

Observaciones

Esta tarea despliega scripts en Azure Database for MySQL Flexible Server. Puedes desplegar usando un archivo de script SQL o escribiendo el script en línea.

Azure Database for MySQL Single Server está en la ruta de retiro. Flexible Server es el modelo de despliegue recomendado para el futuro. AzureMysqlDeployment@2 utiliza el proveedor de recursos Flexible Server (Microsoft.DBforMySQL/flexibleServers) y sus APIs de gestión.

Prerequisites

Los siguientes requisitos deben establecerse para que la tarea funcione correctamente.

Suscripción a Azure

Para desplegar en Azure Database for MySQL, una suscripción a Azure debe vincularse a Azure DevOps usando la pestaña Conexiones de Servicio en la configuración del proyecto. Utiliza el tipo de endpoint Azure Resource Manager. Para obtener más información, consulte Conectar con Azure con una conexión de servicio de Azure Resource Manager.

Azure Database for MySQL: servidor flexible

Esta tarea espera que ya exista un recurso Azure Database for MySQL Flexible Server en el portal Azure. La tarea puede crear una nueva base de datos y ejecutar comandos MySQL, pero no crea el servidor en sí.

Cliente MySQL en el Agente

  • Windows Agent: Utiliza este script para instalar el cliente MySQL.
  • Agente Linux: Corre apt-get install mysql-client.

Requisitos

Requirement Descripción
Tipos de canalización YAML, compilación clásica, versión clásica
Funciona en Agente
Demands Ninguno
Capacidades Esta tarea no satisface ninguna demanda de tareas posteriores en el trabajo.
Restricciones de comandos Any
Variables configurables Any
Versión del agente 1.100.0 o superior
Categoría de tarea Desplegar