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 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á a Azure Stack Hub crear y registrar 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 para Actualizar el directorio principal de Microsoft Entra de Azure Stack Hub (después de instalar actualizaciones o nuevos proveedores de recursos).

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).
  • el 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 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 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 AzureStack Add-on RP Windows Server 1.2009.0
  2108, 2206	SQL RP versión 2.0.6.x	Microsoft AzureStack Add-on RP 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
  El firmante del certificado PKI y SAN se establecen correctamente.	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 descrito en la sección certificados PaaS opcionales de los requisitos de PKI de implementación de Azure Stack Hub. El nombre alternativo del firmante (SAN) debe cumplir el siguiente patrón de nomenclatura: CN=*.dbadapter.<región>.<fqdn>, con contraseña protegida.
  • 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 rp de Windows Server del complemento 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 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. Debajo de los 2. Paso preparar secretos , seleccione Agregar certificado y aparecerá el panel 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 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 deDeploySqlProvider.ps1 desde un equipo que pueda acceder tanto al punto de conexión de administración de Azure Resource Manager de Azure Stack Hub como al punto de conexión con privilegios, para implementar el proveedor de recursos de SQL. El script de DeploySqlProvider.ps1 se extrae como parte del binario del proveedor de recursos de SQL que descargó para la 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 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 el proveedor de recursos con azure Resource Manager local para la cuenta de 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 va a implementar 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 de PowerShell necesarios para que pueda obtener 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 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