Distribuera MySQL-resursprovidern på Azure Stack Hub

Viktig

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, öppna ett supportärende så vägleder våra supporttekniker dig genom distributions- eller uppgraderingsprocessen.

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

MySQL-resursleverantören körs som en tjänst på en specifik RP-tilläggsserver i Windows.

Viktig

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. I annat fall slutför du dessa steg 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 funktionen Marketplace Management i Azure Stack Hub-administrationsportalen, kan du granska Ladda ned Marketplace-objekt från Azure och publicera 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 en ny applikation registreras i klienten i din hemkatalog. 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 efter uppgraderingen 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 instruktioner för att klona/ladda ned Azure Stack Hub Tools-lagringsplatsen.
   • Följ sedan anvisningarna för Uppdatera Azure Stack Hub Microsoft Entra Home Directory (efter installation av uppdateringar eller nya resursproviders).

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 (krävs endast när du distribuerar MySQL Server-resursleverantör V1 eller uppgraderar från MySQL Server-resursleverantör V1 till MySQL Server-resursleverantör V2).
  • Administratörsslutpunkten för Azure Resource Manager, https://adminmanagement.region.<fqdn>, där <fqdn> är ditt fullständigt kvalificerade domännamn.
  • Internet, ifall din Azure Stack Hub har distribuerats för att använda Microsoft Entra-ID som identitetsleverantör.

• Ladda ner den stödda versionen av MySQL-resursleverantörens binärfil enligt tabellen för versionsmappning nedan. För V2 MySQL-resursleverantören , ladda ner 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 har laddats ned till Azure Stack Hub Marketplace. Ladda ned avbildningen manuellt enligt tabellen för versionsmappning ovan om det behövs.

• Se till att kraven för datacenterintegrering uppfylls:R

  Förutsättning	Hänvisning
  Villkorlig DNS-vidarebefordran har angetts korrekt.	Datacenterintegrering i Azure Stack Hub – DNS-
  Inkommande portar för resursleverantörer är öppna.	Integrering av Azure Stack Hub-datacenter – Publicera slutpunkter
  PKI-certifikatmottagaren och SAN har angetts korrekt.	Obligatoriska PKI-förutsättningar för Azure Stack Hub-distributionPaaS-certifikatförhandskrav för Azure Stack Hub-distribution

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

  • Du måste ange SQL PaaS PKI-certifikatet som beskrivs i avsnittet valfria PaaS-certifikat i PKI-krav för Azure Stack Hub-distribution. Det alternativa namnet (SAN) måste följa följande namngivningsmönster: CN=*.dbadapter.<region>.<fqdn>, och vara lösenordsskyddat.
  • 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 ladda ned Marketplace-objekt till Azure Stack Hub instruktion för att ladda ned resursproviderobjektet MySQL Server och RP Windows Server-objektet add-on 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 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 resursprovidern MySQL Server.

Starta installation

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.

Installera förutsättningar

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 2. Förbered hemligheter steg, välj Lägg till certifikatoch panelen Lägg till ett certifikat visas.

2. Välj knappen Bläddra på Lägg till ett certifikat, bara till höger om fältet certifikatfilnamn. Välj den .pfx-certifikatfil som du skaffade 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 sedan 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.

   Viktig

   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) i textrutan och klicka på OK.

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

4. Vänta på meddelandet om att installationen är klar. Den här processen tar vanligtvis en eller flera timmar, beroende på din Azure Stack Hub-typ.

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-resursleverantören V1

När du har slutfört alla förutsättningar 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örsslutpunkten och den privilegierade slutpunkten för att distribuera MySQL-resursprovidern. DeployMySqlProvider.ps1-skriptet extraheras som en del av installationsfilerna för MySQL-resursprovidern som du laddade ned för din version av Azure Stack Hub.

Viktig

Innan du distribuerar resursprovidern, läs utgivningsanteckningarna för att få information om nya funktioner, korrigeringar och eventuella kända problem som kan påverka din distribution.

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.

Viktig

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.

Not

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

Kör skriptet DeployMySqlProvider.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ärnavbildningen eller Microsoft AzureStack Add-on RP Windows Server-avbildningen som du laddade ned och installerar sedan MySQL-resursprovidern.
• Registrerar en lokal DNS-post som mappar till den virtuella resursproviderns virtuella dator.
• Registrerar din resursleverantör hos den lokala Azure Resource Manager för operatörskontot.

Obs

När distributionen av MySQL-resursprovidern startar skapas system.local.mysqladapter resursgrupp. 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 system.local.mysqladapter resursgrupp.

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 obligatoriska parametrarna.

Parameternamn	Beskrivning	Kommentar eller standardvärde
MolnAdminBehörighet	Autentiseringsuppgifterna för molnadministratören, som krävs för åtkomst till den privilegierade slutpunkten.	Krävs
AzCredential	Autentiseringsuppgifterna för tjänstadministratörskontot för Azure Stack Hub. Använd samma autentiseringsuppgifter som du använde för att distribuera Azure Stack Hub. Skriptet misslyckas om det konto som du använder med AzCredential kräver multifaktorautentisering (MFA).	Krävs
VMLocalCredential	Autentiseringsuppgifterna för det lokala administratörskontot för den virtuella datorn MySQL-resursprovider.	Krävs
PrivilegieradSlutpunkt	IP-adressen eller DNS-namnet för den privilegierade slutpunkten.	Krävs
Azure-miljö	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, AzureUSGovernmenteller om du använder ett Microsoft Entra-ID för Kina 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.	Valfri (obligatorisk för integrerade system eller frånkopplade miljöer)
DefaultSSLCertificatePassword	Lösenordet för .pfx-certifikatet.	Krävs
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).	Nej
DebugMode	Förhindrar automatisk rensning vid fel.	Nej
AccepteraLicens	Hoppar över uppmaningen 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, kommer distributionsskriptet automatiskt att ladda ner och installera de nödvändiga PowerShell-modulerna till sökvägen 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

Not

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 installationsskriptet för resursprovidern är klart uppdaterar du webbläsaren så 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 det systemet.<plats>.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 MySQL-resursleverantörens VM 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 du behöver hämta IP-adressen för den virtuella datorn som har installerat Resursprovidern MySQL Server (dvs. lägg 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ägg till värdservrar