Bereitstellen des MySQL-Ressourcenanbieters im Azure Stack Hub

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

Nur der Ressourcenanbieter sollte Elemente auf Servern erstellen, die SQL oder MySQL hosten. Elemente, die auf einem Hostserver erstellt wurden, die nicht vom Ressourcenanbieter erstellt werden, werden nicht unterstützt und können zu einem nicht übereinstimmenden Zustand führen.

Voraussetzungen

Wenn Sie bereits einen Ressourcenanbieter installiert haben, haben Sie wahrscheinlich die folgenden Voraussetzungen erfüllt und können diesen Abschnitt überspringen. Führen Sie andernfalls diese Schritte aus, bevor Sie fortfahren.

1. Registrieren Sie Ihre Azure Stack Hub-Instanz in Azure, wenn Sie dies noch nicht getan haben. Sie müssen Ihre Azure Stack Hub Instanz bei Azure registrieren, da Sie eine Verbindung mit Azure herstellen und Elemente vom Marketplace herunterladen.

2. Wenn Sie mit der Marketplaceverwaltung-Funktion des Azure Stack Hub-Administratorportals nicht vertraut sind, lesen Sie den Artikel Marketplace-Elemente aus Azure herunterladen und in Azure Stack Hub veröffentlichen. 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. Wenn Ihre Azure Stack Hub Instanz getrennt oder teilweise verbunden ist, müssen Sie zusätzliche Voraussetzungen für die Installation abschließen.

3. Aktualisieren Sie Ihr Microsoft Entra-Startverzeichnis. Ab Build 1910 müssen Sie eine neue Anwendung in Ihrem Heimverzeichnismandanten registrieren. Diese App ermöglicht es Azure Stack Hub, neuere Ressourcenanbieter (z. B. Azure Event Hubs und andere) erfolgreich zu erstellen und bei Ihrem Microsoft Entra-Mandanten zu registrieren.

   Diese Aktion ist nach dem Upgrade auf Build 1910 oder höher erforderlich. Wenn Sie diesen Schritt nicht abschließen, schlagen die Installationen von Ressourcenanbietern aus dem Marketplace fehl.

4. Nachdem Sie ihre Azure Stack Hub Instanz erfolgreich auf 1910 oder höher aktualisiert haben, folgen Sie den Instruktionen zum Klonen/Herunterladen des Repositorys Azure Stack Hub Tools.

5. Folgen Sie den instructions zum Aktualisieren des Azure Stack Hub Microsoft Entra Home directory (nach der Installation von Updates oder neuen Ressourcenanbietern).

Voraussetzungen für mySQL Server-Ressourcenanbieter

• Sie benötigen einen Computer und ein Konto, auf den Sie zugreifen können:

  • das Azure Stack Hub-Administratorportal.
  • der privilegierte Endpunkt (nur erforderlich, wenn Sie mySQL Server-Ressourcenanbieter V1 bereitstellen oder ein Upgrade vom MySQL Server-Ressourcenanbieter V1 auf den 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 so eingerichtet wurde, dass er Microsoft Entra ID als Ihren Identitätsanbieter verwendet.

• Laden Sie die unterstützte Version der MySQL-Ressourcenanbieter-Binärdatei gemäß der Versionszuordnungstabelle im folgenden Abschnitt herunter. Für den MySQL-Ressourcenanbieter V2 laden Sie das Marketplace-Element auf Azure Stack Hub herunter.

  Unterstützte Azure Stack Hub-Version	MySQL RP-Version	Windows Server, auf dem 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 auf den Azure Stack Hub Marketplace heruntergeladen wird. Laden Sie das Bild bei Bedarf manuell entsprechend der Versionszuordnungstabelle herunter.

• Sicherstellen, dass die Voraussetzungen für die Rechenzentrumsintegration erfüllt sind:

  Voraussetzung	Referenz
  Die bedingte DNS-Weiterleitung ist ordnungsgemäß festgelegt.	Azure Stack Hub-Rechenzentrumsintegration – DNS
  Eingangsports für Ressourcenanbieter sind geöffnet.	Azure Stack Hub-Rechenzentrumsintegration – Veröffentlichen von Endpunkten
  Der PKI-Zertifikatsbetreff und SAN sind ordnungsgemäß festgelegt.	Obligatorische PKI-Voraussetzungen für die Azure Stack Hub-BereitstellungVoraussetzungen für PaaS-Zertifikate bei der Azure Stack Hub-Bereitstellung

• Bereiten Sie das Zertifikat vor. (Nur für integrierte Anlagen.)

  • Sie müssen das SQL PaaS-PKI-Zertifikat angeben, das im optionalen Abschnitt "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.
  • Platzieren Sie beim Bereitstellen des MySQL Server-Ressourcenanbieters V1 die PFX-Datei an dem speicherort, der durch den Parameter DependencyFilesLocalPath angegeben wird. Stellen Sie kein Zertifikat für ASDK-Systeme bereit.
  • Bereiten Sie beim Bereitstellen des MySQL Server-Ressourcenanbieters V2 das Zertifikat für die folgenden Installationsschritte vor.

Nicht verbundenes Szenario

Bei der Bereitstellung des MySQL Server-Ressourcenanbieters V2 in einem getrennten Szenario befolgen Sie die Anweisung "Marketplace-Artikel in Azure Stack Hub herunterladen", um den MySQL Server-Ressourcenanbieterartikel und den Add-on RP Windows Server-Artikel in Ihre Azure Stack Hub-Umgebung herunterzuladen.

Führen Sie beim Bereitstellen des MySQL Server-Ressourcenanbieters V1 in einem getrennten Szenario die folgenden Schritte aus, um die erforderlichen PowerShell-Module herunterzuladen und das Repository manuell 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. Führen Sie je nach bereitgestellter Version des Ressourcenanbieters eines der Skripts 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. Anschließend kopieren Sie 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. Falls noch nicht geschehen, melden Sie sich beim Azure Stack Hub Administratorportal an, wählen Sie Marketplace Management links aus, und wählen Sie Anbieter aus.

2. Nach dem Herunterladen des MySQL-Ressourcenanbieters und anderer erforderlicher Software zeigt Marketplace Management die Pakete "MySQL Server-Ressourcenanbieter" mit dem Status "Nicht installiert" an. Möglicherweise werden andere Pakete angezeigt, die den Status "Heruntergeladen" anzeigen.

   

3. Wählen Sie die Zeile aus, die installiert werden soll. Die Installationspaketseite des MySQL Server-Ressourcenanbieters zeigt oben ein blaues Banner an. Wählen Sie das Banner aus, um die Installation zu starten.

Installieren der erforderlichen Komponenten

1. Als Nächstes werden Sie auf die Installationsseite übertragen. 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.

Geheime Schlüssel vorbereiten

1. Unter den 2. Schritt "Geheime Schlüssel vorbereiten ", wählen Sie "Zertifikat hinzufügen" aus. Der Bereich "Zertifikat hinzufügen " wird 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 Erfüllen der Voraussetzungen bezogen haben.

3. Geben Sie das kennwort ein, das Sie zum Erstellen einer sicheren Zeichenfolge für das SSL-Zertifikat des SQL Server-Ressourcenanbieters angegeben haben. Wählen Sie dann Hinzufügen aus.

Konfigurieren und Installieren des Ressourcenanbieters

1. Wenn die Installation des Zertifikats erfolgreich ist, wird neben " Geheime Schlüssel vorbereiten" ein grünes Häkchen angezeigt. Wählen Sie nun die Schaltfläche "Konfigurieren + Installieren " neben 3 "Ressourcenanbieter installieren" aus.

2. Geben Sie als Nächstes eine Azure Stack Hub Blob-URI für den MySQL Connector an.

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

   • Erstellen Sie ein Speicherkonto mit Ihrem Standardanbieterabonnement, und erstellen Sie einen Container mit der Zugriffsebene "Blob" oder "Container".

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

   Von Bedeutung

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

   • Kopieren Sie den Blob-URI.

   • Wechseln Sie zurück zur MySQL RP-Konfigurationsseite. 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 wählen Sie OK aus.

3. Als Nächstes wird die folgende Seite angezeigt, die angibt, dass 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. Stellen Sie sicher, dass die Installation des MySQL Server-Ressourcenanbieters erfolgreich war, indem Sie zur Seite Marketplace Management, Ressourcenanbieter , zurückkehren. Der Status des MySQL Server-Ressourcenanbieters sollte "Installiert" anzeigen.

Bereitstellen des SQL-Ressourcenanbieters V1

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

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

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

• Lädt die Zertifikate und andere Artefakte in ein Speicherkonto auf Azure Stack Hub hoch.
• Veröffentlicht Katalogpakete, damit Sie MySQL-Datenbanken mithilfe des Katalogs bereitstellen können.
• Veröffentlicht ein Katalogpaket für die Bereitstellung von Hostingservern.
• Stellt einen virtuellen Computer mithilfe des Windows Server 2016 Kernimages oder Microsoft AzureStack-Add-On RP Windows Server Image bereit, das Sie heruntergeladen haben, und installiert dann den MySQL-Ressourcenanbieter.
• Registriert einen lokalen DNS-Eintrag, der Ihrem ressourcenanbieter-virtuellen Computer zugeordnet ist.
• Registriert Ihren Ressourcenanbieter beim lokalen Azure Resource Manager für das Operatorkonto.

DeployMySqlProvider.ps1-Parameter

Geben Sie diese Parameter über die Befehlszeile an. Wenn Sie sie nicht angeben oder wenn eine Parameterüberprüfung fehlschlägt, werden Sie vom Skript aufgefordert, die erforderlichen Parameter anzugeben.

Bereitstellen des MySQL-Ressourcenanbieters mithilfe eines benutzerdefinierten Skripts

Wenn Sie den MySQL-Ressourcenanbieter in Version 1.1.47.0 oder höher bereitstellen, lädt das Bereitstellungsskript die erforderlichen PowerShell-Module automatisch herunter und installiert sie im Pfad 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

Um manuelle Konfigurationen beim Bereitstellen des Ressourcenanbieters zu beseitigen, passen Sie das folgende Skript an. Ändern Sie die Standardkontoinformationen und Kennwörter nach Bedarf 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 Installationsskript des Ressourcenanbieters abgeschlossen ist, aktualisieren Sie Ihren Browser, um sicherzustellen, dass Sie die neuesten Updates sehen und die aktuelle PowerShell-Sitzung schließen können.

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

1. Melden Sie sich beim Administratorportal als Dienstadministrator an.
2. Wählen Sie Ressourcengruppen aus.
3. Wählen Sie die Ressourcengruppe system.<location>.mysqladapter aus.
4. Auf der Zusammenfassungsseite für die Ressourcengruppenübersicht sollten keine fehlgeschlagenen Bereitstellungen vorhanden sein.
5. Wählen Sie schließlich virtuelle Computer im Administratorportal aus, um zu überprüfen, ob die VM des MySQL-Ressourcenanbieters erfolgreich erstellt und ausgeführt wurde.

Wichtige Konfiguration für die Microsoft Entra ID

Wenn Ihr Azure Stack Hub Microsoft Entra ID als Identitätsanbieter verwendet, stellen Sie sicher, dass die VM, die mySQL Server-Ressourcenanbieter installiert, über ausgehende Internetverbindung verfügt.

Nächste Schritte

Hinzufügen von Hostingservern