Nasazení poskytovatele prostředků MySQL ve službě Azure Stack Hub

Důležité

Od buildu 2108 služby Azure Stack Hub jsou poskytovatelé prostředků SQL a MySQL nabízeni 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 provedou procesem nasazení nebo upgradu.

Pomocí poskytovatele prostředků Serveru MySQL zpřístupňujte databáze MySQL jako službu Azure Stack Hub.

Poskytovatel prostředků MySQL běží jako služba na speciálním zprostředkovateli prostředků pro Windows Server.

Důležité

Pouze poskytovatel prostředků by měl vytvářet položky na serverech, které hostují SQL nebo MySQL. Položky vytvořené na hostitelském serveru, které nejsou vytvořené poskytovatelem prostředků, nejsou podporované a můžou mít za následek neshodný stav.

Požadavky

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

1. Pokud jste to ještě neudělali, zaregistrujte svou instanci služby Azure Stack Hub v Azure. Tento krok je povinný, protože se budete připojovat k marketplace a stahovat položky z Azure.

2. Pokud neznáte funkci správy Marketplace na portálu pro správu služby Azure Stack Hub, přečtěte si téma Stažení položek z marketplace z Azure a publikování do služby Azure Stack Hub. Tento článek vás provede procesem stahování položek z Azure do marketplace služby Azure Stack Hub. Týká se připojených i odpojených scénářů. Pokud je vaše instance služby Azure Stack Hub odpojená nebo částečně připojená, je potřeba při přípravě na instalaci splnit další požadavky.

3. Aktualizujte domovský adresář Microsoft Entra. Od buildu 1910 musí být nová aplikace zaregistrovaná v tenantovi domovského adresáře. Tato aplikace umožní službě Azure Stack Hub úspěšně vytvářet a registrovat novější poskytovatele prostředků (jako je Event Hubs a další) ve vašem tenantovi Microsoft Entra. Jedná se o jednorázovou 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 selžou.

   • Po úspěšné aktualizaci instance služby Azure Stack Hub na verzi 1910 nebo vyšší postupujte podle pokynů ke klonování nebo stažení úložiště Azure Stack Hub Tools.
   • Pak postupujte podle pokynů k aktualizaci domovského adresáře služby Azure Stack Hub Microsoft Entra (po instalaci aktualizací nebo nových poskytovatelů prostředků).

Požadavky na poskytovatele prostředků MySQL Serveru

• Budete potřebovat počítač a účet, který má přístup k:

  • portál pro správu služby Azure Stack Hub.
  • privilegovaný koncový bod (potřeba pouze při nasazování poskytovatele prostředků Serveru MySQL verze 1 nebo při upgradu z poskytovatele prostředků Serveru MySQL verze 1 na poskytovatele prostředků Serveru MySQL verze 2).
  • koncový bod správce Azure Resource Manager , https://adminmanagement.region.<fqdn>kde <fqdn> je plně kvalifikovaný název domény.
  • internet, pokud jste službu Azure Stack Hub nasadili tak, aby jako zprostředkovatele identity používali Microsoft Entra ID.

• Stáhněte si podporovanou verzi binárního souboru poskytovatele prostředků MySQL podle následující tabulky mapování verzí. V případě poskytovatele prostředků v2 MySQL si stáhněte položku marketplace do služby Azure Stack Hub.

  Podporovaná verze služby Azure Stack Hub	Verze MySQL RP	Windows Server, na kterém běží služba RP
  2206, 2301, 2306, 2311	MySQL RP verze 2.0.13.x	Doplněk Microsoft AzureStack RP pro Windows Server 1.2009.0
  2108, 2206	MySQL RP verze 2.0.6.x	Doplněk Microsoft AzureStack RP pro Windows Server 1.2009.0

• Ujistěte se, že se požadovaný virtuální počítač s Windows Serverem stáhl na Marketplace služby Azure Stack Hub. V případě potřeby si obrázek 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:R

  Požadavek	Reference
  Podmíněné předávání DNS je správně nastavené.	Integrace datacentra Azure Stack Hubu – DNS
  Příchozí porty pro poskytovatele prostředků jsou otevřené.	Integrace datacentra Azure Stack Hubu – Publikování koncových bodů
  Subjekt certifikátu PKI a síť SAN jsou správně nastavené.	Povinné požadavky na nasazení služby Azure Stack Hub – požadavky na certifikáty PaaS pro nasazení služby Azure Stack Hub

• Připravte certifikát. (Pouze pro instalace integrovaných systémů.)

  • Musíte zadat certifikát PKI SQL PaaS popsaný v části Volitelné certifikáty PaaS v požadavcích na infrastrukturu veřejných klíčů nasazení služby Azure Stack Hub. Alternativní název subjektu (SAN) musí odpovídat následujícímu vzoru pojmenování: CN=*.dbadapter.<oblast>.<plně kvalifikovaný název domény> s heslem chráněným heslem.
  • Při nasazování poskytovatele prostředků Serveru MySQL V1 umístěte soubor .pfx do umístění určeného parametrem DependencyFilesLocalPath . Nezadávejte certifikát pro systémy ASDK.
  • Při nasazování poskytovatele prostředků Serveru MySQL verze 2 připravte certifikát na následující kroky instalace.

Odpojený scénář

Při nasazování poskytovatele prostředků Serveru MySQL V2 v odpojené situaci postupujte podle pokynů ke stažení položek z marketplace do služby Azure Stack Hub a stáhněte si do prostředí služby Azure Stack Hub položku poskytovatele prostředků Serveru MySQL a položku doplňku RP Windows Serveru.

Při nasazování poskytovatele prostředků MySQL Serveru V1 v odpojené situaci proveďte následující kroky a stáhněte si 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. Pak stažené balíčky zkopírujete do 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 prostředků MySQL verze 2

Pokud upgradujete z verze V1, projděte si dokument Aktualizace poskytovatele prostředků Serveru MySQL.

Spustit instalaci

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

2. Po stažení poskytovatele prostředků MySQL a dalšího požadovaného softwaru zobrazí správa Marketplace balíčky poskytovatele prostředků serveru MySQL se stavem Nenainstalováno. Mohou existovat další balíčky, které zobrazují stav "Staženo".

   

3. Vyberte řádek, který chcete nainstalovat. Na stránce instalačního balíčku poskytovatele prostředků Serveru MySQL se nahoře zobrazuje modrý nápis. Výběrem banneru spusťte instalaci.

Požadavky na instalaci

1. Pak se přenesete na stránku instalace. Výběrem možnosti Nainstalovat požadované součásti zahajte proces instalace.

2. Počkejte, až instalace požadavků proběhne úspěšně. Než budete pokračovat k dalšímu kroku, měli byste u položky Instalace předpokladů vidět zelené zaškrtnutí.

Příprava tajných kódů

1. Pod 2. Krok příprava tajných kódů , vyberte Přidat certifikát a zobrazí se panel Přidat certifikát .

2. Vpravo od pole název certifikátu vyberte tlačítko pro procházení přidat certifikát. Vyberte soubor certifikátu .pfx, který jste si pořídit při plnění požadavků.

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

Konfigurace a instalace poskytovatele prostředků

1. Když instalace certifikátu proběhne úspěšně, měli byste před pokračováním k dalšímu kroku vidět zelené zaškrtnutí vedle možnosti Připravit tajné kódy . Teď vyberte tlačítko Konfigurovat a nainstalovat vedle možnosti 3 Nainstalovat poskytovatele prostředků.

2. Dále budete muset zadat identifikátor URI objektu blob služby Azure Stack Hub pro konektor MySQL.

   • Přečtěte si licenci GPL konektoru MySQL a stáhněte si verzi 8.0.21 do místní složky.

   • Create účet úložiště s výchozím předplatným operátora a vytvořte kontejner s úrovní přístupu Blob nebo Container.

   • Nahrajte soubor mysql-connector-net-8.0.21.msi z místní složky do nově vytvořeného kontejneru úložiště.

   Důležité

   Ujistěte se, že je verze konektoru MySQL 8.0.21.

   • Zkopírujte identifikátor URI objektu blob.

   • Zpět na stránku konfigurace poskytovatele prostředků MySQL. Vložte identifikátor URI objektu blob (např. https://< storageAccountName.blob>.<oblast>.<Plně kvalifikovaný název domény>/<název_>kontejneru/mysql-connector-net-8.0.21.msi) přejděte do textového pole a klikněte na OK.

3. Dále se zobrazí následující stránka, která uvádí, že se instaluje poskytovatel prostředků MySQL.

4. Počkejte na oznámení o dokončení instalace. Tento proces obvykle trvá jednu nebo více hodin v závislosti na typu služby Azure Stack Hub.

5. Vraťte se na stránku Správa Marketplace, Poskytovatelé prostředků a ověřte, že instalace poskytovatele prostředků MySQL Serveru proběhla úspěšně. Ve stavu poskytovatele prostředků MySQL Serveru by se měl zobrazovat stav Nainstalováno.

Nasazení poskytovatele prostředků SQL V1

Po dokončení všech požadavků spusťte samoextrahovač, který extrahuje stažený instalační balíček do dočasného adresáře. Spuštěním DeployMySqlProvider.ps1 skriptu z počítače, který má přístup ke koncovému bodu správce Azure Resource Manager Azure Stack Hub i k privilegovanému koncovému bodu, nasaďte poskytovatele prostředků MySQL. Skript DeployMySqlProvider.ps1 se extrahuje jako součást instalačních souborů poskytovatele prostředků MySQL, které jste stáhli pro svou verzi služby Azure Stack Hub.

Důležité

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

Pokud chcete nasadit poskytovatele prostředků MySQL, otevřete nové okno PowerShellu se zvýšenými oprávněními (nikoli Integrované skriptované prostředí (ISE) PowerShellu) a přejděte do adresáře, do kterého jste extrahovali binární soubory poskytovatele prostředků MySQL.

Důležité

K vymazání mezipaměti před spuštěním skriptu nasazení nebo aktualizace důrazně doporučujeme použít rutiny Clear-AzureRmContext -Scope CurrentUser a Clear-AzureRmContext -Scope Process .

Poznámka

Pokud nasazujete poskytovatele prostředků MySQL Serveru V1 v odpojeném prostředí, zkopírujte soubormysql-connector-net-6.10.5.msi do místní cesty. Zadejte název cesty pomocí parametru DependencyFilesLocalPath .

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

• Nahraje certifikáty a další artefakty do účtu úložiště ve službě Azure Stack Hub.
• Publikuje balíčky galerie, abyste mohli nasazovat databáze MySQL pomocí galerie.
• Publikuje balíček galerie pro nasazení hostitelských serverů.
• Nasadí virtuální počítač pomocí Windows Server 2016 základní image nebo image doplňku Microsoft AzureStack s Windows Serverem, kterou jste stáhli, a pak nainstaluje poskytovatele prostředků MySQL.
• Zaregistruje místní záznam DNS, který se mapuje na virtuální počítač poskytovatele prostředků.
• Zaregistruje vašeho poskytovatele prostředků do místního Resource Manager Azure pro účet operátora.

Poznámka

Při spuštění nasazení poskytovatele prostředků MySQL se vytvoří skupina prostředků system.local.mysqladapter . Dokončení nasazení vyžadovaných pro tuto skupinu prostředků může trvat až 75 minut. Do skupiny prostředků system.local.mysqladapter byste neměli umístit žádné další prostředky.

parametry DeployMySqlProvider.ps1

Tyto parametry můžete zadat z příkazového řádku. Pokud to neuděláte nebo pokud se ověření některého parametru nezdaří, 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 pro správce cloudu, které jsou nezbytné pro přístup k privilegovanému koncovému bodu.	Povinné
AzCredential	Přihlašovací údaje pro účet správce služby Azure Stack Hub. Použijte stejné přihlašovací údaje, které jste použili k nasazení služby 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 poskytovatele prostředků MySQL.	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í služby Azure Stack Hub. Vyžaduje se pouze pro nasazení Microsoft Entra. Podporované názvy prostředí jsou AzureCloud, AzureUSGovernment, nebo pokud používáte čínský Microsoft Entra ID, AzureChinaCloud.	AzureCloud
DependencyFilesLocalPath	Pouze pro integrované systémy musí být soubor .pfx certifikátu umístěn v tomto adresáři. V případě odpojených prostředí stáhněte mysql-connector-net-6.10.5.msi do tohoto adresáře. Volitelně můžete zkopírovat jeden balíček msu služba Windows Update sem.	Volitelné (povinné pro integrované systémy nebo odpojená prostředí)
DefaultSSLCertificatePassword	Heslo pro certifikát .pfx.	Povinné
MaxRetryCount	Kolikrát chcete každou operaci opakovat, pokud dojde k selhání.	2
Doba trvání opakování	Interval časového limitu 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
Režim ladění	Zabrání automatickému vyčištění při selhání.	No
Přijmoutlicence	Přeskočí výzvu k přijetí licence GPL. https://www.gnu.org/licenses/old-licenses/gpl-2.0.html

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

Pokud nasazujete poskytovatele prostředků MySQL 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 -Force
Use-AzureRmProfile -Profile 2018-03-01-hybrid -Force
Install-Module -Name AzureStack -RequiredVersion 1.6.0

Poznámka

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

Pokud chcete eliminovat 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 nasazení služby 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 environment names are AzureCloud, AzureUSGovernment, or AzureChinaCloud. 
$AzureEnvironment = "<EnvironmentName>"

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

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

# And the cloudadmin credential 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\DeployMySQLProvider.ps1 `
    -AzCredential $AdminCreds `
    -VMLocalCredential $vmLocalAdminCreds `
    -CloudAdminCredential $cloudAdminCreds `
    -PrivilegedEndpoint $privilegedEndpoint `
    -AzureEnvironment $AzureEnvironment `
    -DefaultSSLCertificatePassword $PfxPass `
    -DependencyFilesLocalPath $tempDir\cert `
    -AcceptLicense

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

Ověření nasazení V1 pomocí portálu Azure Stack Hub

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

Důležitá konfigurace pro Microsoft Entra ID

Pokud vaše služba Azure Stack Hub používá Microsoft Entra ID jako zprostředkovatele identity, ujistěte se, že virtuální počítač s nainstalovaným poskytovatelem prostředků Serveru MySQL má odchozí připojení k internetu.

Pokud je potřeba získat IP adresu virtuálního počítače s nainstalovaným poskytovatelem prostředků Serveru MySQL (tj. přidat IP adresu do seznamu povolených bran firewall), musíte otevřít případ podpory a nechat pracovníka podpory, aby dočasně zviditelňoval předplatné poskytovatele prostředků serveru MySQL. Pak můžete vyhledat virtuální počítač v předplatném a získat jeho IP adresu.

Další kroky

Přidání hostitelských serverů