Nasazení poskytovatele SQL Server prostředků na Azure Stack Hub

Důležité

Od Azure Stack Hub buildu 2108 se poskytovatelé prostředků SQL a MySQL nabízejí pro předplatná, která mají udělený přístup. Pokud chcete tuto funkci začít používat nebo pokud potřebujete upgradovat z předchozí verze, otevřete případ podpory a naši technici podpory vás provede procesem nasazení nebo upgradu.

Pomocí poskytovatele Azure Stack Hub SQL Server prostředků zpřístupňujete SQL databáze jako Azure Stack Hub službu.

Poskytovatel SQL prostředků běží jako služba na virtuálním počítači Windows Server 2016 Server Core.

Poskytovatel SQL prostředků běží jako služba na speciálním doplňku RP Windows Serveru.

Důležité

Pouze poskytovatel prostředků by měl vytvářet položky na serverech, které hostí SQL nebo MySQL. Položky vytvořené na hostitelském serveru, které nejsou vytvořené poskytovatelem prostředků, nejsou podporovány a mohou vést k neshodě stavu.

Požadavky

Pokud jste už poskytovatele prostředků nainstalovali, pravděpodobně jste dokončili následující požadavky a tuto část můžete přeskočit. V opačném případě proveďte následující kroky, než budete pokračovat:

  1. Pokud jste Azure Stack Hub, zaregistrujtesvou instanci služby v Azure. Tento krok je nutný, protože se budete připojovat k položkám z Azure a stahovat je z Azure na Marketplace.

  2. Pokud ještě nevíte, jak na portálu pro správu Azure Stack Hub Marketplace, prohlédněte si stažení položek z Marketplace z Azure a publikování do Azure Stack Hub. Tento článek vás provede procesem stahování položek z Azure do Azure Stack Hub Marketplace. Popisuje připojené i odpojené scénáře. Pokud je Azure Stack Hub instance odpojená nebo částečně připojená, musí být v rámci přípravy na instalaci splněny další požadavky.

  3. Aktualizujte domovský Azure Active Directory (Azure AD). Od sestavení 1910 musí být v tenantovi domovského adresáře zaregistrovaná nová aplikace. Tato aplikace umožní Azure Stack Hub úspěšně vytvořit a zaregistrovat novější poskytovatele prostředků (například Event Hubs a další) ve vašem tenantovi Azure AD. Jedná se o jednou akci, kterou je potřeba provést po upgradu na build 1910 nebo novější. Pokud se tento krok nedokončí, instalace poskytovatele prostředků marketplace se nezdaří.

SQL Server poskytovatele prostředků

  • Budete potřebovat počítač a účet, které mají přístup k:

    • na Azure Stack Hub správce systému.
    • privilegovaný koncový bod SQL Server (potřebný jenom v případě, že nasazujete poskytovatele prostředků V1 nebo upgradujete z poskytovatele prostředků SQL Server V1 na poskytovatele prostředků V1 SQL Server poskytovatele prostředků V2).
    • koncový Azure Resource Manager správce, https://adminmanagement.region.<fqdn> , kde je plně kvalifikovaný název <fqdn> domény.
    • na internetu, pokud Azure Stack Hub váš účet, aby Azure Active Directory (Azure AD) jako zprostředkovatele identity.
  • Stáhněte si podporovanou verzi SQL poskytovatele prostředků podle tabulky mapování verzí níže. V případě poskytovatele SQL prostředků V2 stáhněte položku marketplace do Azure Stack Hub.

    Podporovaná Azure Stack Hub verze SQL verze RP Windows server, na který běží služba rp
    2108 SQL RP verze 2.0.6.x Microsoft AzureStack Add-on RP Windows Server 1.2009.0
    2108, 2102, 2008, 2005 SQL RP verze 1.1.93.5 Microsoft AzureStack Add-on RP Windows Server
  • Ujistěte se, že se Windows požadovaný virtuální počítač se serverem a Azure Stack Hub Marketplace. V případě potřeby si image stáhněte ručně podle výše uvedené tabulky mapování verzí.

  • Ujistěte se, že jsou splněné požadavky na integraci datacentra:

    Požadavek Reference
    Podmíněné předávání DNS je správně nastavené. Azure Stack Hub datacentra – DNS
    Příchozí porty pro poskytovatele prostředků jsou otevřené. Azure Stack Hub datacentra – Příchozí porty a protokoly
    Předmět certifikátu PKI a san jsou správně nastavené. Azure Stack Hub požadované součásti infrastruktury veřejných klíčů pro nasazení
    Azure Stack Hub požadavků na certifikát PaaS pro nasazení
  • Připravte certifikát. (Pouze pro instalace integrovaných systémů.)

    • Je nutné zadat certifikát PKI SQL PaaS popsaný v části volitelné certifikáty PaaS v Azure Stack Hub pki nasazení. Alternativní název subjektu (SAN) musí splňovat následující vzor pojmenování: CN=*.dbadapter. < oblast > . < fqdn > s chráněným heslem. Screenshot of marketplace management downloaded packages.
    • Při nasazování SQL Server prostředků V1 umístěte soubor .pfx do umístění určeného parametrem DependencyFilesLocalPath. Nezadáte certifikát pro systémy ASDK.
    • Při nasazování SQL Server poskytovatele prostředků V2 připravte certifikát pro následující kroky instalace.

Odpojený scénář

Při nasazování poskytovatele prostředků SQL Server V2 v odpojeném scénáři postupujte podle pokynů ke stažení položek marketplace Azure Stack Hub stáhněte položku poskytovatele prostředků SQL Server SQL Server položku Add-on RP Windows Server do vašeho Azure Stack Hub prostředí.

Při nasazování SQL Server poskytovatele prostředků V1 v odpojené situaci si pomocí následujících kroků stáhněte požadované moduly PowerShellu a zaregistrujte úložiště ručně.

  1. Přihlaste se k počítači s připojením k internetu a pomocí následujících skriptů stáhněte moduly PowerShellu.

    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. V závislosti na verzi poskytovatele prostředků, kterou nasazujete, spusťte jeden ze skriptů.

    # 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. Stažené balíčky pak zkopírujete na zařízení USB.

  4. Přihlaste se k odpojené pracovní stanici a zkopírujte balíčky ze zařízení USB do umístění na pracovní stanici.

  5. Zaregistrujte toto umístění jako místní úložiště.

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

Nasazení poskytovatele SQL prostředků V2

Pokud upgradujete z verze V1, přečtěte si dokumentaci Aktualizace poskytovatele prostředků SQL Server prostředků.

Spuštění instalace

  1. Pokud jste to ještě neudělali, přihlaste se k portálu Azure Stack Hub správce, na levé straně vyberte Správa Marketplace a vyberte Poskytovatelé prostředků.

  2. Po SQL poskytovatele prostředků a jiného požadovaného softwaru se ve správě Marketplace zobrazí balíčky poskytovatele prostředků SQL Server se stavem Nenainstalované. Mohou se zobrazit i další balíčky se stavem Staženo. Screenshot of marketplace management before installing the RP.

  3. Vyberte řádek, který chcete nainstalovat. Na SQL Server instalačního balíčku poskytovatele prostředků se v horní části zobrazuje modrý banner. Výběrem banneru spusťte instalaci. Screenshot of marketplace management begin install.

Požadavky na instalaci

  1. Potom se přenesete na stránku instalace. Výběrem možnosti Install Prerequisites (Nainstalovat požadavky) zahajte proces instalace. Screenshot of marketplace management install prerequisites.

  2. Počkejte na úspěšné dokončení instalace požadavků. Než budete pokračovat k dalšímu kroku, měli byste vedle instalovat požadavky vidět zelené zaškrtnutí. Screenshot of marketplace management install prerequisites succeeded.

Příprava tajných kódů

  1. Pod položkou 2. Připravte tajný krok, vyberte Přidat certifikáta zobrazí se panel Přidat certifikát. Screenshot of marketplace management prepare secrets.

  2. Vyberte tlačítko Procházet u možnosti Přidat certifikátnapravo od pole názvu souboru certifikátu. Vyberte soubor certifikátu .pfx, který jste si při dokončování požadavků poř vytyčovali.

  3. Zadejte heslo, které jste poskytli k vytvoření zabezpečeného řetězce pro certifikát SSL SQL Server poskytovatele prostředků. Pak vyberte Přidat. Screenshot of marketplace management add certificate.

Instalace poskytovatele prostředků

  1. Pokud instalace certifikátu proběhne úspěšně, měla by se vedle možnosti Připravit tajné kódy zobrazit zelená značka zaškrtnutí, než budete pokračovat k dalšímu kroku. Teď vyberte tlačítko Install (Nainstalovat) vedle 3 Install resource provider (Nainstalovat poskytovatele prostředků). Screenshot of marketplace management start RP install.

  2. V dalším kroku se zobrazí následující stránka, která označuje, SQL instaluje poskytovatel prostředků. Screenshot of marketplace management RP installing.

  3. Počkejte na oznámení o dokončení instalace. Tento proces obvykle trvá jednu nebo více hodin v závislosti na Azure Stack Hub typu. Screenshot of marketplace management RP install in progress.

  4. Ověřte, že instalace poskytovatele SQL Server prostředků proběhla úspěšně, a to tak, že se vrátíte na stránku Správa Marketplacea Poskytovatelé prostředků. Stav poskytovatele prostředků SQL Server stav Nainstalováno. Screenshot of marketplace management RP installed.

Nasazení poskytovatele SQL prostředků V1

Po dokončení všech požadavků spusťte samo extractor, který extrahuje stažený instalační balíček do dočasného adresáře. Spusťte skript DeploySqlProvider.ps1 z počítače, který má přístup ke koncovému bodu správce Azure Stack Hub Azure Resource Manager a privilegovaný koncový bod, a nasaďte SQL poskytovatele prostředků. Tento DeploySqlProvider.ps1 se extrahuje jako součást binárního souboru poskytovatele SQL prostředků, který jste stáhli pro vaši verzi Azure Stack Hub.

Důležité

Před nasazením poskytovatele prostředků si přečtěte poznámky k verzi a seznamte se s novými funkcemi, opravami a známými problémy, které by mohly mít vliv na vaše nasazení.

Pokud chcete nasadit poskytovatele SQL prostředků, otevřete nové okno PowerShellu se zvýšenými oprávněními (ne ISE PowerShellu) a změňte na adresář, do SQL binární soubory poskytovatele prostředků.

Důležité

Před spuštěním skriptu pro nasazení nebo aktualizaci důrazně doporučujeme použít Clear-AzureRmContext -Scope CurrentUser a Clear-AzureRmContext -Scope Process a vymazat mezipaměť.

Spusťte DeploySqlProvider.ps1, který dokončí následující úlohy:

  • Nahraje certifikáty a další artefakty do účtu úložiště na Azure Stack Hub.
  • Publikuje balíčky galerie, abyste mohli SQL databáze pomocí galerie.
  • Publikuje balíček galerie pro nasazení hostitelských serverů.
  • Nasadí virtuální počítač pomocí image jádra Windows Server 2016 nebo image Windows Serveru poskytovatele prostředků Microsoft AzureStack Add-on, kterou jste stáhli, a pak nainstaluje SQL poskytovatele prostředků.
  • Zaregistruje místní záznam DNS, který se mapuje na virtuální počítač poskytovatele prostředků.
  • Zaregistruje poskytovatele prostředků v místním Azure Resource Manager účtu operátora.

Poznámka

Při SQL poskytovatele prostředků se vytvoří skupina prostředků system.local.sqladapter. Dokončení požadovaných nasazení do této skupiny prostředků může trvat až 75 minut. Do skupiny prostředků system.local.sqladapter byste neměli umístit žádné jiné prostředky.

DeploySqlProvider.ps1 parametry

Z příkazového řádku můžete zadat následující parametry. Pokud ne nebo pokud se některý parametr nepodaří, zobrazí se výzva k zadání požadovaných parametrů.

Název parametru Description Komentář nebo výchozí hodnota
Přihlašovací údaje správce cloudu Přihlašovací údaje správce cloudu, které jsou nezbytné pro přístup k privilegovaného koncovému bodu. Povinné
AzCredential Přihlašovací údaje pro účet Azure Stack Hub služby. Použijte stejné přihlašovací údaje, které jste použili k nasazení Azure Stack Hub. Skript selže, pokud účet, který používáte s AzCredential, vyžaduje vícefaktorové ověřování (MFA). Povinné
VMLocalCredential Přihlašovací údaje pro účet místního správce virtuálního počítače SQL poskytovatele prostředků. Povinné
PrivilegedEndpoint IP adresa nebo název DNS privilegovaného koncového bodu. Povinné
AzureEnvironment Prostředí Azure účtu správce služby použitého k nasazení Azure Stack Hub. Vyžaduje se jenom pro nasazení Azure AD. Podporované názvy prostředí jsou AzureCloud,AzureUSGovernmentnebo pokud používáte službu Azure AD pro Čínu nebo AzureChinaCloud. AzureCloud
DependencyFilesLocalPath Pouze pro integrované systémy musí být soubor .pfx certifikátu umístěn v tomto adresáři. Volitelně můžete zkopírovat jeden balíček msu Windows aktualizaci msu. Volitelné(povinné pro integrované systémy)
DefaultSSLCertificatePassword Heslo pro certifikát .pfx. Povinné
MaxRetryCount Kolikrát chcete každou operaci zopakovat, pokud dojde k selhání 2
RetryDuration (Trvání opakování) Časový limit mezi opakováními (v sekundách) 120
Odinstalace Odebere poskytovatele prostředků a všechny přidružené prostředky (viz následující poznámky). No
DebugMode (Režim ladění) Zabraňuje automatickému vyčištění při selhání. No

Nasazení poskytovatele SQL prostředků pomocí vlastního skriptu

Pokud nasazujete poskytovatele prostředků SQL verze 1.1.33.0 nebo předchozí verze, musíte v PowerShellu nainstalovat konkrétní verze modulů AzureRm.BootStrapper a Azure Stack Hub.

Pokud nasazujete poskytovatele prostředků SQL verze 1.1.47.0 nebo novější, skript nasazení automaticky stáhne a nainstaluje potřebné moduly PowerShellu pro cestu 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

Poznámka

V odpojené situaci si musíte stáhnout požadované moduly PowerShellu a zaregistrovat úložiště ručně jako předpoklad.

Pokud chcete eliminovat jakoukoli ruční konfiguraci při nasazování poskytovatele prostředků, můžete přizpůsobit následující skript. Změňte výchozí informace o účtu a hesla podle potřeby pro Azure Stack Hub nasazení.

# 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

Po dokončení instalačního skriptu poskytovatele prostředků aktualizujte prohlížeč, abyste měli jistotu, že vidíte nejnovější aktualizace, a ukončete aktuální relaci PowerShellu.

Ověření nasazení V1 pomocí Azure Stack Hub Portal

  1. Přihlaste se k portálu pro správu jako správce služby.
  2. Vyberte Skupiny prostředků.
  3. Vyberte systém. umístění > skupiny prostředků .sqladapter.
  4. Na stránce souhrnu přehledu skupiny prostředků by neměla být žádná neúspěšná nasazení.
  5. Nakonec na portálu pro správu vyberte Virtuální počítače, abyste ověřili, SQL virtuální počítač poskytovatele prostředků poskytovatele prostředků úspěšně vytvořil a je spuštěný.

Důležitá konfigurace pro Azure AD

Pokud váš Azure Stack Hub jako zprostředkovatele identity používá Azure AD, ujistěte se, že virtuální počítač, na SQL Server má odchozí připojení k internetu.

Pokud potřebujete získat IP adresu virtuálního počítače s nainstalovaným poskytovatelem prostředků SQL Server (tj. přidat IP adresu do seznamu povolených adres brány firewall), musíte otevřít případ podpory a nechte technika podpory, aby předplatné poskytovatele prostředků SQL Server dočasně zviditelnit. Pak můžete virtuální počítač vyhledat v předplatném a získat jeho IP adresu.

Další kroky

Přidání hostitelských serverů