Wdrażanie dostawcy zasobów MySQL w usłudze Azure Stack Hub

Ważny

Począwszy od kompilacji 2108 usługi Azure Stack Hub, dostawcy zasobów SQL i MySQL są oferowani subskrypcjom, którym udzielono dostępu. Jeśli chcesz rozpocząć korzystanie z tej funkcji lub jeśli chcesz przeprowadzić uaktualnienie z poprzedniej wersji, otworzyć zgłoszenie do pomocy technicznej, a nasi inżynierowie pomocy technicznej przeprowadzą Cię przez proces wdrażania lub uaktualniania.

Użyj dostawcy zasobów serwera MySQL, aby udostępnić bazy danych MySQL jako usługę Azure Stack Hub.

Dostawca zasobów MySQL działa jako usługa na specjalnym serwerze dodatku Windows Server RP.

Ważny

Tylko dostawca zasobów powinien tworzyć elementy na serwerach hostujących program SQL lub MySQL. Elementy utworzone na serwerze hosta, które nie są tworzone przez dostawcę zasobów, są nieobsługiwane i mogą powodować niezgodność stanu.

Warunki wstępne

Jeśli masz już zainstalowanego dostawcę zasobów, prawdopodobnie zostały spełnione następujące wymagania wstępne i możesz pominąć tę sekcję. W przeciwnym razie przed kontynuowaniem wykonaj następujące kroki:

1. Zarejestruj swoje wystąpienie usługi Azure Stack Hub w usłudze Azure, jeśli jeszcze tego nie zrobiłeś/aś. Ten krok jest wymagany, ponieważ nawiąż połączenie z witryną Marketplace i pobierzesz elementy z platformy Azure.

2. Jeśli nie znasz funkcji zarządzania witryną Marketplace portalu administratora usługi Azure Stack Hub, zapoznaj się z artykułem Pobieranie elementów witryny Marketplace z platformy Azure i publikowanie ich w usłudze Azure Stack Hub. W tym artykule przedstawiono proces pobierania elementów z platformy Azure do witryny Azure Stack Hub Marketplace. Obejmuje zarówno scenariusze połączone, jak i rozłączone. Jeśli instancja usługi Azure Stack Hub jest odłączona lub częściowo połączona, należy spełnić dodatkowe wymagania wstępne, aby przygotować się do instalacji.

3. Zaktualizuj katalog główny firmy Microsoft Entra. Począwszy od kompilacji 1910, nowa aplikacja musi być zarejestrowana w dzierżawie katalogu macierzystego. Ta aplikacja umożliwi usłudze Azure Stack Hub pomyślne utworzenie i zarejestrowanie nowszych dostawców zasobów (takich jak Event Hubs i inne) w dzierżawie firmy Microsoft Entra. Jest to jednorazowa czynność, którą należy wykonać po uaktualnieniu do kompilacji 1910 lub nowszej. Jeśli ten krok nie zostanie ukończony, instalacje dostawcy zasobów platformy Handlowej nie powiedzą się.

   • Po pomyślnym zaktualizowaniu wystąpienia usługi Azure Stack Hub do wersji 1910 lub nowszej postępuj zgodnie z instrukcjami dotyczącymi klonowania/pobierania repozytorium azure Stack Hub Tools.
   • Następnie postępuj zgodnie z instrukcjami dotyczącymi aktualizowania katalogu głównego Microsoft Entra Directory na platformie Azure Stack Hub (po zainstalowaniu aktualizacji lub nowych dostawców zasobów).

Wymagania wstępne dostawcy zasobów serwera MySQL

• Potrzebny będzie komputer i konto, do którego można uzyskać dostęp:

  • portalu administratora usługi Azure Stack Hub.
  • uprzywilejowanego punktu końcowego (wymagane tylko w przypadku wdrażania dostawcy zasobów serwera MySQL w wersji 1 lub uaktualniania dostawcy zasobów serwera MySQL Server V1 do dostawcy zasobów serwera MySQL w wersji 2).
  • punkt końcowy administratora usługi Azure Resource Manager, https://adminmanagement.region.<fqdn>, gdzie <fqdn> jest w pełni kwalifikowaną nazwą domeny.
  • w Internecie, jeśli usługa Azure Stack Hub została wdrożona w celu używania identyfikatora Entra firmy Microsoft jako dostawcy tożsamości.

• Pobierz obsługiwaną wersję pliku binarnego dostawcy zasobów MySQL zgodnie z poniższą tabelą mapowania wersji. W przypadku dostawcy zasobów MySQL w wersji 2 pobierz element z witryny Marketplace do usługi Azure Stack Hub.

  Obsługiwana wersja usługi Azure Stack Hub	Wersja dostawcy usługi MySQL	System Windows Server, na którym działa usługa RP
  2206, 2301, 2306, 2311	MySQL RP w wersji 2.0.13.x	Dodatek Microsoft AzureStack RP dla systemu Windows Server 1.2009.0
  2108, 2206	MySQL RP w wersji 2.0.6.x	Dodatek Microsoft AzureStack RP dla systemu Windows Server 1.2009.0

• Upewnij się, że wymagana maszyna wirtualna z systemem Windows Server została pobrana do witryny Azure Stack Hub Marketplace. W razie potrzeby ręcznie pobierz obraz zgodnie z tabelą mapowania wersji powyżej.

• Upewnij się, że zostały spełnione wymagania wstępne dotyczące integracji centrum danych:R

  Warunek wstępny	Odniesienie
  Warunkowe przekazywanie DNS jest poprawnie ustawione.	integracja centrum danych usługi Azure Stack Hub — DNS
  Porty przychodzące dla dostawców zasobów są otwarte.	Integracja centrum danych Azure Stack Hub - publikowanie punktów końcowych
  Podmiot certyfikatu PKI i sieć SAN są poprawnie ustawione.	obowiązkowe wymagania dotyczące wdrażania infrastruktury klucza publicznego Azure Stack Hubwymagania dotyczące certyfikatu PaaS dla wdrożenia Azure Stack Hub

• Przygotuj certyfikat. (W przypadku instalacji zintegrowanych systemów tylko.

  • Należy podać certyfikat PKI SQL PaaS opisany w opcjonalnej sekcji dotyczącej Certyfikatów PaaS w wymaganiach dotyczących PKI wdrożenia Azure Stack Hub . Alternatywna nazwa podmiotu (SAN) musi być zgodna z następującym wzorcem nazewnictwa: CN=*.dbadapter.<region>.<fqdn>, chroniony hasłem.
  • Podczas wdrażania dostawcy zasobów serwera MySQL V1 umieść plik pfx w lokalizacji określonej przez parametr DependencyFilesLocalPath. Nie udostępniaj certyfikatu dla systemów ASDK.
  • Podczas wdrażania dostawcy zasobów serwera MySQL w wersji 2 przygotuj certyfikat do wykonania poniższych kroków instalacji.

Scenariusz bez połączenia

Podczas wdrażania dostawcy zasobów serwera MySQL w wersji 2 w scenariuszu offline postępuj zgodnie z instrukcjami pobierania elementów Marketplace do usługi Azure Stack Hub, aby pobrać element dostawcy zasobów serwera MySQL i element Windows Server dodatku RP do środowiska usługi Azure Stack Hub.

Podczas wdrażania dostawcy zasobów serwera MySQL w wersji 1 w scenariuszu bez połączenia wykonaj następujące kroki, aby pobrać wymagane moduły programu PowerShell i ręcznie zarejestrować repozytorium.

1. Zaloguj się do komputera z łącznością z Internetem i użyj poniższych skryptów, aby pobrać moduły programu PowerShell.

   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. W zależności od wersji wdrażanego dostawcy zasobów uruchom jeden ze skryptów.

   # 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. Następnie skopiuj pobrane pakiety do urządzenia USB.

4. Zaloguj się do odłączonej stacji roboczej i skopiuj pakiety z urządzenia USB do lokalizacji na stacji roboczej.

5. Zarejestruj tę lokalizację jako repozytorium lokalne.

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

Wdrażanie dostawcy zasobów MySQL w wersji 2

W przypadku uaktualniania z wersji V1 zapoznaj się z dokumentem Aktualizowanie dostawcy zasobów serwera MySQL.

Rozpocznij instalację

1. Jeśli jeszcze tego nie zrobiłeś, zaloguj się do portalu administratora usługi Azure Stack Hub, wybierz opcję Marketplace Management po lewej stronie, a następnie wybierz opcję Dostawcy zasobów.

2. Po pobraniu dostawcy zasobów MySQL i innego wymaganego oprogramowania Marketplace Management wyświetla pakiety "Dostawca zasobów serwera MySQL" ze stanem "Nie zainstalowano". Mogą istnieć inne pakiety, których stan jest "Pobrane".

   

3. Wybierz wiersz, który chcesz zainstalować. Strona pakietu instalacyjnego dostawcy zasobów serwera MySQL zawiera niebieski transparent u góry. Wybierz baner, aby rozpocząć instalację.

Instalowanie wymagań wstępnych

1. Następnie zostaniesz przeniesiony na stronę instalacji. Wybierz pozycję Zainstaluj wymagania wstępne, aby rozpocząć proces instalacji.

2. Poczekaj, aż instalacja wymagań wstępnych zakończy się pomyślnie. Przed przejściem do następnego kroku powinieneś zobaczyć zielony znacznik wyboru obok Zainstaluj wymagania wstępne.

Przygotuj tajemnice

1. Pod 2. Przygotuj wpisy tajne kroku, wybierz pozycję Dodaj certyfikat, a zostanie wyświetlony panel Dodawanie certyfikatu .

2. Wybierz przycisk przeglądania w Dodaj certyfikat, po prawej stronie pola nazwy pliku certyfikatu. Wybierz plik certyfikatu pfx pozyskany podczas wykonywania wymagań wstępnych.

3. Wprowadź podane hasło, aby utworzyć bezpieczny ciąg dla certyfikatu SSL dostawcy zasobów programu SQL Server. Następnie wybierz pozycję Dodaj.

Konfigurowanie i instalowanie dostawcy zasobów

1. Po pomyślnym zakończeniu instalacji certyfikatu powinien zostać wyświetlony zielony znacznik wyboru obok Przygotuj tajne dane przed przejściem do następnego kroku. Teraz wybierz przycisk Konfiguruj i zainstaluj obok pozycji 3 Zainstaluj dostawcę zasobów.

2. Następnie należy podać identyfikator URI obiektu blob usługi Azure Stack Hub dla łącznika MySQL.

   • Zapoznaj się z licencją GPL łącznika MySQL tutaj i pobierz wersję 8.0.21 do folderu lokalnego.

   • Utwórz konto magazynu z domyślną subskrypcją twojego operatora i utwórz kontener z poziomem dostępu „Blob” lub „Kontener”.

   • Prześlij plik mysql-connector-net-8.0.21.msi z folderu lokalnego do nowo utworzonego kontenera przechowywania.

   Ważny

   Upewnij się, że wersja łącznika MySQL to 8.0.21.

   • Skopiuj identyfikator URI obiektu blob.

   • Wróć do strony konfiguracji MySQL RP. Wklej URI obiektu blob (np. https://<storageAccountName>.blob.<region>.<FQDN>/<containerName>/mysql-connector-net-8.0.21.msi) w polu tekstowym i kliknij OK.

3. Następnie zostanie wyświetlona następująca strona, która wskazuje, że dostawca zasobów MySQL jest instalowany.

4. Poczekaj na powiadomienie o zakończeniu instalacji. Ten proces zwykle trwa co najmniej jedną godzinę, w zależności od typu usługi Azure Stack Hub.

5. Sprawdź, czy instalacja dostawcy zasobów serwera MySQL zakończyła się pomyślnie, wracając do strony Marketplace Management, dostawcy zasobów. Stan dostawcy zasobów serwera MySQL powinien zawierać wartość "Zainstalowano".

Wdrażanie dostawcy zasobów SQL w wersji 1

Po zakończeniu wszystkich wymagań wstępnych uruchom narzędzie do samodzielnego wyodrębniania, aby wyodrębnić pobrany pakiet instalacyjny do katalogu tymczasowego. Uruchom skrypt DeployMySqlProvider.ps1 z komputera, który może uzyskać dostęp do punktu końcowego administratora usługi Azure Resource Manager w usłudze Azure Stack Hub i uprzywilejowanego punktu końcowego, aby wdrożyć dostawcę zasobów MySQL. Skrypt DeployMySqlProvider.ps1 jest wyodrębniany jako część plików instalacyjnych dostawcy zasobów MySQL pobranych dla używanej wersji usługi Azure Stack Hub.

Ważny

Przed wdrożeniem dostawcy zasobów przejrzyj informacje o wersji, aby dowiedzieć się więcej o nowych funkcjach, poprawkach i znanych problemach, które mogą mieć wpływ na wdrożenie.

Aby wdrożyć dostawcę zasobów MySQL, otwórz nowy okno programu PowerShell z podwyższonym poziomem uprawnień (a nie program PowerShell ISE) i przejdź do katalogu, w którym wyodrębniono pliki binarne dostawcy zasobów MySQL.

Ważny

Zdecydowanie zalecamy użycie Clear-AzureRmContext -Scope CurrentUser i Clear-AzureRmContext -Scope Process w celu wyczyszczenia pamięci podręcznej przed uruchomieniem skryptu wdrożenia lub aktualizacji.

Notatka

Jeśli wdrażasz dostawcę zasobów serwera MySQL w wersji 1 w środowisku odłączonym, skopiuj plik mysql-connector-net-6.10.5.msi do ścieżki lokalnej. Podaj nazwę ścieżki przy użyciu parametru DependencyFilesLocalPath.

Uruchom skrypt DeployMySqlProvider.ps1, który wykonuje następujące zadania:

• Przekazuje certyfikaty i inne artefakty do konta magazynu w usłudze Azure Stack Hub.
• Publikuje pakiety galerii, aby można było wdrażać bazy danych MySQL przy użyciu galerii.
• Publikuje pakiet galerii na potrzeby wdrażania serwerów hostingu.
• Wdraża maszynę wirtualną przy użyciu obrazu Windows Server 2016 Core lub obrazu Windows Server dla dodatku Microsoft AzureStack RP, który pobrano, a następnie instaluje dostawcę zasobów MySQL.
• Rejestruje lokalny rekord DNS powiązany z maszyną wirtualną dostawcy usług.
• Rejestruje dostawcę zasobów w lokalnym Azure Resource Manager dla konta operatora.

Notatka

Po uruchomieniu wdrożenia dostawcy zasobów MySQL zostanie utworzona grupa zasobów system.local.mysqladapter. Ukończenie wdrożeń wymaganych do tej grupy zasobów może potrwać do 75 minut. Nie należy umieszczać żadnych innych zasobów w system.local.mysqladapter grupie zasobów.

parametry DeployMySqlProvider.ps1

Te parametry można określić w wierszu polecenia. Jeśli nie, lub jeśli sprawdzanie poprawności jakiegokolwiek parametru zakończy się niepowodzeniem, zostanie wyświetlony monit o podanie wymaganych parametrów.

Nazwa parametru	Opis	Komentarz lub wartość domyślna
CloudAdminCredential	Poświadczenia administratora chmury niezbędne do uzyskania dostępu do uprzywilejowanego punktu końcowego.	wymagane
AzCredential	Poświadczenia konta administratora usługi Azure Stack Hub. Użyj tych samych poświadczeń, które zostały użyte do wdrożenia usługi Azure Stack Hub. Skrypt nie powiedzie się, jeśli konto używane z AzCredential wymaga uwierzytelniania wieloskładnikowego (MFA).	wymagane
VMLocalCredential	Poświadczenia dla lokalnego konta administratora maszyny wirtualnej dostawcy zasobów MySQL.	wymagane
PrivilegedEndpoint	Adres IP lub nazwa DNS uprzywilejowanego punktu końcowego.	wymagane
AzureEnvironment	Środowisko platformy Azure konta administratora usługi używane do wdrażania usługi Azure Stack Hub. Wymagane tylko w przypadku wdrożeń Microsoft Entra. Obsługiwane nazwy środowisk to AzureCloud, AzureUSGovernmentlub w przypadku korzystania z identyfikatora Entra firmy Microsoft w Chinach AzureChinaCloud.	AzureCloud
DependencyFilesLocalPath	Tylko w przypadku systemów zintegrowanych plik pfx certyfikatu musi zostać umieszczony w tym katalogu. W przypadku środowisk bez połączenia pobierz mysql-connector-net-6.10.5.msi do tego katalogu. Opcjonalnie możesz skopiować jeden pakiet MSU usługi Windows Update tutaj.	opcjonalne (obowiązkowe dla zintegrowanych systemów lub środowisk bez połączenia)
DefaultSSLCertificatePassword	Hasło certyfikatu pfx.	wymagane
MaxRetryCount	Ile razy chcesz ponowić próbę wykonania każdej operacji, jeśli wystąpi błąd.	2
pl-PL: czasPonowienia	Interwał limitu czasu między ponowną próbą w sekundach.	120
Odinstaluj	Usuwa dostawcę zasobów i wszystkie skojarzone zasoby (zobacz następujące uwagi).	Nie
Tryb debugowania	Zapobiega automatycznemu czyszczeniu po awarii.	Nie
AkceptujLicencję	Pomija monit o zaakceptowanie licencji GPL. https://www.gnu.org/licenses/old-licenses/gpl-2.0.html

Wdrażanie dostawcy zasobów MySQL przy użyciu skryptu niestandardowego

Jeśli wdrażasz dostawcę zasobów MySQL w wersji 1.1.47.0 lub nowszej, skrypt wdrażania automatycznie pobierze i zainstaluje niezbędne moduły programu PowerShell do ścieżki 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

Notatka

W scenariuszu bez połączenia należy pobrać wymagane moduły programu PowerShell i ręcznie zarejestrować repozytorium jako wymaganie wstępne.

Aby wyeliminować konfigurację ręczną podczas wdrażania dostawcy zasobów, możesz dostosować następujący skrypt. Zmień domyślne informacje o koncie i hasła zgodnie z potrzebami dla wdrożenia usługi 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 zakończeniu skryptu instalacji dostawcy zasobów odśwież przeglądarkę, aby upewnić się, że są widoczne najnowsze aktualizacje i zamknij bieżącą sesję programu PowerShell.

Weryfikowanie wdrożenia w wersji 1 przy użyciu portalu usługi Azure Stack Hub

1. Zaloguj się do portalu administratora jako administrator usługi.
2. Wybierz grupy zasobów.
3. Wybierz system .<lokalizacji>.mysqladapter grupy zasobów.
4. Na stronie podsumowania przeglądu grupy zasobów nie powinno być wdrożeń, które zakończyły się niepowodzeniem.
5. Na koniec wybierz pozycję Maszyny wirtualne w portalu administratora, aby sprawdzić, czy maszyna wirtualna dostawcy zasobów MySQL została pomyślnie utworzona i uruchomiona.

Ważna konfiguracja identyfikatora Entra firmy Microsoft

Jeśli usługa Azure Stack Hub używa identyfikatora Entra firmy Microsoft jako dostawcy tożsamości, upewnij się, że maszyna wirtualna, która zainstalowała dostawcę zasobów serwera MySQL, ma wychodzącą łączność z Internetem.

Jeśli istnieje potrzeba uzyskania IP maszyny wirtualnej, na której zainstalowano dostawcę zasobów serwera MySQL (tj. dodaj adres IP do listy dozwolonych adresów w zaporze), należy otworzyć zgłoszenie do pomocy technicznej i poprosić inżyniera pomocy technicznej o tymczasowe umożliwienie widoczności subskrypcji dostawcy zasobów serwera MySQL. Następnie możesz zlokalizować maszynę wirtualną w subskrypcji i uzyskać jej adres IP.

Następne kroki

Dodawanie serwerów hostingu