Aktualizace poskytovatele prostředků MySQL ve službě Azure Stack Hub

Článek
03/20/2025

Důležitý

Od buildu 2108 služby Azure Stack Hub se poskytovatelé prostředků SQL a MySQL nabízejí předplatitelům s uděleným přístupem. Pokud chcete tuto funkci začít používat nebo pokud potřebujete upgradovat z předchozí verze, otevřete případ podpory a naši technici podpory vás provedou procesem nasazení nebo upgradu.

Důležitý

Před aktualizací poskytovatele prostředků si projděte poznámky k verzi a seznamte se s novými funkcemi, opravami a všemi známými problémy, které by mohly ovlivnit vaše nasazení. Poznámky k verzi také určují minimální verzi služby Azure Stack Hub vyžadovanou pro poskytovatele prostředků.

Důležitý

Aktualizace poskytovatele prostředků neaktualizuje hostující server MySQL.

Když Azure Stack Hub vydá nové sestavení, můžeme vydat nový adaptér poskytovatele prostředků MySQL. I když stávající adaptér stále funguje, doporučujeme co nejdříve aktualizovat na nejnovější build.

Podporovaná verze služby Azure Stack Hub	Verze MySQL RP	Windows Server, na kterém běží služba RP
2206, 2301, 2306, 2311	MySQL RP verze 2.0.13.x	Microsoft AzureStack Add-on RP Windows Server 1.2009.0
2108, 2206	MySQL RP verze 2.0.6.x	Microsoft AzureStack Add-on RP Windows Server 1.2009.0

Aktualizace poskytovatele prostředků MySQL Serveru V2

Pokud jste již nasadili mySQL RP V2 a chcete zkontrolovat aktualizace, zkontrolujte Jak použít aktualizace u poskytovatele prostředků.

Pokud chcete aktualizovat z mySQL RP V1 na MySQL RP V2, ujistěte se, že jste nejprve aktualizovali na MySQL RP V1.1.93.x a pak proveďte upgrade hlavní verze z mySQl RP V1 na MySQL RP V2.

Aktualizace z mySQL RP V1.1.93.x na MySQL RP V2.0.6.0

Požadavky

Ujistěte se, že aktualizujete RP MySQL V1 na nejnovější verzi 1.1.93.x. V části Výchozí předplatné poskytovatelevyhledejte skupinu prostředků RP (formát pojmenování: systém.<region>.mysqladapter). Potvrďte značku verze a název virtuálního počítače MySQL RP ve skupině prostředků. Pokud stále používáte starou verzi a potřebujete aktualizovat na verzi 1.1.93.x, otevřete případ podpory s žádostí o pomoc.
Otevřete případ podpory, abyste získali balíček MajorVersionUpgrade, a přidejte své předplatné do seznamu povolených pro ASH marketplace pro budoucí verzi V2.
Stáhněte si Microsoft AzureStack Add-On RP Windows Server 1.2009.0 na marketplace.

Ujistěte se, že vaše služba Azure Stack Hub splňuje požadavky na integraci datacentra.

Předpoklad	Odkaz
Podmíněné předávání DNS je správně nastavené.	integrace datacentra služby Azure Stack Hub – DNS
Příchozí porty pro poskytovatele prostředků jsou otevřené.	Integrace datacentra Azure Stack Hub – příchozí porty a protokoly
Subjekt certifikátu PKI a síť SAN jsou správně nastavené.	povinné PKI požadavky pro nasazení služby Azure Stack Hub požadavky na certifikát PaaS pro nasazení služby Azure Stack Hub

(pro odpojené prostředí) Nainstalujte požadované moduly PowerShellu, podobně jako proces aktualizace použitý k Nasazení poskytovatele prostředků MySQL.
Připravte URI konektoru MySQL s požadovanou verzí. Podrobnosti najdete v tématu Nasazení poskytovatele prostředků MySQL. například https://<storageAccountName>.blob.<region>.<FQDN>/<název_kontejneru>/mysql-connector-net-8.0.21.msi

Spustit HlavníAktualizaciVerze

Spuštěním následujícího skriptu z konzoly PowerShellu se zvýšenými oprávněními proveďte upgrade hlavní verze.

Poznámka

Ujistěte se, že klientský počítač, na který spouštíte skript, má verzi operačního systému starší než Windows 10 nebo Windows Server 2016 a klientský počítač má architekturu operačního systému X64.

Důležitý

Před spuštěním skriptu nasazení nebo aktualizace důrazně doporučujeme použít Clear-AzureRmContext -Scope CurrentUser a Clear-AzureRmContext -Scope Process vymazat mezipaměť.

# Check Operating System version
$osVersion = [environment]::OSVersion.Version
if ($osVersion.Build -lt 10240)
{
    Write-Host "OS version is too old: $osVersion."
    return
}

$osArch = (Get-WmiObject Win32_OperatingSystem).OSArchitecture
if ($osArch -ne "64-bit")
{
    Write-Host "OS Architecture is not 64 bit."
    return
}

# Check LongPathsEnabled registry key
$regPath = 'HKLM:\SYSTEM\CurrentControlSet\Control\FileSystem'
$longPathsEnabled = 'LongPathsEnabled'
$property = Get-ItemProperty -Path $regPath -Name $longPathsEnabled -ErrorAction Stop
if ($property.LongPathsEnabled -eq 0)
{
    Write-Host "Detect LongPathsEnabled equals to 0, prepare to set the property."
    Set-ItemProperty -Path $regPath -Name $longPathsEnabled -Value 1 -ErrorAction Stop
    Write-Host "Set the long paths property, please restart the PowerShell."
    return
} 

# Use the NetBIOS name for the Azure Stack Hub domain. 
$domain = "YouDomain" 
# For integrated systems, use the IP address of one of the ERCS VMs
$privilegedEndpoint = "YouDomain-ERCS01"
# Provide the Azure environment used for deploying Azure Stack Hub. Required only for Azure AD deployments. Supported values for the <environment name> parameter are AzureCloud, AzureChinaCloud, or AzureUSGovernment depending which Azure subscription you're using.
$AzureEnvironment = "AzureCloud"
# Point to the directory where the resource provider installation files were extracted.
$tempDir = 'C:\extracted-folder\MajorVersionUpgrade-MySQLRP'
# The service admin account can be Azure Active Directory or Active Directory Federation Services.
$serviceAdmin = "admin@mydomain.onmicrosoft.com"
$AdminPass = ConvertTo-SecureString 'xxxxxxxx' -AsPlainText -Force
$AdminCreds = New-Object System.Management.Automation.PSCredential ($serviceAdmin, $AdminPass)
# Add the cloudadmin credential that's required for privileged endpoint access.
$CloudAdminPass = ConvertTo-SecureString 'xxxxxxxx' -AsPlainText -Force
$CloudAdminCreds = New-Object System.Management.Automation.PSCredential ("$domain\cloudadmin", $CloudAdminPass)
# Change the following as appropriate.
$PfxPass = ConvertTo-SecureString 'xxxxxxx' -AsPlainText -Force
# Provide the pfx file path
$PfxFilePath = "C:\tools\mysqlcert\SSL.pfx"
# Local blob uri where stores the required mysql connector
$MySQLConnector = "Provide the MySQL Connector Uri according to Prerequisites step."
# PowerShell modules used by the RP MajorVersionUpgrade 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 
. $tempDir\MajorVersionUpgradeMySQLProvider.ps1 -AzureEnvironment $AzureEnvironment -AzCredential $AdminCreds -CloudAdminCredential $CloudAdminCreds -Privilegedendpoint $privilegedEndpoint -PfxPassword $PfxPass -PfxCert $PfxFilePath -MySQLConnector $MySQLConnector

Poznámka

Adresa DNS a odpovídající IP adresa RP MySQL V2 se liší. Pokud chcete získat novou veřejnou IP adresu, můžete kontaktovat podporu, abyste požádali o zahájení procedury DRP break glass a našli prostředek MySQLRPVM1130-PublicIP. Můžete také spustit "nslookup mysqlrp.dbadapter.<FQDN>" z klientského počítače, který už prošel testem koncového bodu, abyste zjistili veřejnou IP adresu.

Ověřte, že upgrade proběhl úspěšně

Skript MajorVersionUpgrade se spustil bez chyb.
Zkontrolujte poskytovatele prostředků na tržišti a ujistěte se, že byl úspěšně nainstalován MySQL RP 2.0.
Starý systém . Umístění<>.mysqladapter skupina prostředků a systém . Umístění<>.dbadapter.dns skupina prostředků ve výchozím předplatném poskytovatele nebude skriptem automaticky odstraněna.

Doporučujeme uchovávat účet úložiště a službu Key Vault ve skupině prostředků mysqladapter nějakou dobu. Pokud po upgradu jakýkoli uživatel tenanta pozoruje nekonzistentní databázi nebo přihlašovací metadata, může získat podporu na obnovení metadat ze skupiny prostředků.
Po ověření, že zóna DNS ve skupině prostředků dbadapter.dns je prázdná bez záznamu DNS, je bezpečné odstranit skupinu prostředků dbadapter.dns.
[DŮLEŽITÉ] K odinstalaci verze V1 nepoužívejte skript pro nasazení V1. Po dokončení upgradu a potvrzení úspěšného upgradu můžete skupinu prostředků z předplatného poskytovatele ručně odstranit.

Aktualizace ze starší verze MySQL RP V1 na MySQL RP V1.1.93.x

Aktualizace poskytovatele prostředků MySQL V1 je kumulativní. Přímo můžete aktualizovat na verzi 1.1.93.x.

Pokud chcete aktualizovat poskytovatele prostředků na verzi 1.1.93.x, použijte skript UpdateMySQLProvider.ps1. Použijte svůj účet služby s právy místního správce a je vlastníkem předplatného. Tento aktualizační skript je součástí staženého balíčku poskytovatele prostředků.

Pokud chcete aktualizovat poskytovatele prostředků, použijte skript UpdateMySQLProvider.ps1. Použijte svůj služební účet s právy místního správce a jako vlastník předplatného. Skript pro aktualizaci je součástí staženého balíčku poskytovatele prostředků.

Proces aktualizace se podobá procesu použitému k Nasazení poskytovatele prostředků. Aktualizační skript používá stejné argumenty jako DeployMySqlProvider.ps1 skript a budete muset zadat informace o certifikátu.

Aktualizace procesů skriptů

Skript UpdateMySQLProvider.ps1 vytvoří nový virtuální počítač s nejnovější imagí operačního systému, nasadí nejnovější kód zprostředkovatele prostředků a migruje nastavení ze starého poskytovatele prostředků na nového poskytovatele prostředků.

Poznámka

Doporučujeme stáhnout image Microsoft Azure Stack Add-on RP Windows Server 1.2009.0 ze správy Marketplace. Pokud potřebujete nainstalovat aktualizaci, můžete jeden balíček MSU umístit do místní cesty závislosti. Skript selže, pokud je v tomto umístění více než jeden soubor MSU.

Jakmile skript UpdateMySQLProvider.ps1 vytvoří nový virtuální počítač, skript migruje z původního virtuálního počítače poskytovatele prostředků následující nastavení:

informace o databázi
informace o hostitelském serveru
požadovaný záznam DNS

Důležitý

Před spuštěním skriptu nasazení nebo aktualizace důrazně doporučujeme použít Clear-AzureRmContext -Scope CurrentUser a Clear-AzureRmContext -Scope Process vymazat mezipaměť.

Aktualizace parametrů skriptu

Při spuštění skriptu powershellu UpdateMySQLProvider.ps1 zadejte následující parametry z příkazového řádku. Pokud ne, nebo pokud se ověření nějakého parametru nezdaří, zobrazí se výzva k zadání požadovaných parametrů.

Název parametru	Popis	Komentář nebo výchozí hodnota
CloudAdminCredential	Přihlašovací údaje pro správce cloudu, které jsou nezbytné pro přístup k privilegovanému koncovému bodu.	povinné
AzCredential	Přihlašovací údaje pro účet správce služby Azure Stack Hub. Použijte stejné přihlašovací údaje, které jste použili k nasazení služby Azure Stack Hub. Skript selže, pokud účet, který používáte s AzCredential, vyžaduje vícefaktorové ověřování (MFA).	povinné
VMLocalCredential	Přihlašovací údaje pro účet místního správce virtuálního počítače poskytovatele prostředků MySQL.	povinné
PrivilegedEndpoint	IP adresa nebo název DNS privilegovaného koncového bodu.	povinné
AzureEnvironment	Prostředí Azure účtu správce služby používaného k nasazení služby Azure Stack Hub. Vyžaduje se pouze pro nasazení Microsoft Entra. Podporované názvy prostředí jsou AzureCloudu, AzureUSGovernment, nebo pokud používáte čínské Microsoft Entra ID, AzureChinaCloud.	AzureCloud
DependencyFilesLocalPath	Soubor .pfx certifikátu musí být také umístěn v tomto adresáři.	volitelné (povinné pro více uzlů)
VýchozíHesloProSSLCertifikát	Heslo pro certifikát .pfx.	povinné
MaxRetryCount	Kolikrát chcete každou operaci zopakovat, pokud dojde k selhání.	2
Doba opakování	Interval časového limitu mezi opakovanými pokusy v sekundách.	120
Odinstalovat	Odeberte poskytovatele prostředků a všechny přidružené prostředky (viz následující poznámky).	Ne
DebugMode	Zabraňuje automatickému vyčištění při selhání.	Ne
Přijmout licenci	Přeskočí výzvu k přijetí licence GPL. (https://www.gnu.org/licenses/old-licenses/gpl-2.0.html)

Příklad aktualizace skriptu

Pokud aktualizujete verzi poskytovatele prostředků MySQL na verzi 1.1.33.0 nebo předchozí verze, musíte v PowerShellu nainstalovat konkrétní verze modulů AzureRm.BootStrapper a Azure Stack Hub.

Pokud aktualizujete poskytovatele prostředků MySQL na verzi 1.1.47.0 nebo novější, můžete tento krok přeskočit. Skript nasazení automaticky stáhne a nainstaluje potřebné moduly PowerShellu pro cestu C:\Program Files\SqlMySqlPsh.

Poznámka

Pokud složka C:\Program Files\SqlMySqlPsh již existuje se staženým modulem PowerShellu, doporučujeme tuto složku před spuštěním aktualizačního skriptu vyčistit. Ujistěte se, že se stáhne a použije správná verze modulu PowerShellu.

# Run the following scripts when updating to version 1.1.33.0 only.
# 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

Poznámka

V odpojené situaci musíte stáhnout požadované moduly PowerShellu a zaregistrovat úložiště ručně jako předpoklad. Další informace najdete v sekci nasazení poskytovatele prostředků MySQL

Následující příklad ukazuje UpdateMySQLProvider.ps1 skript, který můžete spustit z konzoly PowerShellu se zvýšenými oprávněními. Nezapomeňte změnit proměnné a hesla dle potřeby.

# 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 credentials for the new resource provider VM.
$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 directory to the folder where you extracted the installation files.
# Then adjust the endpoints.
.$tempDir\UpdateMySQLProvider.ps1 -AzCredential $AdminCreds -VMLocalCredential $vmLocalAdminCreds -CloudAdminCredential $cloudAdminCreds -PrivilegedEndpoint $privilegedEndpoint -AzureEnvironment $AzureEnvironment -DefaultSSLCertificatePassword $PfxPass -DependencyFilesLocalPath $tempDir\cert -AcceptLicense

Po dokončení skriptu aktualizace poskytovatele prostředků zavřete aktuální relaci PowerShell.

Další kroky

Udržovat poskytovatele prostředků MySQL

Sdílet prostřednictvím

Aktualizace poskytovatele prostředků MySQL ve službě Azure Stack Hub

Aktualizace poskytovatele prostředků MySQL Serveru V2

Aktualizace z mySQL RP V1.1.93.x na MySQL RP V2.0.6.0

Požadavky

Spustit HlavníAktualizaciVerze

Ověřte, že upgrade proběhl úspěšně

Aktualizace ze starší verze MySQL RP V1 na MySQL RP V1.1.93.x

Aktualizace procesů skriptů

Aktualizace parametrů skriptu

Příklad aktualizace skriptu

Další kroky

Váš názor

Další materiály