Distribuera MySQL-resursprovidern på Azure Stack Hub

Viktigt

Från och med Azure Stack Hub build 2108 erbjuds SQL- och MySQL-resursprovidrar till prenumerationer som har beviljats åtkomst. Om du vill börja använda den här funktionen eller om du behöver uppgradera från en tidigare version öppnar du ett supportärende och våra supporttekniker vägleder dig genom distributions- eller uppgraderingsprocessen.

Använd MySQL Server-resursprovidern för att exponera MySQL-databaser som en Azure Stack Hub-tjänst.

MySQL-resursprovidern körs som en tjänst på en särskild RP Windows Server för tillägg.

Viktigt

Endast resursprovidern ska skapa objekt på servrar som är värdar för SQL eller MySQL. Objekt som skapats på en värdserver som inte skapas av resursprovidern stöds inte och kan resultera i ett felmatchat tillstånd.

Förutsättningar

Om du redan har installerat en resursprovider har du förmodligen slutfört följande krav och kan hoppa över det här avsnittet. Annars slutför du de här stegen innan du fortsätter:

1. Registrera din Azure Stack Hub-instans med Azure om du inte har gjort det. Det här steget krävs eftersom du ansluter till och laddar ned objekt till Marketplace från Azure.

2. Om du inte är bekant med Marketplace Management-funktionen i Azure Stack Hub-administratörsportalen läser du Ladda ned marketplace-objekt från Azure och publicerar till Azure Stack Hub. Artikeln beskriver hur du laddar ned objekt från Azure till Azure Stack Hub Marketplace. Den omfattar både anslutna och frånkopplade scenarier. Om din Azure Stack Hub-instans är frånkopplad eller delvis ansluten finns det ytterligare förutsättningar att slutföra inför installationen.

3. Uppdatera din Microsoft Entra hemkatalog. Från och med version 1910 måste ett nytt program registreras i din klientorganisation för hemkatalogen. Med den här appen kan Azure Stack Hub skapa och registrera nyare resursprovidrar (till exempel Event Hubs och andra) med din Microsoft Entra klientorganisation. Det här är en engångsåtgärd som måste utföras när du har uppgraderat till build 1910 eller senare. Om det här steget inte har slutförts misslyckas installationerna av Marketplace-resursprovidern.

   • När du har uppdaterat Azure Stack Hub-instansen till 1910 eller senare följer du anvisningarna för att klona/ladda ned Azure Stack Hub Tools-lagringsplatsen.
   • Följ sedan anvisningarna för Att uppdatera Azure Stack Hub Microsoft Entra Home Directory (när du har installerat uppdateringar eller nya resursprovidrar).

Krav för MySQL Server-resursprovider

• Du behöver en dator och ett konto som kan komma åt:

  • Azure Stack Hub-administratörsportalen.
  • den privilegierade slutpunkten (behövs bara när du distribuerar MySQL Server-resursproviderN V1 eller uppgraderar från MySQL Server-resursprovider V1 till MySQL Server-resursprovider V2).
  • Azure Resource Manager administratörsslutpunkt, https://adminmanagement.region.<fqdn>, där <fqdn> är ditt fullständigt kvalificerade domännamn.
  • Internet, om din Azure Stack Hub har distribuerats för att använda Microsoft Entra ID som identitetsprovider.

• Ladda ned den version av MySQL-resursprovidern som stöds binär enligt tabellen för versionsmappning nedan. För V2 MySQL-resursprovidern laddar du ned marketplace-objektet till Azure Stack Hub.

  Azure Stack Hub-version som stöds	MySQL RP-version	Windows Server som RP-tjänsten körs på
  2206, 2301, 2306, 2311	MySQL RP version 2.0.13.x	Microsoft AzureStack Add-on RP Windows Server 1.2009.0
  2108, 2206	MySQL RP version 2.0.6.x	Microsoft AzureStack Add-on RP Windows Server 1.2009.0

• Kontrollera att den nödvändiga virtuella Windows Server-datorn laddas ned till Azure Stack Hub Marketplace. Ladda ned avbildningen manuellt enligt versionsmappningstabellen ovan om det behövs.

• Se till att kraven för datacenterintegrering är uppfyllda:R

  Förutsättning	Referens
  Villkorlig DNS-vidarebefordring har angetts korrekt.	Integrering av Azure Stack Hub-datacenter – DNS
  Inkommande portar för resursprovidrar är öppna.	Integrering av Azure Stack Hub-datacenter – Publicera slutpunkter
  PKI-certifikatsämnet och SAN har angetts korrekt.	Krav för Azure Stack Hub-distribution av obligatoriska PKI-kravför Azure Stack Hub-distribution– PaaS-certifikat

• Förbered certifikatet. (Endast för integrerade systeminstallationer.)

  • Du måste ange SQL PaaS PKI-certifikatet som beskrivs i det valfria PaaS-certifikatavsnittet i PKI-krav för Azure Stack Hub-distribution. Alternativt namn på certifikatmottagare (SAN) måste följa följande namngivningsmönster: CN=*.dbadapter.<region>.<fqdn>, med lösenordsskyddad.
  • När du distribuerar MySQL Server-resursproviderN V1 placerar du PFX-filen på den plats som anges av parametern DependencyFilesLocalPath . Ange inget certifikat för ASDK-system.
  • När du distribuerar MySQL Server-resursproviderN V2 förbereder du certifikatet för följande installationssteg.

Frånkopplat scenario

När du distribuerar MySQL Server-resursproviderN V2 i ett frånkopplat scenario följer du anvisningarna för att ladda ned Marketplace-objekt till Azure Stack Hub för att ladda ned resursproviderobjektet MySQL Server och tillägget RP Windows Server-objektet till din Azure Stack Hub-miljö.

När du distribuerar MySQL Server-resursproviderN V1 i ett frånkopplat scenario utför du följande steg för att ladda ned nödvändiga PowerShell-moduler och registrera lagringsplatsen manuellt.

1. Logga in på en dator med Internetanslutning och använd följande skript för att ladda ned PowerShell-modulerna.

   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. Beroende på vilken version av resursprovidern som du distribuerar kör du ett av skripten.

   # 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. Sedan kopierar du de nedladdade paketen till en USB-enhet.

4. Logga in på den frånkopplade arbetsstationen och kopiera paketen från USB-enheten till en plats på arbetsstationen.

5. Registrera den här platsen som en lokal lagringsplats.

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

Distribuera MySQL-resursprovidern V2

Om du uppgraderar från en V1-version läser du dokumentet Uppdatera MySQL Server-resursprovidern.

Starta installationen

1. Om du inte redan har gjort det loggar du in på Azure Stack Hub-administratörsportalen, väljer Marketplace Management till vänster och väljer Resursprovidrar.

2. När MySQL-resursprovidern och annan nödvändig programvara har laddats ned visar Marketplace Management paketen "MySQL Server-resursprovider" med statusen "Inte installerad". Det kan finnas andra paket som visar statusen "Nedladdad".

   

3. Välj den rad som du vill installera. Installationspaketsidan för MySQL Server-resursprovidern visar en blå banderoll överst. Välj banderollen för att starta installationen.

Installationskrav

1. Sedan överförs du till installationssidan. Välj Installera förutsättningar för att påbörja installationsprocessen.

2. Vänta tills installationen av förhandskraven har slutförts. Du bör se en grön bock bredvid Installera krav innan du fortsätter till nästa steg.

Förbereda hemligheter

1. Under 2na. Förbered hemlighetssteget , välj Lägg till certifikat så visas panelen Lägg till ett certifikat .

2. Välj knappen Bläddra på Lägg till ett certifikat, precis till höger om fältet certifikatfilnamn. Välj den .pfx-certifikatfil som du anskaffade när du slutförde förutsättningarna.

3. Ange lösenordet som du angav för att skapa en säker sträng för SQL Server resursproviderns SSL-certifikat. Välj Lägg till.

Konfigurera och installera resursprovider

1. När installationen av certifikatet lyckas bör du se en grön bock bredvid Förbered hemligheter innan du fortsätter till nästa steg. Välj nu knappen Konfigurera + installera bredvid 3 Installera resursprovider.

2. Därefter måste du ange en Azure Stack Hub Blob-URI för MySQL Connector.

   • Granska GPL-licensen för MySQL Connector här och ladda ned version 8.0.21 till en lokal mapp.

   • Skapa ett lagringskonto med din standardoperatorprenumeration och skapa en container med åtkomstnivån "Blob" eller "Container".

   • Ladda upp mysql-connector-net-8.0.21.msi-filen från din lokala mapp till den nyligen skapade lagringscontainern.

   Viktigt

   Kontrollera att versionen av MySQL Connector är 8.0.21.

   • Kopiera blob-URI:n.

   • Gå tillbaka till konfigurationssidan för MySQL RP. Klistra in blob-URI:n (t.ex. https://< storageAccountName.blob>.<region>.<FQDN>/<containerName>/mysql-connector-net-8.0.21.msi) till textrutan och klicka på OK.

3. Härnäst visas följande sida, som anger att MySQL-resursprovidern installeras.

4. Vänta tills installationen har slutförts. Den här processen tar vanligtvis en eller flera timmar, beroende på typen av Azure Stack Hub.

5. Kontrollera att installationen av MySQL Server-resursprovidern har slutförts genom att gå tillbaka till sidan Marketplace Management, Resource Providers . Status för MySQL Server-resursprovidern bör visa "Installerad".

Distribuera SQL-resursprovidern V1

När du har slutfört alla krav kör du självextraktorn för att extrahera det nedladdade installationspaketet till en tillfällig katalog. Kör DeployMySqlProvider.ps1 skriptet från en dator som kan komma åt både Azure Stack Hub Azure Resource Manager administratörsslutpunkt och den privilegierade slutpunkten för att distribuera MySQL-resursprovidern. Skriptet DeployMySqlProvider.ps1 extraheras som en del av installationsfilerna för MySQL-resursprovidern som du laddade ned för din version av Azure Stack Hub.

Viktigt

Innan du distribuerar resursprovidern läser du viktig information om nya funktioner, korrigeringar och kända problem som kan påverka distributionen.

Om du vill distribuera MySQL-resursprovidern öppnar du ett nytt upphöjt PowerShell-fönster (inte PowerShell ISE) och ändrar till katalogen där du extraherade binärfilerna för MySQL-resursprovidern.

Viktigt

Vi rekommenderar starkt att du använder Clear-AzureRmContext -Scope CurrentUser och Clear-AzureRmContext –Scope Process för att rensa cachen innan du kör distributions- eller uppdateringsskriptet.

Anteckning

Om du distribuerar MySQL Server-resursproviderN V1 i en frånkopplad miljö kopierar dumysql-connector-net-6.10.5.msi-filen till en lokal sökväg. Ange sökvägsnamnet med parametern DependencyFilesLocalPath .

Kör skriptetDeployMySqlProvider.ps1 som slutför följande uppgifter:

• Laddar upp certifikaten och andra artefakter till ett lagringskonto på Azure Stack Hub.
• Publicerar galleripaket så att du kan distribuera MySQL-databaser med hjälp av galleriet.
• Publicerar ett galleripaket för distribution av värdservrar.
• Distribuerar en virtuell dator med Windows Server 2016 kärnavbildning eller Microsoft AzureStack-tilläggs-RP Windows Server-avbildning som du laddade ned och installerar sedan MySQL-resursprovidern.
• Registrerar en lokal DNS-post som mappar till den virtuella resursproviderns virtuella dator.
• Registrerar din resursprovider med den lokala Azure-Resource Manager för operatörskontot.

Anteckning

När distributionen av MySQL-resursprovidern startar skapas resursgruppen system.local.mysqladapter . Det kan ta upp till 75 minuter att slutföra de distributioner som krävs för den här resursgruppen. Du bör inte placera några andra resurser i resursgruppen system.local.mysqladapter .

DeployMySqlProvider.ps1 parametrar

Du kan ange dessa parametrar från kommandoraden. Om du inte gör det, eller om någon parameterverifiering misslyckas, uppmanas du att ange de parametrar som krävs.

Parameternamn	Beskrivning	Kommentar eller standardvärde
CloudAdminCredential	Autentiseringsuppgifterna för molnadministratören som krävs för åtkomst till den privilegierade slutpunkten.	Obligatoriskt
AzCredential	Autentiseringsuppgifterna för Azure Stack Hub-tjänstadministratörskontot. Använd samma autentiseringsuppgifter som du använde för att distribuera Azure Stack Hub. Skriptet misslyckas om kontot som du använder med AzCredential kräver multifaktorautentisering (MFA).	Obligatoriskt
VMLocalCredential	Autentiseringsuppgifterna för det lokala administratörskontot för den virtuella datorn MySQL-resursprovider.	Obligatoriskt
PrivilegedEndpoint	IP-adressen eller DNS-namnet på den privilegierade slutpunkten.	Obligatoriskt
AzureEnvironment	Azure-miljön för tjänstadministratörskontot som används för att distribuera Azure Stack Hub. Krävs endast för Microsoft Entra distributioner. Miljönamn som stöds är AzureCloud, AzureUSGovernment eller om du använder en China Microsoft Entra ID, AzureChinaCloud.	AzureCloud
DependencyFilesLocalPath	Endast för integrerade system måste din .pfx-certifikatfil placeras i den här katalogen. För frånkopplade miljöer laddar du ned mysql-connector-net-6.10.5.msi till den här katalogen. Du kan också kopiera ett Windows Update MSU-paket här.	Valfritt (obligatoriskt för integrerade system eller frånkopplade miljöer)
DefaultSSLCertificatePassword	Lösenordet för .pfx-certifikatet.	Obligatoriskt
MaxRetryCount	Hur många gånger du vill försöka utföra varje åtgärd igen om det uppstår ett fel.	2
RetryDuration	Tidsgränsintervallet mellan återförsök i sekunder.	120
Avinstallera	Tar bort resursprovidern och alla associerade resurser (se följande anteckningar).	No
DebugMode	Förhindrar automatisk rensning vid fel.	No
AcceptLicense	Hoppar över uppmaningen om att acceptera GPL-licensen. https://www.gnu.org/licenses/old-licenses/gpl-2.0.html

Distribuera MySQL-resursprovidern med ett anpassat skript

Om du distribuerar MySQL-resursprovidern version 1.1.47.0 eller senare laddar distributionsskriptet automatiskt ned och installerar nödvändiga PowerShell-moduler som du kan använda för att söka efter 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

Anteckning

I ett frånkopplat scenario måste du ladda ned nödvändiga PowerShell-moduler och registrera lagringsplatsen manuellt som en förutsättning.

Om du vill eliminera manuell konfiguration när du distribuerar resursprovidern kan du anpassa följande skript. Ändra standardkontoinformationen och lösenorden efter behov för din Azure Stack Hub-distribution.

# 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

När resursproviderns installationsskript är klart uppdaterar du webbläsaren för att se till att du kan se de senaste uppdateringarna och stänga den aktuella PowerShell-sessionen.

Verifiera V1-distributionen med hjälp av Azure Stack Hub-portalen

1. Logga in på administratörsportalen som tjänstadministratör.
2. Välj Resursgrupper.
3. Välj systemet.<location.mysqladapter-resursgrupp>.
4. På sammanfattningssidan för Översikt över resursgrupp bör det inte finnas några misslyckade distributioner.
5. Välj slutligen Virtuella datorer i administratörsportalen för att kontrollera att den virtuella datorn MySQL-resursprovidern har skapats och körs.

Viktig konfiguration för Microsoft Entra ID

Om din Azure Stack Hub använder Microsoft Entra ID som identitetsprovider kontrollerar du att den virtuella datorn som har installerat MySQL Server-resursprovidern har utgående Internetanslutning.

Om det finns ett behov av att hämta IP-adressen för den virtuella datorn som har installerat MySQL Server-resursprovidern (dvs. lägga till IP-adressen i listan över tillåtna brandväggar) måste du öppna ett supportärende och låta supportteknikern göra resursproviderprenumerationen för MySQL Server tillfälligt synlig. Sedan kan du hitta den virtuella datorn i prenumerationen och hämta dess IP-adress.

Nästa steg

Lägga till värdservrar