Implementación del proveedor de recursos de SQL Server en Azure Stack Hub

Use el proveedor de recursos de SQL Server de Azure Stack Hub para exponer bases de datos SQL como un servicio de Azure Stack Hub.

Prerrequisitos

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

1. Registre la instancia de Azure Stack Hub en Azure, si no lo ha hecho. Debe registrar la instancia de Azure Stack Hub con Azure, ya que se conectará a Azure y descargará elementos de Marketplace.

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, debe completar requisitos previos adicionales como preparación para la instalación.

3. Actualice el directorio principal de Microsoft Entra. A partir de la versión 1910, debe registrar una nueva aplicación en el tenant de su directorio principal. Esta aplicación permite a Azure Stack Hub crear y registrar correctamente proveedores de recursos más recientes (como Azure Event Hubs y otros) con el inquilino de Microsoft Entra.

   Esta acción es necesaria después de actualizar a la compilación 1910 o posterior. Si no completa este paso, las instalaciones de proveedores de recursos del Marketplace fallarán.

4. Después de actualizar correctamente la instancia de Azure Stack Hub a 1910 o posterior, siga las instrucciones para clonar o descargar el repositorio Azure Stack Hub Tools.

5. Siga las instrucciones para actualizar el directorio principal de Azure Stack Hub Microsoft Entra (después de instalar actualizaciones o proveedores de recursos nuevos) .

Requisitos previos del proveedor de recursos de SQL Server

• Necesitará un equipo y una cuenta que pueda acceder a:

  • el 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 SQL Server V1 o se actualiza desde el proveedor de recursos de SQL Server V1 al proveedor de recursos de SQL 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.
  • el Internet, si Azure Stack Hub se implementó para usar Microsoft Entra ID como proveedor de identidades.

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

  Versión admitida de Azure Stack Hub	Versión de SQL RP	Windows Server en el que se ejecuta el servicio RP
  2206, 2301, 2306, 2311	SQL RP versión 2.0.13.x	Microsoft Azure Stack Add-on RP para Windows Server 1.2009.0
  2108, 2206	SQL RP versión 2.0.6.x	Microsoft Azure Stack Add-on RP para Windows Server 1.2009.0

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

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

  Prerrequisito	Referencia
  El reenvío DNS condicional se ha establecido correctamente.	Integración del centro de datos de Azure Stack Hub: DNS
  Los puertos de entrada para los proveedores de recursos están abiertos.	Integración del centro de datos de Azure Stack Hub: puertos y protocolos entrantes
  Se han establecido correctamente el SAN y el asunto del certificado.	Requisitos previos de PKI obligatorios de implementación de Azure Stack Hub Requisitos previos del certificado PaaS de implementación de Azure Stack Hub

• Prepare el certificado. (Solo para 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 SQL 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 SQL Server V2, prepare el certificado para los pasos de instalación siguientes.

Escenario sin conexión

Al implementar el proveedor de recursos de SQL 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 SQL Server y el elemento de Add-on RP Windows Server en el entorno de Azure Stack Hub.

Al implementar el proveedor de recursos de SQL 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 va a implementar, ejecute uno de los 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. A continuación, copie los paquetes descargados en un dispositivo USB.

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

5. Registre esta ubicación como 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 SQL V2

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

Iniciar 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 descargado el proveedor de recursos de SQL y otro software necesario, Administración de Marketplace muestra los paquetes "Proveedor de recursos de SQL Server" con el estado "No instalado". Puede haber otros paquetes que muestren el estado "Downloaded" (Descargado).

3. Seleccione la fila que desea instalar. La página del paquete de instalación del proveedor de recursos de SQL 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 a que la instalación de los requisitos previos se complete correctamente. Verá una marca de verificación verde junto a Install prerequisites (Instalar requisitos previos) antes de continuar con el paso siguiente.

Preparar secretos

1. Bajo el paso 2. Preparar secretos, seleccione Agregar certificado y aparecerá el panel Agregar un certificado.

2. Seleccione el botón Examinar en Agregar un certificado, justo a la derecha del campo del nombre de archivo del certificado. Seleccione el archivo de certificado .pfx que ha adquirido al completar los requisitos previos.

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

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 Install (Instalar) junto a 3 Install resource provider (Instalar proveedor de recursos).

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

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

4. Compruebe que la instalación del proveedor de recursos de SQL Server se ha realizado correctamente; para ello, vuelva a la página Administración de Marketplace, Proveedores de recursos . El estado del proveedor de recursos de SQL Server debe mostrar "Instalado".

Implementación del proveedor de recursos de SQL V1

Una vez completados todos los requisitos previos, ejecute el extractor propio para extraer el paquete de instalación descargado en un directorio temporal. Ejecute el script DeploySqlProvider.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 SQL. El script DeploySqlProvider.ps1 se extrae como parte del archivo binario del proveedor de recursos de SQL descargado para su versión de Azure Stack Hub.

Para implementar el proveedor de recursos de SQL, abra una nueva ventana de PowerShell con privilegios elevados (no PowerShell ISE) y cambie al directorio donde extrajo los archivos binarios del proveedor de recursos de SQL.

Ejecute el script DeploySqlProvider.ps1, que completa las tareas siguientes:

• Carga los certificados y otros artefactos en una cuenta de almacenamiento en Azure Stack Hub.
• Publica paquetes de la galería para que pueda implementar bases de datos SQL mediante la galería.
• 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 la imagen de Microsoft AzureStack Add-on RP Windows Server que descargó y, a continuación, instala el proveedor de recursos de SQL.
• Registra un registro DNS local que se asigna a la máquina virtual del proveedor de recursos.
• Registra tu proveedor de recursos con el Azure Resource Manager local para la cuenta del operador.

Parámetros de DeploySqlProvider.ps1

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

Implementación del proveedor de recursos de SQL mediante un script personalizado

Si está implementando la versión 1.1.47.0 o posterior del proveedor de recursos de SQL, el script de implementación descargará e instalará automáticamente los módulos necesarios de PowerShell 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 -RequiredVersion 0.5.0 -Force
Use-AzureRmProfile -Profile 2018-03-01-hybrid -Force
Install-Module -Name AzureStack -RequiredVersion 1.6.0

Para eliminar cualquier configuración manual al implementar el proveedor de recursos, puede personalizar el siguiente script. Cambie la información predeterminada de la cuenta y las contraseñas según sea necesario para la 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 values for the <environment name> parameter are AzureCloud, AzureChinaCloud, or AzureUSGovernment depending which Azure subscription you're using.
$AzureEnvironment = "<EnvironmentName>"

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

# 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 credentials for the new resource provider VM local admin account.
$vmLocalAdminPass = ConvertTo-SecureString 'P@ssw0rd1' -AsPlainText -Force
$vmLocalAdminCreds = New-Object System.Management.Automation.PSCredential ("sqlrpadmin", $vmLocalAdminPass)

# Add the cloudadmin credential that's 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\DeploySQLProvider.ps1 `
    -AzCredential $AdminCreds `
    -VMLocalCredential $vmLocalAdminCreds `
    -CloudAdminCredential $cloudAdminCreds `
    -PrivilegedEndpoint $privilegedEndpoint `
    -AzureEnvironment $AzureEnvironment `
    -DefaultSSLCertificatePassword $PfxPass `
    -DependencyFilesLocalPath $tempDir\cert

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 cerrar la sesión actual de PowerShell.

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

1. Inicie sesión en el portal de administración como administrador del servicio.
2. Seleccione Grupos de recursos.
3. Seleccione el sistema.<grupo de recursos location.sqladapter>.
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 máquina virtual del proveedor de recursos de SQL se creó correctamente y se está ejecutando.

Configuración importante de Microsoft Entra ID

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

Pasos siguientes

Agregar servidores de hospedaje