Bereitstellen des MySQL-Ressourcenanbieters in Azure Stack Hub

Verwenden Sie den MySQL-Server-Ressourcenanbieter, um MySQL-Datenbanken als Azure Stack Hub-Dienst verfügbar zu machen.

Voraussetzungen

Wenn Sie bereits einen Ressourcenanbieter installiert haben, haben Sie wahrscheinlich alle Schritte für die folgenden Voraussetzungen ausgeführt und können diesen Abschnitt überspringen. Führen Sie andernfalls vor dem Fortfahren diese Schritte aus:

1. Registrieren Sie Ihre Azure Stack Hub-Instanz in Azure, wenn Sie dies noch nicht getan haben. Dieser Schritt ist erforderlich, weil eine Verbindung mit Azure herstellen und aus Azure Elemente in Marketplace herunterladen.

2. Wenn Sie nicht mit dem Marketplace-Verwaltung-Feature des Azure Stack Hub-Administratorportals vertraut sind, sollten Sie Herunterladen von Marketplace-Elementen in Azure Stack Hub lesen. In dem Artikel werden Sie durch die Schritte geleitet, mit denen Elemente aus Azure in den Azure Stack Hub-Marketplace heruntergeladen werden. Dieser Artikel gilt sowohl für ein verbundenes als auch für ein nicht verbundenes Szenario. Ist Ihre Azure Stack Hub-Instanz nicht verbunden oder teilweise verbunden, gibt es weitere Voraussetzungen, die zur Vorbereitung auf die Installation erfüllt sein müssen.

3. Aktualisieren Sie Ihr Microsoft Entra-Basisverzeichnis. Ab Build 1910 muss eine neue Anwendung in Ihrem Stammverzeichnismandanten registriert werden. Mit dieser App kann Azure Stack Hub neuere Ressourcenanbieter (z. B. Event Hubs und andere) erfolgreich erstellen und bei Ihrem Microsoft Entra Mandanten registrieren. Dies ist eine einmalige Aktion, die nach dem Upgrade auf Build 1910 oder höher ausgeführt werden muss. Wird dieser Schritt nicht ausgeführt, tritt bei der Installation von Ressourcenanbietern aus dem Marketplace ein Fehler auf.

   • Nachdem Sie Ihre Azure Stack Hub-Instanz erfolgreich auf 1910 oder höher aktualisiert haben, befolgen Sie die Anweisungen zum Klonen/Herunterladen des Azure Stack Hub-Tools-Repository.
   • Befolgen Sie dann die Anweisungen zum Aktualisieren des Azure Stack Hub-Microsoft Entra-Basisverzeichnisses (nach der Installation von Updates oder neuen Ressourcenanbietern).

MySQL Server-Ressourcenanbietervoraussetzungen

• Sie benötigen einen Computer und ein Konto mit Zugriff auf folgende Komponenten:

  • Das Azure Stack Hub-Administratorportal.
  • Den privilegierten Endpunkt (nur erforderlich, wenn Sie den MySQL Server-Ressourcenanbieter V1 bereitstellen oder ein Upgrade von MySQL Server-Ressourcenanbieter V1 auf MySQL Server-Ressourcenanbieter V2 durchführen).
  • Den Azure Resource Manager-Administratorendpunkt https://adminmanagement.region.<fqdn>, wobei <fqdn> der vollqualifizierte Domänenname ist.
  • das Internet, wenn Ihr Azure Stack Hub bereitgestellt wurde, um Microsoft Entra ID als Identitätsanbieter zu verwenden.

• Laden Sie die unterstützte Version des MySQL-Ressourcenanbieters in binärer Form gemäß der Versionszuordnungstabelle unten herunter. Laden Sie für den MySQL-Ressourcenanbieter V2 das Marketplace-Element in Azure Stack Hub herunter.

  Unterstützte Azure Stack Hub-Version	MySQL RP Version	Windows Server-Instanz, auf der der RP-Dienst ausgeführt wird
  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

• Stellen Sie sicher, dass die erforderliche Windows Server-VM in den Azure Stack Hub Marketplace heruntergeladen wurde. Laden Sie das Image bei Bedarf manuell gemäß der obigen Versionszuordnungstabelle herunter.

• Stellen Sie sicher, dass die Voraussetzungen der Rechenzentrumsintegration erfüllt sind:

  Voraussetzung	Verweis
  Bedingte DNS-Weiterleitung ist ordnungsgemäß festgelegt.	Azure Stack Hub-Rechenzentrumsintegration – DNS
  Eingangsports für Ressourcenanbieter sind geöffnet.	Integration des Azure Stack Hub-Rechenzentrums – Veröffentlichen von Endpunkten
  PKI-Zertifikatantragsteller und SAN sind ordnungsgemäß festgelegt.	Obligatorische PKI-Voraussetzungen für die Azure Stack Hub-BereitstellungPaaS-Zertifikatanforderungen für die Azure Stack Hub-Bereitstellung

• Bereiten Sie das Zertifikat vor. (Nur bei Installationen in integrierten Systemen.)

  • Sie müssen das SQL-PaaS-PKI-Zertifikat bereitstellen, das im Abschnitt „Optionale PaaS-Zertifikate“ der PKI-Anforderungen für die Azure Stack Hub-Bereitstellung beschrieben ist. Der alternative Antragstellername (Subject Alternative Name, SAN) muss dem folgenden Benennungsmuster entsprechen: CN=*.dbadapter.<region>.<fqdn>, mit Kennwortschutz.
  • Bei der Bereitstellung des MySQL Server-Ressourcenanbieters V1 legen Sie die PFX-Datei an dem Speicherort ab, der durch den Parameter DependencyFilesLocalPath angegeben ist. Geben Sie für ASDK-Systeme kein Zertifikat an.
  • Bereiten Sie beim Bereitstellen des MySQL Server-Ressourcenanbieters V2 das Zertifikat für die folgenden Installationsschritte vor.

Nicht verbundenes Szenario

Wenn Sie den MySQL Server-Ressourcenanbieter V2 in einem nicht verbundenen Szenario bereitstellen, folgen Sie der Anleitung zum Herunterladen von Marketplace-Elementen in Azure Stack Hub, um das MySQL Server-Ressourcenanbieterelement und das Add-On RP Windows Server-Element in Ihre Azure Stack Hub-Umgebung herunterzuladen.

Wenn Sie den MySQL Server-Ressourcenanbieter V1 bereitstellen, führen Sie in einem nicht verbundenen Szenario die folgenden Schritte aus, um die erforderlichen PowerShell-Module manuell herunterzuladen und das Repository zu registrieren.

1. Melden Sie sich bei einem Computer mit Internetverbindung an, und verwenden Sie die folgenden Skripts, um die PowerShell-Module herunterzuladen.

   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. Je nachdem, welche Version des Ressourcenanbieters Sie bereitstellen, führen Sie das entsprechende Skript aus.

   # 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. Kopieren Sie dann die heruntergeladenen Pakete auf ein USB-Gerät.

4. Melden Sie sich bei der getrennten Arbeitsstation an, und kopieren Sie die Pakete vom USB-Gerät an einen Speicherort auf der Arbeitsstation.

5. Registrieren Sie diesen Speicherort als lokales Repository.

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

Bereitstellen des MySQL-Ressourcenanbieters V2

Wenn Sie ein Upgrade von einer V1-Version durchführen, lesen Sie das Dokument Aktualisieren des MySQL Server-Ressourcenanbieters.

Starten der Installation

1. Wenn dies noch nicht geschehen ist, melden Sie am Azure Stack Hub-Administratorportal an, wählen Sie auf der linken Seite Marketplace-Verwaltung aus, und wählen Sie Ressourcenanbieter aus.

2. Sobald der MySQL-Ressourcenanbieter und andere benötigte Software heruntergeladen wurden, zeigt die Marketplace-Verwaltung die „MySQL Server-Ressourcenanbieter“-Pakete mit dem Status „Nicht installiert“ an. Möglicherweise gibt es andere Pakete, die mit dem Status „Heruntergeladen“ angezeigt werden.

   

3. Wählen Sie die Zeile aus, die Sie installieren möchten. Auf der Seite für Installationspakete des MySQL Server-Ressourcenanbieters wird oben ein blaues Banner angezeigt. Wählen Sie das Banner aus, um die Installation zu starten.

Installieren der erforderlichen Komponenten

1. Als nächstes gelangen Sie zur Installationsseite. Wählen Sie Voraussetzungen installieren aus, um den Installationsvorgang zu starten.

2. Warten Sie, bis die Installation der Voraussetzungen erfolgreich abgeschlossen ist. Ein grünes Häkchen sollte neben Voraussetzungen installieren angezeigt werden, bevor Sie zum nächsten Schritt wechseln.

Vorbereiten der Geheimnisse

1. Wählen Sie unter dem Schritt 2. Geheimnisse vorbereiten den Link Zertifikat hinzufügen aus. Daraufhin wird der Bereich Zertifikat hinzufügen angezeigt.

2. Wählen Sie die Schaltfläche für Durchsuchen unter Zertifikat hinzufügen aus, die sich direkt rechts neben dem Feld mit dem Dateinamen des Zertifikats befindet. Wählen Sie die PFX-Zertifikatsdatei aus, die Sie beim Ausführen der Schritte für die Voraussetzungen beschafft haben.

3. Geben Sie das Kennwort ein, das Sie angegeben haben, um eine sichere Zeichenfolge für das SSL-Zertifikat des SQL Server-Ressourcenanbieters zu erstellen. Wählen Sie anschließend Hinzufügen.

Konfigurieren und Installieren des Ressourcenanbieters

1. Wenn das Zertifikat erfolgreich installiert wurde, sollte ein grünes Häkchen neben Geheimnisse vorbereiten angezeigt werden. Ist dies der Fall, wechseln Sie zum nächsten Schritt. Wählen Sie nun die Schaltfläche Konfigurieren und installieren neben 3. Ressourcenanbieter installieren aus.

2. Als nächstes müssen Sie einen Azure Stack Hub-Blob-URI für MySQL Connector bereitstellen.

   • Überprüfen Sie die GPL-Lizenz von MySQL Connector hier, und laden Sie Version 8.0.21 in einen lokalen Ordner herunter.

   • Erstellen Sie ein Speicherkonto mit Ihrem Standardoperatorabonnement, und erstellen Sie einen Container mit der Zugriffsebene „Blob“ oder „Container“.

   • Laden Sie die Datei „mysql-connector-net-8.0.21.msi“ aus Ihrem lokalen Ordner in den neu erstellten Speichercontainer hoch.

   Wichtig

   Stellen Sie sicher, dass die Version des MySQL-Connectors 8.0.21 lautet.

   • Kopieren Sie den Blob-URI.

   • Wechseln Sie zurück zur Konfigurationsseite von MySQL RP. Fügen Sie den Blob-URI (z. B. https://<storageAccountName>.blob.<region>.<FQDN>/<containerName>/mysql-connector-net-8.0.21.msi) in das Textfeld ein, und klicken Sie auf „OK“.

3. Als nächstes wird die folgende Seite angezeigt, auf der mitgeteilt wird, dass der MySQL-Ressourcenanbieter installiert wird.

4. Warten Sie, bis die Benachrichtigung angezeigt wird, dass die Installation abgeschlossen ist. Dieser Vorgang dauert in der Regel eine oder mehrere Stunden, je nach Ihrem Azure Stack Hub-Typ.

5. Überprüfen Sie, ob die Installation des MySQL Server-Ressourcenanbieters erfolgreich war. Kehren Sie dazu zur Seite Marketplace-Verwaltung, Ressourcenanbieter zurück. Der Status des MySQL Server-Ressourcenanbieters sollte „Installiert“ lauten.

Bereitstellen des SQL-Ressourcenanbieters V1

Nachdem Sie alle Voraussetzungen erfüllt haben, führen Sie die selbstextrahierende Datei aus, um das heruntergeladene Installationspaket in ein temporäres Verzeichnis zu entpacken. Führen Sie das Skript DeployMySqlProvider.ps1 auf einem Computer aus, der sowohl auf den Resource Manager-Administratorendpunkt für Azure Stack Hub als auch auf den privilegierten Endpunkt zugreifen kann, um den MySQL-Ressourcenanbieter bereitzustellen. Das Skript „DeployMySqlProvider.ps1“ wird als Teil der Installationsdateien vom MySQL-Ressourcenanbieter extrahiert, die Sie entsprechend Ihrer Azure Stack Hub-Version heruntergeladen haben.

Um den MySQL-Ressourcenanbieter bereitzustellen, öffnen Sie ein neues PowerShell-Fenster mit erhöhten Rechten (nicht PowerShell ISE), und wechseln Sie zu dem Verzeichnis, in das Sie die Binärdateien des MySQL-Ressourcenanbieters extrahiert haben.

Führen Sie das Skript DeployMySqlProvider.ps1 aus, das die folgenden Aufgaben ausführt:

• Lädt die Zertifikate und andere Artefakte in ein Azure Stack Hub-Speicherkonto hoch.
• Veröffentlicht Katalogpakete, damit Sie MySQL-Datenbank-Instanzen über den Katalog bereitstellen können.
• Veröffentlicht ein Katalogpaket für die Bereitstellung von Hostservern.
• Stellt VM unter Verwendung des heruntergeladenen Images – „Windows Server 2016 Core“ oder „Microsoft AzureStack Add-on RP Windows Server“ – eine bereit und installiert dann den MySQL-Ressourcenanbieter.
• Registriert einen lokalen DNS-Eintrag, der dem virtuellen Computer mit dem Ressourcenanbieter zugeordnet wird.
• Registriert Ihren Ressourcenanbieter beim lokalen Azure Resource Manager für das Operatorkonto.

DeployMySqlProvider.ps1-Parameter

Sie können diese Parameter in der Befehlszeile angeben. Wenn Sie keine Parameter angeben oder bei der Überprüfung eines Parameters ein Fehler auftritt, werden Sie aufgefordert, die erforderlichen Parameter anzugeben.

Bereitstellen des MySQL-Ressourcenanbieters mithilfe eines benutzerdefinierten Skripts

Wenn Sie Version 1.1.47.0 oder höher des MySQL-Ressourcenanbieters bereitstellen, lädt das Bereitstellungsskript die erforderlichen PowerShell-Module automatisch herunter und installiert sie im Pfad „C:\Programme\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

Um jegliche manuelle Konfiguration bei der Bereitstellung des Ressourcenanbieters zu vermeiden, können Sie das folgende Skript anpassen. Ändern Sie die Standardkontoinformationen und -kennwörter entsprechend den Anforderungen für Ihre Azure Stack Hub-Bereitstellung.

# 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

Wenn das Skript zur Installation des Ressourcenanbieters abgeschlossen ist, aktualisieren Sie Ihren Browser, um sicherzustellen, dass die neuesten Updates angezeigt werden, und um die aktuelle PowerShell-Sitzung zu schließen.

Überprüfung der V1-Bereitstellung mithilfe des Azure Stack Hub-Portals

1. Melden Sie sich als Dienstadministrator beim Verwaltungsportal an.
2. Wählen Sie Ressourcengruppen aus.
3. Wählen Sie die Ressourcengruppe system.<Speicherort>.mysqladapter aus.
4. Auf der Zusammenfassungsseite der Ressourcengruppenübersicht sollten keine fehlerhaften Bereitstellungen angezeigt werden.
5. Wählen Sie abschließend im Verwaltungsportal die Option Virtuelle Computer aus, um zu überprüfen, ob der VM des MySQL-Ressourcenanbieters erfolgreich erstellt wurde und ausgeführt wird.

Wichtige Konfiguration für Microsoft Entra ID

Wenn Ihr Azure Stack Hub Microsoft Entra ID als Identitätsanbieter verwendet, stellen Sie sicher, dass der virtuelle Computer, der den MySQL Server-Ressourcenanbieter installiert hat, über ausgehende Internetkonnektivität verfügt.

Nächste Schritte

Hinzufügen von Hostservern