Distribuera SQL Server Resource Provider på Azure Stack HubDeploy the SQL Server resource provider on Azure Stack Hub

Använd Azure Stack hubb SQL Server Resource Provider för att exponera SQL-databaser som en Azure Stack Hub-tjänst.Use the Azure Stack Hub SQL Server resource provider to expose SQL databases as an Azure Stack Hub service. SQL-resurs-providern körs som en tjänst på en virtuell Windows Server 2016 Server Core-dator (för kort version <= 1.1.47.0>) eller ett särskilt tillägg i RP Windows Server (för kort version >= 1.1.93.0).The SQL resource provider runs as a service on a Windows Server 2016 Server Core virtual machine (for adapter version <= 1.1.47.0>) or a special Add-on RP Windows Server (for adapter version >= 1.1.93.0).

Viktigt

Endast resurs leverantören bör skapa objekt på servrar som är värdar för SQL eller MySQL.Only the resource provider should create items on servers that host SQL or MySQL. Objekt som har skapats på en värd server som inte har skapats av resurs leverantören stöds inte och kan resultera i ett felaktigt tillstånd.Items created on a host server that aren't created by the resource provider are unsupported, and may result in a mismatched state.

FörutsättningarPrerequisites

Det finns flera förutsättningar som måste vara på plats innan du kan distribuera SQL-providern för Azure Stack Hub:There are several prerequisites that need to be in place before you can deploy the Azure Stack Hub SQL resource provider:

  • Du behöver en dator och ett konto som har åtkomst till:You'll need a computer and account that can access:

    • Administratörs portalen för Azure Stack Hub.the Azure Stack Hub administrator portal.
    • den privilegierade slut punkten.the privileged endpoint.
    • Azure Resource Manager administratörs slut punkten, https://management.region.<fqdn> där <fqdn> är det fullständigt kvalificerade domän namnet (eller https://management.local.azurestack.external om du använder ASDK)the Azure Resource Manager admin endpoint, https://management.region.<fqdn>, where <fqdn> is your fully qualified domain name (or https://management.local.azurestack.external if using the ASDK)
    • Internet, om Azure Stack Hub har distribuerats för att använda Azure Active Directory (AD) som identitets leverantör.the Internet, if your Azure Stack Hub was deployed to use Azure Active Directory (AD) as your identity provider.
  • Om du inte redan har gjort det kan du registrera Azure Stack hubb med Azure så att du kan ladda ned Azure Marketplace-objekt.If you haven't already, register Azure Stack Hub with Azure so you can download Azure Marketplace items.

  • Lägg till den virtuella Windows Server-datorn som krävs till Azure Stack Hub Marketplace.Add the required Windows Server VM to Azure Stack Hub Marketplace.

    • För SQL RP-version <= 1.1.47.0, laddar du ned Windows server 2016 Data Center-Server Core- avbildningen.For SQL RP version <= 1.1.47.0, download the Windows Server 2016 Datacenter - Server Core image.
    • För SQL RP-version >= 1.1.93.0, laddar du ned Windows Server-avbildningen Microsoft AzureStack Add-On RP .For SQL RP version >= 1.1.93.0, download the Microsoft AzureStack Add-On RP Windows Server image. Den här Windows Server-versionen är specialiserad på Azure Stack Add-On RP-infrastrukturen och den är inte synlig för klient marknads platsen.This Windows Server version is specialize for Azure Stack Add-On RP Infrastructure and it is not visible to the tenant marketplace.
  • Ladda ned den binära versionen av SQL Resource provider som stöds enligt versions mappnings tabellen nedan.Download the supported version of SQL resource provider binary according to the version mapping table below. Kör själv uppackning för att extrahera det nedladdade innehållet till en tillfällig katalog.Run the self-extractor to extract the downloaded contents to a temporary directory.

    Azure Stack Hub-version som stödsSupported Azure Stack Hub version SQL RP-versionSQL RP version Windows Server som RP-tjänsten körs påWindows Server that RP service is running on
    2008, 20052008, 2005 SQL RP-version 1.1.93.1SQL RP version 1.1.93.1 Microsoft AzureStacke-tillägg RP Windows ServerMicrosoft AzureStack Add-on RP Windows Server
    2005, 2002, 19102005, 2002, 1910 SQL RP-version 1.1.47.0SQL RP version 1.1.47.0 Windows Server 2016 Data Center-Server CoreWindows Server 2016 Datacenter - Server Core
    19081908 SQL RP-version 1.1.33.0SQL RP version 1.1.33.0 Windows Server 2016 Data Center-Server CoreWindows Server 2016 Datacenter - Server Core
  • Se till att kraven för data Center integration är uppfyllda:Ensure datacenter integration prerequisites are met:

    FörutsättningPrerequisite ReferensReference
    Villkorlig DNS-vidarebefordran har angetts korrekt.Conditional DNS forwarding is set correctly. Azure Stack Hub Data Center integration – DNSAzure Stack Hub datacenter integration - DNS
    Inkommande portar för resurs leverantörer är öppna.Inbound ports for resource providers are open. Azure Stack Hub Data Center integration – portar och protokoll inkommandeAzure Stack Hub datacenter integration - Ports and protocols inbound
    PKI-certifikatets ämne och SAN är korrekt inställda.PKI certificate subject and SAN are set correctly. Obligatoriska PKI-krav för Azure Stack hubb distributionAzure Stack Hub deployment mandatory PKI prerequisites
    PaaS för distribution av Azure Stack Hub-komponenterAzure Stack Hub deployment PaaS certificate prerequisites

I ett frånkopplat scenario utför du följande steg för att hämta de nödvändiga PowerShell-modulerna och registrera lagrings platsen manuellt.In a disconnected scenario, complete the following steps to download the required PowerShell modules and register the repository manually.

  1. Logga in på en dator med Internet anslutning och Använd följande skript för att ladda ned PowerShell-modulerna.Sign in to a computer with internet connectivity and use the following scripts to download the PowerShell modules.
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"
  1. Kör ett av skripten beroende på vilken version av resurs leverantören som du distribuerar.Depending on the version of resource provider that you are deploying, run one of the 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
  1. Sedan kopierar du de hämtade paketen till en USB-enhet.Then you copy the downloaded packages to a USB device.

  2. Logga in på den frånkopplade arbets stationen och kopiera paketen från USB-enheten till en plats på arbets stationen.Sign in to the disconnected workstation and copy the packages from the USB device to a location on the workstation.

  3. Registrera den här platsen som en lokal lagrings plats.Register this location as a local repository.

# 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"

CertifikatCertificates

Endast för integrerade system installationer.For integrated systems installations only. Du måste ange det SQL PaaS PKI-certifikat som beskrivs i avsnittet valfria PaaS-certifikat i PKI-kraven för Azure Stack Hub-distribution.You must provide the SQL PaaS PKI certificate described in the optional PaaS certificates section of Azure Stack Hub deployment PKI requirements. Placera. pfx-filen på den plats som anges av parametern DependencyFilesLocalPath .Place the .pfx file in the location specified by the DependencyFilesLocalPath parameter. Ange inget certifikat för ASDK-system.Don't provide a certificate for ASDK systems.

Distribuera SQL Resource-providernDeploy the SQL resource provider

När du har slutfört alla krav kör du DeploySqlProvider.ps1 -skriptet från en dator som har åtkomst till både Azure Stack Hub Azure Resource Manager administratörs slut punkt och den privilegierade slut punkten för att distribuera SQL-adressresursen.After you've completed all of the prerequisites, run the DeploySqlProvider.ps1 script from a computer that can access both the Azure Stack Hub Azure Resource Manager admin endpoint and the privileged endpoint, to deploy the SQL resource provider. DeploySqlProvider.ps1 skriptet extraheras som en del av den binära SQL Resource provider som du laddade ned för din version av Azure Stack Hub.The DeploySqlProvider.ps1 script is extracted as part of the SQL resource provider binary that you downloaded for your version of Azure Stack Hub.

Viktigt

Innan du distribuerar resurs leverantören bör du läsa igenom viktig information och lära dig mer om nya funktioner, korrigeringar och eventuella kända problem som kan påverka din distribution.Before deploying the resource provider, review the release notes to learn about new functionality, fixes, and any known issues that could affect your deployment.

Om du vill distribuera SQL-adressresursen öppnar du ett nytt upphöjt PowerShell-fönster (inte PowerShell ISE) och ändrar till den katalog där du extraherade binära filer för SQL Resource Provider.To deploy the SQL resource provider, open a new elevated PowerShell window (not PowerShell ISE) and change to the directory where you extracted the SQL resource provider binary files.

Viktigt

Vi rekommenderar starkt att du använder Clear-AzureRmContext-scope-CurrentUser och Clear-AzureRmContext-scope-processen för att rensa cacheminnet innan du kör distributions-eller uppdaterings skriptet.We strongly recommend using Clear-AzureRmContext -Scope CurrentUser and Clear-AzureRmContext -Scope Process to clear the cache before running the deploy or update script.

Kör DeploySqlProvider.ps1-skriptet, som utför följande aktiviteter:Run the DeploySqlProvider.ps1 script, which completes the following tasks:

  • Överför certifikat och andra artefakter till ett lagrings konto på Azure Stack Hub.Uploads the certificates and other artifacts to a storage account on Azure Stack Hub.
  • Publicerar Galleri paket så att du kan distribuera SQL-databaser med hjälp av galleriet.Publishes gallery packages so you can deploy SQL databases using the gallery.
  • Publicerar ett galleri paket för distribution av värd servrar.Publishes a gallery package for deploying hosting servers.
  • Distribuerar en virtuell dator med Windows Server 2016 Core-avbildningen eller Microsoft AzureStack RP Windows Server-avbildningen som du laddade ned och installerar sedan SQL-adressresursen.Deploys a VM using the Windows Server 2016 core image or Microsoft AzureStack Add-on RP Windows Server image you downloaded, and then installs the SQL resource provider.
  • Registrerar en lokal DNS-post som mappar till den virtuella resurs leverantörens VM.Registers a local DNS record that maps to your resource provider VM.
  • Registrerar din resurs leverantör med det lokala Azure Resource Manager för operatörs kontot.Registers your resource provider with the local Azure Resource Manager for the operator account.

Anteckning

När distributionen av SQL Resource Provider startar skapas resurs gruppen system. local. sqladapter .When the SQL resource provider deployment starts, the system.local.sqladapter resource group is created. Det kan ta upp till 75 minuter att slutföra de nödvändiga distributionerna till den här resurs gruppen.It may take up to 75 minutes to finish the required deployments to this resource group. Du bör inte placera några andra resurser i resurs gruppen system. local. sqladapter .You should not place any other resources in the system.local.sqladapter resource group.

DeploySqlProvider.ps1 parametrarDeploySqlProvider.ps1 parameters

Du kan ange följande parametrar från kommando raden.You can specify the following parameters from the command line. Om du inte gör det, eller om någon parameter validering Miss lyckas, uppmanas du att ange de parametrar som krävs.If you don't, or if any parameter validation fails, you're prompted to provide the required parameters.

ParameternamnParameter name BeskrivningDescription Kommentar eller standardvärdeComment or default value
CloudAdminCredentialCloudAdminCredential Autentiseringsuppgifterna för moln administratören, som krävs för att komma åt den privilegierade slut punkten.The credential for the cloud admin, necessary for accessing the privileged endpoint. ObligatorisktRequired
AzCredentialAzCredential Autentiseringsuppgifterna för administratörs kontot för Azure Stack Hub-tjänsten.The credentials for the Azure Stack Hub service admin account. Använd samma autentiseringsuppgifter som du använde för att distribuera Azure Stack Hub.Use the same credentials that you used for deploying Azure Stack Hub. Skriptet fungerar inte om det konto som du använder med AzCredential kräver Multi-Factor Authentication (MFA).The script will fail if the account you use with AzCredential requires multi-factor authentication (MFA). ObligatorisktRequired
VMLocalCredentialVMLocalCredential Autentiseringsuppgifterna för det lokala administratörs kontot för den virtuella datorns SQL Resource Provider.The credentials for the local admin account of the SQL resource provider VM. ObligatorisktRequired
PrivilegedEndpointPrivilegedEndpoint IP-adressen eller DNS-namnet för den privilegierade slut punkten.The IP address or DNS name of the privileged endpoint. ObligatorisktRequired
AzureEnvironmentAzureEnvironment Azure-miljön för det tjänst administratörs konto som används för att distribuera Azure Stack Hub.The Azure environment of the service admin account used for deploying Azure Stack Hub. Krävs endast för Azure AD-distributioner.Required only for Azure AD deployments. Miljö namn som stöds är AzureCloud, azureusgovernment eller eller om du använder en Kina- AzureChinaCloud i Azure AD.Supported environment names are AzureCloud, AzureUSGovernment, or if using a China Azure AD, AzureChinaCloud. AzureCloudAzureCloud
DependencyFilesLocalPathDependencyFilesLocalPath För integrerade system måste din Certificate. pfx-fil placeras i den här katalogen.For integrated systems only, your certificate .pfx file must be placed in this directory. Du kan också kopiera ett Windows Update MSU-paket här.You can optionally copy one Windows Update MSU package here. Valfritt (obligatoriskt för integrerade system)Optional (mandatory for integrated systems)
DefaultSSLCertificatePasswordDefaultSSLCertificatePassword Lösen ordet för PFX-certifikatet.The password for the .pfx certificate. ObligatorisktRequired
MaxRetryCountMaxRetryCount Antalet gånger som du vill försöka utföra varje åtgärd om det uppstår ett fel.The number of times you want to retry each operation if there's a failure. 22
RetryDurationRetryDuration Tids gräns intervallet mellan återförsök, i sekunder.The timeout interval between retries, in seconds. 120120
AvinstalleraUninstall Tar bort resurs leverantören och alla tillhör ande resurser (se följande anteckningar).Removes the resource provider and all associated resources (see the following notes). IngaNo
DebugModeDebugMode Förhindrar automatisk rensning vid haverining.Prevents automatic cleanup on failure. IngaNo

Distribuera SQL-resurs-providern med hjälp av ett anpassat skriptDeploy the SQL resource provider using a custom script

Om du distribuerar SQL Resource Provider-versionen 1.1.33.0 eller tidigare versioner måste du installera vissa versioner av AzureRm. start program och Azure Stack Hub-moduler i PowerShell.If you're deploying the SQL resource provider version 1.1.33.0 or previous versions, you need to install specific versions of AzureRm.BootStrapper and Azure Stack Hub modules in PowerShell. Om du distribuerar SQL Resource Provider version 1.1.47.0 eller senare hämtas och installeras de nödvändiga PowerShell-modulerna automatiskt för sökvägen C:\Program Files\SqlMySqlPsh.If you're deploying the SQL resource provider version 1.1.47.0 or later, the deployment script will automatically download and install the necessary PowerShell modules for you to path 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

Anteckning

I frånkopplat scenario måste du hämta de PowerShell-moduler som krävs och registrera lagrings platsen manuellt som en förutsättning.In disconnected scenario, you need to download the required PowerShell modules and register the repository manually as a prerequisite.

Du kan anpassa följande skript om du vill ta bort en manuell konfiguration när du distribuerar resurs leverantören.To eliminate any manual configuration when deploying the resource provider, you can customize the following script. Ändra standard konto informationen och lösen orden efter behov för din Azure Stack hubb-distribution.Change the default account information and passwords as needed for your Azure Stack Hub deployment.

# 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

När installations skriptet för resurs leverantören har slutförts uppdaterar du webbläsaren för att se till att du kan se de senaste uppdateringarna och stänger den aktuella PowerShell-sessionen.When the resource provider installation script finishes, refresh your browser to make sure you can see the latest updates and close the current PowerShell session.

Verifiera distributionen med hjälp av Azure Stack Hub-portalenVerify the deployment using the Azure Stack Hub portal

  1. Logga in på administratörs portalen som tjänst administratör.Sign in to the administrator portal as the service admin.
  2. Välj Resursgrupper.Select Resource Groups.
  3. Välj system. <location> .. resurs grupp för sqladapter.Select the system.<location>.sqladapter resource group.
  4. På sidan Sammanfattning för resurs grupps översikt ska det inte finnas några misslyckade distributioner.On the summary page for Resource group Overview, there should be no failed deployments.
  5. Slutligen väljer du virtuella datorer i administratörs portalen för att kontrol lera att den virtuella datorn SQL Resource provider har skapats och körs.Finally, select Virtual machines in the administrator portal to verify that the SQL resource provider VM was successfully created and is running.

Nästa stegNext steps

Lägg till värd servrarAdd hosting servers