Implantar o provedor de recursos do SQL Server no Azure Stack Hub

Use o provedor de recursos do SQL Server do Azure Stack Hub para expor bancos de dados SQL como um serviço do Azure Stack Hub.

Pré-requisitos

Se você já instalou um provedor de recursos, provavelmente concluiu os pré-requisitos a seguir e pode ignorar esta seção. Caso contrário, conclua estas etapas antes de continuar:

1. Registre sua instância do Azure Stack Hub no Azure, caso ainda não tenha feito isso. Você precisa registrar sua instância de Azure Stack Hub com Azure porque você estará se conectando a Azure e baixando itens do marketplace.

2. Se você não estiver familiarizado com o recurso Gerenciamento do Marketplace do portal do administrador do Azure Stack Hub, consulte Baixar itens do Marketplace do Azure e publicá-los no Azure Stack Hub. O artigo orienta você pelo processo de download de itens do Azure para o marketplace do Azure Stack Hub. Abrange cenários conectados e desconectados. Se a instância do Azure Stack Hub estiver desconectada ou parcialmente conectada, há pré-requisitos adicionais a serem concluídos na preparação para a instalação.

3. Atualize o diretório inicial do Microsoft Entra. A partir do build 1910, você deve registrar um novo aplicativo no locatário do diretório inicial. Esse aplicativo permite que Azure Stack Hub crie e registre com êxito provedores de recursos mais recentes (como Hubs de Eventos e outros) com seu locatário Microsoft Entra. Essa ação é necessária após a atualização para o build 1910 ou mais recente. Se você não concluir esta etapa, as instalações do provedor de recursos do marketplace falharão.

   • Depois de atualizar com êxito sua instância de Azure Stack Hub para 1910 ou superior, siga as instructions para clonar/baixar o repositório Azure Stack Hub Tools.
   • Em seguida, siga as instruções para atualizar o diretório inicial do Microsoft Entra do Azure Stack Hub (depois de instalar atualizações ou novos provedores de recursos).

Pré-requisitos do provedor de recursos do SQL Server

• Você precisará de um computador e uma conta que possa acessar:

  • o portal de administrador do Azure Stack Hub.
  • o ponto de extremidade privilegiado (necessário apenas ao implantar o provedor de recursos do SQL Server V1 ou ao atualizar do provedor de recursos do SQL Server V1 para o provedor de recursos do SQL Server V2).
  • o ponto de extremidade do administrador do Azure Resource Manager, https://adminmanagement.region.<fqdn>, em que <fqdn> é seu nome de domínio totalmente qualificado.
  • a internet, se o Azure Stack Hub foi implantado para usar o Microsoft Entra ID como seu provedor de identidade.

• Baixe a versão com suporte do binário do provedor de recursos SQL de acordo com a tabela de mapeamento de versão abaixo. Para o provedor de recursos SQL V2, baixe o item do marketplace para o Azure Stack Hub.

  Versão do Azure Stack Hub com suporte	Versão do RP do SQL	Windows Server no qual o serviço RP está em execução
  2206, 2301, 2306, 2311	SQL RP versão 2.0.13.x	RP do complemento do Windows Server 1.2009.0 do Microsoft AzureStack
  2108, 2206	RP do SQL versão 2.0.6.x	RP do complemento do Windows Server 1.2009.0 do Microsoft AzureStack

• Verifique se a VM necessária do Windows Server foi baixada para o Azure Stack Hub Marketplace. Baixe manualmente a imagem de acordo com a tabela de mapeamento de versão acima, se necessário.

• Verifique se os pré-requisitos de integração do datacenter são atendidos:

  Pré-requisito	Referência
  O encaminhamento de DNS condicional é definido corretamente.	Integração do datacenter do Azure Stack Hub – DNS
  As portas de entrada para provedores de recursos estão abertas.	Integração de datacenter do Azure Stack Hub – Portas e protocolos de entrada
  O assunto do certificado PKI e o SAN são definidos corretamente.	Pré-requisitos de PKI obrigatórios para implantação do Azure Stack Hub Pré-requisitos de certificado paaS de implantação do Azure Stack Hub

• Prepare o certificado. (Somente para instalações de sistemas integrados.)

  • Você deve fornecer o certificado PKI de PaaS do SQL descrito na seção de certificados PaaS opcionais dos requisitos de PKI de implantação do Azure Stack Hub. O SAN (Nome Alternativo do Sujeito) deve seguir o seguinte padrão de nomenclatura: CN=*.dbadapter.<região>.<fqdn>, com a senha protegida.
  • Ao implantar o provedor de recursos do SQL Server V1, coloque o arquivo .pfx no local especificado pelo parâmetro DependencyFilesLocalPath . Não forneça um certificado para sistemas ASDK.
  • Ao implantar o provedor de recursos do SQL Server V2, prepare o certificado para as etapas de instalação a seguir.

Cenário desconectado

Ao implantar o provedor de recursos SQL Server V2 em um cenário desconectado, siga a instrução baixar itens do marketplace para o Azure Stack Hub para baixar o item do provedor de recursos SQL Server e o item Add-on RP Windows Server para o seu ambiente do Azure Stack Hub.

Ao implantar o provedor de recursos do SQL Server V1 em um cenário desconectado, conclua as etapas a seguir para baixar os módulos necessários do PowerShell e registrar o repositório manualmente.

1. Entre em um computador com conectividade com a Internet e use os scripts a seguir para baixar os módulos do 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. Dependendo da versão do provedor de recursos que você está implantando, execute um dos 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. Em seguida, você copia os pacotes baixados para um dispositivo USB.

4. Entre na estação de trabalho desconectada e copie os pacotes do dispositivo USB para um local na estação de trabalho.

5. Registre esse local como um repositório 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"
   

Implantar o provedor de recursos SQL V2

Se você estiver atualizando de uma versão V1, consulte o documento Atualizar o provedor de recursos do SQL Server.

Iniciar a instalação

1. Se ainda não o fez, entre no portal do administrador do Azure Stack Hub, selecione Gerenciamento do Marketplace à esquerda e selecione Provedores de recursos.

2. Depois que o provedor de recursos SQL e outros softwares necessários tiverem sido baixados, o Gerenciamento do Marketplace mostrará os pacotes "Provedor de recursos do SQL Server" com o status "Não instalado". Pode haver outros pacotes que mostram o status "Baixado".

3. Selecione a linha que você deseja instalar. A página do pacote de instalação do provedor de recursos do SQL Server mostra uma faixa azul na parte superior. Selecione o banner para iniciar a instalação.

Instalar pré-requisitos

1. Em seguida, você será transferido para a página de instalação. Selecione Instalar pré-requisitos de Instalação para iniciar o processo de instalação.

2. Aguarde até que a instalação dos pré-requisitos seja realizada com sucesso. Você deverá ver uma marca de seleção verde ao lado Instalar pré-requisitos antes de prosseguir para a próxima etapa.

Preparar segredos

1. Abaixo do 2. Preparar segredos, selecione Adicionar certificado, e o painel Adicionar certificado será exibido.

2. Selecione o botão de navegação em Adicionar um certificado, à direita do campo do nome do arquivo do certificado. Selecione o arquivo de certificado .pfx que você adquiriu ao preencher os pré-requisitos.

3. Insira a senha fornecida para criar uma cadeia de caracteres segura para o Certificado SSL do provedor de recursos do SQL Server. Em seguida, selecioneAdicionar.

Instalar provedor de recursos

1. Quando a instalação do certificado for bem-sucedida, você deverá ver uma marca de seleção verde ao lado de Preparar segredos antes de prosseguir para a próxima etapa. Agora selecione o botão Instalar próximo a 3 Instalar provedor de recursos.

2. Em seguida, você verá a página a seguir, que indica que o provedor de recursos SQL está sendo instalado.

3. Aguarde a notificação de conclusão da instalação. Esse processo geralmente leva uma ou mais horas, dependendo do tipo de Azure Stack Hub. Captura de tela da instalação de gerenciamento de RP do marketplace em andamento.

4. Verifique se a instalação do provedor de recursos do SQL Server foi bem-sucedida, retornando à página Gerenciamento do Marketplace, Provedores de Recursos . O status do provedor de recursos do SQL Server deve mostrar "Instalado".

Implantar o provedor de recursos SQL V1

Depois de concluir todos os pré-requisitos, execute o auto-extrator para extrair o pacote de instalação baixado para um diretório temporário. Execute o script DeploySqlProvider.ps1 de um computador que possa acessar tanto o ponto de extremidade de administrador do Azure Stack Hub Azure Resource Manager quanto o ponto de extremidade privilegiado; para implantar o provedor de recursos SQL. O script DeploySqlProvider.ps1 é extraído como parte do binário do provedor de recursos SQL que você baixou para sua versão do Azure Stack Hub.

Para implantar o provedor de recursos SQL, abra uma nova janela do PowerShell com privilégios elevados (não o ISE do PowerShell) e altere para o diretório em que você extraiu os arquivos binários do provedor de recursos SQL.

Execute o script DeploySqlProvider.ps1, que conclui as seguintes tarefas:

• Carrega os certificados e outros artefatos em uma conta de armazenamento no Azure Stack Hub.
• Publica pacotes da galeria para que você possa implantar bancos de dados SQL usando a galeria.
• Publica um pacote de galeria para a implantação de servidores de hospedagem.
• Implanta uma VM usando a imagem principal do Windows Server 2016 ou a imagem do RP do complemento do Windows Server do Microsoft AzureStack que você baixou e instala o provedor de recursos SQL.
• Registra um registro DNS local associado à sua VM do provedor de recursos.
• Registra seu provedor de recursos no Gerenciador de Recursos do Azure local para a conta do operador.

parâmetros de DeploySqlProvider.ps1

Você pode especificar os seguintes parâmetros na linha de comando. Se você não fizer isso ou se alguma validação de parâmetro falhar, será solicitado que você forneça os parâmetros necessários.

Implantar o provedor de recursos SQL usando um script personalizado

Se você estiver implantando o provedor de recursos SQL versão 1.1.47.0 ou posterior, o script de implantação baixará e instalará automaticamente os módulos necessários do PowerShell no caminho C:\Program Files\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 qualquer configuração manual ao implantar o provedor de recursos, você pode personalizar o script a seguir. Altere as informações e senhas da conta padrão conforme necessário para a implantação do 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

Quando o script de instalação do provedor de recursos for concluído, atualize o navegador para garantir que você possa ver as atualizações mais recentes e fechar a sessão atual do PowerShell.

Verificar a implantação da V1 usando o portal do Azure Stack Hub

1. Entre no portal do administrador como o administrador do serviço.
2. Selecionar Grupos de recursos.
3. Selecione o grupo de recursos system.<location>.sqladapter.
4. Na página de resumo da Visão geral do grupo de recursos, não deve existir nenhum erro nas implantações.
5. Por fim, selecione máquinas virtuais no portal do administrador para verificar se a VM do provedor de recursos SQL foi criada com êxito e está em execução.

Configuração importante para a ID do Microsoft Entra

Se o Azure Stack Hub estiver usando a ID do Microsoft Entra como um provedor de identidade, verifique se a VM que instalou o provedor de recursos do SQL Server tem conectividade de saída com a Internet.

Próximas etapas

Adicionar servidores de hospedagem