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

Důležité

Počínaje buildem Azure Stack Hub 2108 se poskytovatelé prostředků SQL a MySQL nabízejí předplatným, kterým byl 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 prostředků Serveru MySQL můžete zpřístupnit databáze MySQL jako službu Azure Stack Hub.

Poskytovatel prostředků MySQL běží jako služba na virtuálním počítači s jádrem serveru Windows Server 2016.

Poskytovatel prostředků MySQL běží jako služba na speciálním serveru Windows rp doplňku.

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é poskytovatel prostředků nevytvořil, nejsou podporované a můžou 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 můžete tuto část přeskočit. V opačném případě proveďte tyto kroky před pokračováním:

  1. Pokud jste to neudělali, zaregistrujte si instanci služby Azure Stack Hub v Azure. Tento krok se vyžaduje, protože se budete připojovat k položkám a stahovat je z Azure.

  2. Pokud neznáte funkci Správa marketplace 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 na 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 provést další požadavky při přípravě na instalaci.

  3. Aktualizujte domovský adresář Azure Active Directory (Azure AD). Od buildu 1910 musí být nová aplikace zaregistrovaná ve vašem 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 jsou Event Hubs a další) s vaším tenantem Azure AD. Jedná se o jednorázovou akci, kterou je potřeba provést po upgradu na build 1910 nebo novější. Pokud tento krok není dokončený, instalace poskytovatele prostředků marketplace selžou.

Požadavky poskytovatele prostředků Serveru MySQL

  • Budete potřebovat počítač a účet, ke kterému máte přístup:

    • portál pro správu služby Azure Stack Hub.
    • privilegovaný koncový bod (potřebný pouze v případě, že nasazujete poskytovatele prostředků Serveru MySQL V1 nebo upgradujete z poskytovatele prostředků Serveru MySQL V1 na poskytovatele prostředků Serveru MySQL V2).
    • koncový bod správce Azure Resource Manager, https://adminmanagement.region.<fqdn>kde <fqdn> je váš plně kvalifikovaný název domény.
    • Internet, pokud jste službu Azure Stack Hub nasadili pro použití Azure Active Directory (Azure AD) jako zprostředkovatele identity.
  • Stáhněte si podporovanou verzi binárního souboru poskytovatele prostředků MySQL podle níže uvedené tabulky mapování verzí. Pro poskytovatele prostředků V2 MySQL stáhněte položku marketplace do služby Azure Stack Hub.

    Podporovaná verze služby Azure Stack Hub Verze rp mySQL Windows Server, na kterém běží služba RP
    2108 Rp MySQL verze 2.0.6.x Doplněk Microsoft AzureStack RP Windows Server 1.2009.0
    2108, 2102, 2008, 2005 Rp MySQL verze 1.1.93.5 Microsoft AzureStack Add-on RP Windows Server
  • Ujistěte se, že se požadovaný virtuální počítač Windows Serveru stáhne na Azure Stack Hub Marketplace. Obrázek si podle výše uvedené tabulky mapování verzí podle potřeby stáhněte ručně.

  • 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 služby Azure Stack Hub – DNS
    Příchozí porty pro poskytovatele prostředků jsou otevřené. Integrace datacentra služby Azure Stack Hub – Publikování koncových bodů
    Subjekt certifikátu PKI a síť SAN jsou správně nastavené. Povinné nasazení služby Azure Stack Hub s požadavky nanasazení PaaS pro nasazení PKIAzure Stack Hub
  • Připravte certifikát. (Pouze pro instalace integrovaných systémů.)

    • Musíte zadat SQL certifikát PKI PaaS popsaný v části volitelné certifikáty PaaS požadavků na pkI nasazení služby Azure Stack Hub. Alternativní název subjektu (SAN) musí dodržovat následující vzor pojmenování: CN=*.dbadapter.< oblast>.< plně kvalifikovaný název domény> s heslem chráněným heslem. Screenshot of the certificate.
    • Při nasazování zprostředkovatele 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í zprostředkovatele prostředků Serveru MySQL V2 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 marketplace do služby Azure Stack Hub a stáhněte položku poskytovatele prostředků Serveru MySQL a položku serveru doplňku Windows Server do prostředí Služby Azure Stack Hub.

Při nasazování zprostředkovatele prostředků Serveru MySQL V1 v odpojené situaci si 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ů si 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ů, kterého 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 zkopírujete stažené balíčky 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 V2

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

Spuštění instalace

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

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

    Screenshot of marketplace management before installing the RP.

  3. Vyberte řádek, který chcete nainstalovat. Na stránce s balíčkem instalace poskytovatele prostředků Serveru MySQL se zobrazuje modrý banner v horní části. Výběrem banneru spusťte instalaci. Screenshot of marketplace management begin RP installation.

Požadavky na instalaci

  1. Pak se přenesete na stránku instalace. Výběrem možnosti Nainstalovat požadavky zahájíte proces instalace. Screenshot of marketplace management install prerequisites.

  2. Počkejte, až instalace požadavků proběhne úspěšně. Před pokračováním k dalšímu kroku by se měla zobrazit zelená značka zaškrtnutí vedle instalace požadovaných součástí . Screenshot of marketplace management install prerequisites succeeded.

Příprava tajných kódů

  1. Pod 2. Připravte krok tajných kódů , vyberte Přidat certifikát a zobrazí se panel Přidat certifikát . Screenshot of marketplace management prepare secrets.

  2. Vyberte tlačítko procházet v části Přidat certifikát, přímo napravo od pole název souboru certifikátu. Při dokončení požadavků vyberte soubor certifikátu .pfx, který jste si vybrali.

  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. Screenshot of marketplace management add certificate.

Konfigurace a instalace poskytovatele prostředků

  1. Pokud instalace certifikátu proběhne úspěšně, měli byste před pokračováním k dalšímu kroku vidět zelenou značku zaškrtnutí vedle možnosti Připravit tajné kódy . Teď vyberte tlačítko Konfigurovat a nainstalovat vedle 3 Instalace poskytovatele prostředků. Screenshot of marketplace management start RP installation.

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

    • Tady si projděte licenci GPL konektoru MySQL a stáhněte si verzi 8.0.21 do místní složky.

    • Vytvořte účet úložiště s vaším výchozím předplatným operátora a vytvořte kontejner s úrovní přístupu Blob nebo Kontejner. Screenshot oof creating a storage account.Screenshot of creating a storage container.

    • Upload soubor mysql-connector-net-8.0.21.msi z místní složky do nově vytvořeného kontejneru úložiště. Screenshot of uploading MySQL Connector to the container.

    • Zkopírujte identifikátor URI objektu blob. Screenshot of copying the MySQL Connector URI.

    • Zpět na stránku konfigurace rp 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) do textového pole a klepněte na tlačítko OK. Screenshot of providing MySQL Connector URI.

  3. Dále uvidíte následující stránku, která označuje, že je nainstalovaný poskytovatel prostředků MySQL. Screenshot of marketplace management RP installing.

  4. Počkejte na dokončení 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. Screenshot of marketplace management RP install in progress.

  5. Ověřte, že instalace poskytovatele prostředků Serveru MySQL byla úspěšná, a to tak, že se vrátíte na stránku Správa Marketplace, poskytovatelé prostředků . Stav poskytovatele prostředků Serveru MySQL by měl zobrazovat "Nainstalováno". Screenshot of marketplace management RP installed.

Nasazení poskytovatele prostředků SQL V1

Po dokončení všech požadavků spusťte samoobslužný extraktor a extrahujte stažený instalační balíček do dočasného adresáře. Spusťte skriptDeployMySqlProvider.ps1 z počítače, který má přístup ke koncovému bodu správce Azure stack hubu Azure Resource Manager i privilegovanému koncovému bodu, a 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 vaši 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 ovlivnit vaše nasazení.

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

Důležité

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

Poznámka

Pokud nasazujete poskytovatele prostředků MySQL Server V1 v odpojeném prostředí, zkopírujte mysql-connector-net-6.10.5.msi soubor 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 nasadit databáze MySQL pomocí galerie.
  • Publikuje balíček galerie pro nasazení hostitelských serverů.
  • Nasadí virtuální počítač pomocí základní image Windows Server 2016 nebo bitové kopie doplňku Microsoft AzureStack Windows Server, 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 poskytovatele prostředků v místním účtu Azure Resource Manager pro účet operátora.

Poznámka

Po spuštění nasazení zprostředkovatele 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 ne, nebo pokud se ověření parametru nezdaří, zobrazí se výzva k zadání požadovaných parametrů.

Název parametru Description Komentář nebo výchozí hodnota
CloudAdminCredential Přihlašovací údaje pro správce cloudu 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žívaného k nasazení služby Azure Stack Hub. Vyžaduje se jenom pro nasazení Azure AD. Podporované názvy prostředí jsou AzureCloud, AzureUSGovernment nebo pokud používáte Azure AD v Číně, AzureChinaCloud. AzureCloud
DependencyFilesLocalPath V případě pouze integrovaných systémů 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 služba Windows Update balíček MSU. Volitelné (povinné pro integrované systémy nebo odpojená prostředí)
DefaultSSLCertificatePassword Heslo pro certifikát .pfx. Povinné
MaxRetryCount Počet opakování jednotlivých operací, pokud dojde k selhání. 2
OpakováníDuration Interval časového limitu mezi opakovanými pokusy 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 Zabrání automatickému vyčištění při selhání. No
AcceptLicense 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.33.0 nebo předchozí verze, musíte do PowerShellu nainstalovat konkrétní verze modulů AzureRm.BootStrapper a Azure Stack Hub.

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ých scénářích musíte stáhnout požadované moduly PowerShellu a ručně zaregistrovat úložiště jako předpoklad.

Pokud chcete odstranit jakoukoli ruční konfiguraci při nasazování poskytovatele prostředků, můžete přizpůsobit následující skript. Podle potřeby změňte výchozí informace o účtu a hesla 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.< location.mysqladapter> – skupina prostředků.
  4. Na stránce souhrnu skupiny prostředků – Přehled 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 , abyste ověřili, že byl virtuální počítač poskytovatele prostředků MySQL úspěšně vytvořen a spuštěný.

Důležitá konfigurace pro Azure AD

Pokud vaše služba Azure Stack Hub používá Azure AD 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 pro bránu firewall), musíte otevřít případ podpory a mít pracovníka podpory, aby se předplatné poskytovatele prostředků MySQL Serveru dočasně zviditelňovalo. 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ů