Implementación del proveedor de recursos MySQL en Azure Stack Hub

Importante

A partir de la compilación 2108 de Azure Stack Hub, los proveedores de recursos SQL y MySQL se ofrecen a las suscripciones a las que se ha concedido acceso. Si desea empezar a usar esta característica o si necesita actualizar desde una versión anterior, abra un caso de soporte técnico y nuestros ingenieros le guiarán a través del proceso de implementación o actualización.

Use el proveedor de recursos MySQL Server para ofrecer las bases de datos de MySQL como un servicio de Azure Stack Hub.

El proveedor de recursos de MySQL se ejecuta como un servicio en una instancia de Add-on RP Windows Server especial.

Importante

Solo el proveedor de recursos debe crear elementos en servidores que hospedan SQL o MySQL. No se admiten los elementos creados en un servidor host que no se crean con el proveedor de recursos, y dichos elementos podrían dar lugar a un error de coincidencia de estado.

Prerrequisitos

Si ya ha instalado un proveedor de recursos, es probable que haya completado los siguientes requisitos previos y pueda omitir esta sección. De lo contrario, realice estos pasos antes de continuar:

1. Registre la instancia de Azure Stack Hub en Azure, si no lo ha hecho. Este paso es necesario, ya que se va a conectar a Marketplace y a descargar ahí elementos desde Azure.

2. Si no está familiarizado con la característica Marketplace Management del portal de administrador de Azure Stack Hub, consulte Descarga de elementos de Marketplace de Azure y publicación en Azure Stack Hub. El artículo le guía por el proceso de descarga de elementos de Azure en Marketplace de Azure Stack Hub. Abarca escenarios conectados y desconectados. Si la instancia de Azure Stack Hub está desconectada o parcialmente conectada, existen requisitos previos adicionales que hay que cumplir para completar la instalación.

3. Actualice el directorio principal de Microsoft Entra. A partir de la compilación 1910, se debe registrar una nueva aplicación en el inquilino del directorio principal. Esta aplicación permitirá que Azure Stack Hub cree y registre correctamente proveedores de recursos más recientes (como Event Hubs y otros) con el inquilino de Microsoft Entra. Se trata de una acción única que debe realizarse después de actualizar a la compilación 1910 o posterior. Si no se realiza este paso, se producirá un error en las instalaciones del proveedor de recursos de marketplace.

   • Después de actualizar correctamente la instancia de Azure Stack Hub a 1910 o superior, siga las instrucciones para clonar o descargar el repositorio de herramientas de Azure Stack Hub.
   • A continuación, siga las instrucciones de Actualización del directorio principal de Azure Stack Hub Microsoft Entra (después de instalar actualizaciones o nuevos proveedores de recursos).

Requisitos previos del proveedor de recursos de MySQL Server

• Necesitará un equipo y una cuenta con acceso:

  • al portal de administración de Azure Stack Hub.
  • el punto de conexión con privilegios (solo es necesario cuando se implementa el proveedor de recursos de MySQL Server V1 o se actualiza desde el proveedor de recursos de MySQL Server V1 al proveedor de recursos de MySQL Server V2).
  • al punto de conexión de administración de Azure Resource Manager, https://adminmanagement.region.<fqdn>, donde <fqdn> es el nombre de dominio completo.
  • Internet, si azure Stack Hub se implementó para usar Microsoft Entra ID como proveedor de identidades.

• Descargue la versión compatible del archivo binario del proveedor de recursos de MySQL según la tabla de asignación de versiones siguiente. Para el proveedor de recursos de MySQL Server V2, descargue el elemento de Marketplace en Azure Stack Hub.

  Versión de Azure Stack Hub compatible	MySQL RP, versión	Windows Server en el que se está ejecutando el servicio RP
  2206, 2301, 2306, 2311	MySQL RP versión 2.0.13.x	Microsoft AzureStack Add-on RP Windows Server 1.2009.0
  2108, 2206	Proveedor de recursos MySQL versión 2.0.6.x	Microsoft AzureStack Add-on RP Windows Server 1.2009.0

• Asegúrese de que la máquina virtual de Windows Server necesaria esté descargada en Marketplace de Azure Stack Hub. Si es necesario, descargue manualmente la imagen según la tabla de asignación de versiones anterior.

• Asegúrese de que se cumplen los requisitos previos de la integración del centro de datos:

  Requisito previo	Referencia
  El reenvío condicional de DNS se ha establecido correctamente.	Integración de Azure Stack Hub en el centro de datos: DNS
  Los puertos de entrada para los proveedores de recursos están abiertos.	Integración de Azure Stack Hub en el centro de datos: publicar puntos de conexión
  Se han establecido correctamente el SAN y el asunto del certificado.	Requisitos de certificados de infraestructura de clave pública de Azure Stack Hub: certificados obligatoriosRequisitos de certificados de PaaS de Azure Stack Hub: certificados opcionales

• Prepare el certificado. (Solo para las instalaciones de sistemas integrados).

  • Debe proporcionar el certificado PKI de PaaS de SQL que se describe en la sección Certificados de PaaS opcionales de Requisitos de certificados de infraestructura de clave pública de Azure Stack Hub. El nombre alternativo del sujeto (SAN) debe cumplir el siguiente patrón de nomenclatura: CN=*.dbadapter.<región>.<fqdn>, con protección por contraseña.
  • Al implementar el proveedor de recursos de MySQL Server V1, coloque el archivo .pfx en la ubicación especificada por el parámetro DependencyFilesLocalPath. No proporcione un certificado para los sistemas ASDK.
  • Al implementar el proveedor de recursos de MySQL Server V2, prepare el certificado para los siguientes pasos de instalación.

Escenario sin conexión

Al implementar el proveedor de recursos de MySQL Server V2 en un escenario desconectado, siga las instrucciones de descarga de elementos de Marketplace en Azure Stack Hub para descargar el elemento del proveedor de recursos de MySQL Server y el elemento de Add-on RP Windows Server en el entorno de Azure Stack Hub.

Al implementar el proveedor de recursos de MySQL Server V1 en un escenario desconectado, complete los pasos siguientes para descargar los módulos de PowerShell necesarios y registrar el repositorio manualmente.

1. Inicie sesión en un equipo con conectividad a Internet y use los siguientes scripts para descargar los módulos de PowerShell.

   Import-Module -Name PowerShellGet -ErrorAction Stop
   Import-Module -Name PackageManagement -ErrorAction Stop
   
   # path to save the packages, c:\temp\azs1.6.0 as an example here
   $Path = "c:\temp\azs1.6.0"
   

2. En función de la versión del proveedor de recursos que esté implementando, ejecute uno de estos scripts.

   # for resource provider version >= 1.1.93.0
   Save-Package -ProviderName NuGet -Source https://www.powershellgallery.com/api/v2 -Name AzureRM -Path $Path -Force -RequiredVersion 2.5.0
   Save-Package -ProviderName NuGet -Source https://www.powershellgallery.com/api/v2 -Name AzureStack -Path $Path -Force -RequiredVersion 1.8.2
   

   # for resource provider version <= 1.1.47.0
   Save-Package -ProviderName NuGet -Source https://www.powershellgallery.com/api/v2 -Name AzureRM -Path $Path -Force -RequiredVersion 2.3.0
   Save-Package -ProviderName NuGet -Source https://www.powershellgallery.com/api/v2 -Name AzureStack -Path $Path -Force -RequiredVersion 1.6.0
   

3. Después, copie los paquetes descargados en un dispositivo USB.

4. Inicie sesión en la estación de trabajo desconectada y copie los paquetes desde el dispositivo USB en una ubicación en dicha estación de trabajo.

5. Registre esta ubicación como un repositorio local.

   # requires -Version 5
   # requires -RunAsAdministrator
   # requires -Module PowerShellGet
   # requires -Module PackageManagement
   
   $SourceLocation = "C:\temp\azs1.6.0"
   $RepoName = "azs1.6.0"
   
   Register-PSRepository -Name $RepoName -SourceLocation $SourceLocation -InstallationPolicy Trusted
   
   New-Item -Path $env:ProgramFiles -name "SqlMySqlPsh" -ItemType "Directory" 
   

Implementación del proveedor de recursos de MySQL V2

Si va a actualizar desde una versión V1, consulte el documento Actualización de un proveedor de recursos de MySQL Server.

Inicio de la instalación

1. Si todavía no lo ha hecho, inicie sesión en el portal de administración de Azure Stack Hub, seleccione Administración de Marketplace a la izquierda y seleccione Proveedores de recursos.

2. Una vez que el proveedor de recursos de MySQL y el resto de software necesario se hayan descargado, Administración de Marketplace mostrará los paquetes "MySQL Server resource provider" con el estado "Not Installed" (No instalado). Puede haber otros paquetes que muestren el estado "Downloaded" (Descargado).

   

3. Seleccione la fila que desee instalar. La página del paquete de instalación del proveedor de recursos de MySQL Server muestra un banner azul en la parte superior. Seleccione el banner para iniciar la instalación.

Requisitos previos de instalación

1. A continuación, se le transferirá a la página de instalación. Seleccione Install Prerequisites (Instalar requisitos previos) para iniciar el proceso de instalación.

2. Espere hasta que la instalación de los requisitos previos sea correcta. Verá una marca de verificación verde junto a Install prerequisites (Instalar requisitos previos) antes de continuar con el paso siguiente.

Preparar secretos

1. En el paso 2. Prepare secrets (Preparar secretos), seleccione Add certificate (Agregar certificado) y aparecerá el panel Add a certificate (Agregar un certificado).

2. Seleccione el botón browse (examinar) en Add a certificate (Agregar un certificado), a la derecha del campo de nombre de archivo de certificado. Seleccione el archivo de certificado .pfx que ha adquirido al completar los requisitos previos.

3. Escriba la contraseña que proporcionó para crear una cadena segura para el certificado SSL del proveedor de recursos de SQL Server. A continuación, seleccione Agregar.

Configuración e instalación del proveedor de recursos

1. Cuando la instalación del certificado se realice correctamente, verá una marca de verificación verde junto a Prepare secrets (Preparar secretos) antes de continuar con el siguiente paso. Ahora, seleccione el botón Configure + Install (Configurar + Instalar) junto a 3 Install resource provider (Instalar proveedor de recursos).

2. A continuación, deberá proporcionar un URI de blob de Azure Stack Hub para MySQL Connector.

   • Revise la licencia GPL de MySQL Connector aquí y descargue la versión 8.0.21 en una carpeta local.

   • Cree una cuenta de almacenamiento con la suscripción de operador predeterminada y cree un contenedor con el nivel de acceso "Blob" o "Contenedor".

   • Cargue el archivo mysql-connector-net-8.0.21.msi desde la carpeta local al contenedor de almacenamiento recién creado.

   Importante

   Asegúrese de que la versión del conector mySQL es la 8.0.21.

   • Copie el URI del blob.

   • Vuelva a la página de configuración del proveedor de recursos de MySQL. Pegue el URI del blob (por ejemplo, https://<storageAccountName>.blob.<región>.<FQDN>/<nombreDelContenedor>/mysql-connector-net-8.0.21.msi) en el cuadro de texto y haga clic en Aceptar.

3. A continuación, verá la siguiente página, que indica que se está instalando el proveedor de recursos de MySQL.

4. Espere a la notificación de que la instalación se completó. Este proceso suele tardar una o varias horas, en función del tipo de Azure Stack Hub.

5. Compruebe que la instalación del proveedor de recursos de MySQL Server se ha realizado correctamente; para ello, vuelva a la página Resource Providers (Proveedores de recursos) de Marketplace Management (Administración de Marketplace). El estado del proveedor de recursos de MySQL Server debe mostrar "Installed" (Instalado).

Implementación del proveedor de recursos de SQL V1

Una vez completados todos los requisitos previos, ejecute el extractor automático para extraer el paquete de instalación descargado en un directorio temporal. Ejecute el script DeployMySqlProvider.ps1 desde un equipo que pueda acceder al punto de conexión de administración de Azure Resource Manager para Azure Stack Hub y al punto de conexión con privilegios para implementar el proveedor de recursos de MySQL. El script DeployMySqlProvider.ps1 se extrae como parte de los archivos de instalación del proveedor de recursos MySQL descargado para su versión de Azure Stack Hub.

Importante

Antes de implementar el proveedor de recursos, revise las notas de la versión para obtener información sobre las nuevas funciones, correcciones y problemas conocidos que podrían afectar a la implementación.

Para implementar el proveedor de recursos de MySQL, abra una nueva ventana de PowerShell con privilegios elevados (no de PowerShell ISE) y cambie al directorio en el que ha extraído los archivos binarios del proveedor de recursos de MySQL.

Importante

Se recomienda encarecidamente usar los comandos Clear-AzureRmContext -Scope CurrentUser y Clear-AzureRmContext -Scope Process para borrar la memoria caché antes de ejecutar el script de implementación o de actualización.

Nota:

Si va a implementar el proveedor de recursos de MySQL Server V1 en un entorno desconectado, copie el archivo mysql-connector-net-6.10.5.msi en una ruta de acceso local. Proporcione el nombre de ruta de acceso mediante el parámetro DependencyFilesLocalPath.

Ejecute el script DeployMySqlProvider.ps1, que realiza las tareas siguientes:

• Carga los certificados y otros artefactos en una cuenta de almacenamiento de Azure Stack Hub.
• Publica paquetes de la galería para poder implementar las bases de datos MySQL mediante esta.
• Publica un paquete de galería para implementar los servidores de hospedaje.
• Implementa una máquina virtual mediante la imagen principal de Windows Server 2016 o del complemento Microsoft Azure Stack RP Windows Server y, luego, instala el proveedor de recursos de MySQL.
• Registra un registro de DNS local que se asigna a la VM del proveedor de recursos.
• Registra el proveedor de recursos en la instancia local de Azure Resource Manager para las cuentas de operador.

Nota:

Cuando se inicia la implementación del proveedor de recursos MySQL, se crea el grupo de recursos system.local.mysqladapter. Las implementaciones necesarias de este grupo de recursos pueden tardar hasta 75 minutos en finalizar. No debe colocar ningún otro recurso en el grupo de recursos system.local.mysqladapter.

Parámetros de DeployMySqlProvider.ps1

Puede especificar estos parámetros en la línea de comandos. Si no lo hace, o se produce un error en la validación de algún parámetro, se le pedirá que proporcione los parámetros necesarios.

Nombre de parámetro	Descripción	Comentario o valor predeterminado
CloudAdminCredential	Credencial del administrador de la nube, necesaria para el acceso al punto de conexión con privilegios.	Obligatorio
AzCredential	Credenciales de la cuenta de administrador de servicios de Azure Stack Hub. Use las mismas credenciales que para la implementación de Azure Stack Hub. Se producirá un error en el script si la cuenta que usa con AzCredential requiere autenticación multifactor (MFA).	Obligatorio
VMLocalCredential	Las credenciales para la cuenta de administrador local de la VM del proveedor de recursos de MySQL.	Obligatorio
PrivilegedEndpoint	Dirección IP o nombre DNS del punto de conexión con privilegios.	Obligatorio
AzureEnvironment	Entorno de Azure de la cuenta de administrador de servicios que se usó para la implementación de Azure Stack Hub. Solo es necesario para las implementaciones de Microsoft Entra. Los nombres de entorno admitidos son AzureCloud, AzureUSGovernment o si se usa un Microsoft Entra ID de China, AzureChinaCloud.	AzureCloud
DependencyFilesLocalPath	El archivo .pfx de certificados se debe colocar en este directorio, pero solo en los sistemas integrados. En el caso de entornos desconectados, descargue mysql-connector-net-6.10.5 a este directorio. También puede copiar un paquete de Windows Update MSU aquí.	Opcional (obligatorio para sistemas integrados o entornos desconectados)
DefaultSSLCertificatePassword	Contraseña para el certificado .pfx.	Obligatorio
MaxRetryCount	El número de veces que quiere volver a intentar cada operación si se produce un error.	2
RetryDuration	Intervalo de tiempo de expiración entre reintentos, en segundos.	120
Desinstalación	Se quita el proveedor de recursos y todos los recursos asociados (vea las notas siguientes).	No
DebugMode	Impide la limpieza automática en caso de error.	No
AcceptLicense	Omite el aviso para aceptar la licencia GPL. https://www.gnu.org/licenses/old-licenses/gpl-2.0.html

Implementación del proveedor de recursos MySQL con un script personalizado

Si va a implementar la versión 1.1.47.0, u otra posterior, del proveedor de recursos de MySQL, el script de implementación descargará e instalará automáticamente los módulos de PowerShell necesarios en la ruta de acceso C:\Archivos de programa\SqlMySqlPsh.

# Install the AzureRM.Bootstrapper module, set the profile and install the AzureStack module
# Note that this might not be the most currently available version of Azure Stack Hub PowerShell
Install-Module -Name AzureRm.BootStrapper -Force
Use-AzureRmProfile -Profile 2018-03-01-hybrid -Force
Install-Module -Name AzureStack -RequiredVersion 1.6.0

Nota:

Si trabaja en un escenario desconectado, deberá descargar los módulos de PowerShell necesarios y registrar el repositorio manualmente como requisito previo.

Para eliminar cualquier configuración manual al implementar el proveedor de recursos, puede personalizar el script siguiente. Cambie la información de cuenta predeterminada y las contraseñas según sea necesario para su implementación de Azure Stack Hub.

# Use the NetBIOS name for the Azure Stack Hub domain. On the Azure Stack Hub SDK, the default is AzureStack but could have been changed at install time.
$domain = "AzureStack"  

# For integrated systems, use the IP address of one of the ERCS VMs.
$privilegedEndpoint = "AzS-ERCS01"

# Provide the Azure environment used for deploying Azure Stack Hub. Required only for Azure AD deployments. Supported environment names are AzureCloud, AzureUSGovernment, or AzureChinaCloud. 
$AzureEnvironment = "<EnvironmentName>"

# Point to the directory where the resource provider installation files were extracted.
$tempDir = 'C:\TEMP\MYSQLRP'

# The service admin account (can be Azure Active Directory or Active Directory Federation Services).
$serviceAdmin = "admin@mydomain.onmicrosoft.com"
$AdminPass = ConvertTo-SecureString 'P@ssw0rd1' -AsPlainText -Force
$AdminCreds = New-Object System.Management.Automation.PSCredential ($serviceAdmin, $AdminPass)

# Set the credentials for the new resource provider VM local admin account
$vmLocalAdminPass = ConvertTo-SecureString 'P@ssw0rd1' -AsPlainText -Force
$vmLocalAdminCreds = New-Object System.Management.Automation.PSCredential ("mysqlrpadmin", $vmLocalAdminPass)

# And the cloudadmin credential required for privileged endpoint access.
$CloudAdminPass = ConvertTo-SecureString 'P@ssw0rd1' -AsPlainText -Force
$CloudAdminCreds = New-Object System.Management.Automation.PSCredential ("$domain\cloudadmin", $CloudAdminPass)

# Change the following as appropriate.
$PfxPass = ConvertTo-SecureString 'P@ssw0rd1' -AsPlainText -Force

# For version 1.1.47.0 or later, the PowerShell modules used by the RP deployment are placed in C:\Program Files\SqlMySqlPsh,
# The deployment script adds this path to the system $env:PSModulePath to ensure correct modules are used.
$rpModulePath = Join-Path -Path $env:ProgramFiles -ChildPath 'SqlMySqlPsh'
$env:PSModulePath = $env:PSModulePath + ";" + $rpModulePath

# Change to the directory folder where you extracted the installation files. Don't provide a certificate on ASDK!
. $tempDir\DeployMySQLProvider.ps1 `
    -AzCredential $AdminCreds `
    -VMLocalCredential $vmLocalAdminCreds `
    -CloudAdminCredential $cloudAdminCreds `
    -PrivilegedEndpoint $privilegedEndpoint `
    -AzureEnvironment $AzureEnvironment `
    -DefaultSSLCertificatePassword $PfxPass `
    -DependencyFilesLocalPath $tempDir\cert `
    -AcceptLicense

Cuando finalice el script de instalación del proveedor de recursos, actualice el explorador para asegurarse de que puede ver las actualizaciones más recientes y cierre la sesión de PowerShell actual.

Comprobación de la implementación de V1 mediante el portal de Azure Stack Hub

1. Inicie sesión en el portal de administración como administrador de servicios.
2. Seleccione Grupos de recursos.
3. Seleccione el grupo de recursos system.<ubicación>.mysqladapter.
4. En la página de resumen de la información general del grupo de recursos no debería haber implementaciones con errores.
5. Por último, seleccione Máquinas virtuales en el portal de administración para comprobar que la VM del proveedor de recursos MySQL se ha creado correctamente y está en ejecución.

Configuración importante para Microsoft Entra ID

Si Azure Stack Hub usa Microsoft Entra ID como proveedor de identidades, asegúrese de que la máquina virtual que ha instalado el proveedor de recursos de MySQL Server tiene conectividad saliente a Internet.

Si es necesario obtener la dirección IP de la máquina virtual que ha instalado un proveedor de recursos de MySQL Server (es decir, agregar la dirección IP a la lista de permitidos del firewall), debe abrir un caso de soporte técnico y solicitar al ingeniero de soporte técnico que haga que la suscripción del proveedor de recursos de MySQL Server sea visible temporalmente. A continuación, puede localizar la máquina virtual en la suscripción y obtener su dirección IP.

Pasos siguientes

Add hosting servers (Agregar servidores de hospedaje)