Nasazení poskytovatele prostředků MySQL do centra Azure StackDeploy the MySQL resource provider on Azure Stack Hub

Pomocí poskytovatele prostředků serveru MySQL můžete zveřejnit databáze MySQL jako službu Azure Stack hub.Use the MySQL Server resource provider to expose MySQL databases as an Azure Stack Hub service. Poskytovatel prostředků MySQL se spouští jako služba na virtuálním počítači se systémem Windows Server 2016 Server Core (pro verzi adaptéru <= 1.1.47.0>) nebo speciálním doplňku RP Windows serveru (pro verzi adaptéru >= 1.1.93.0).The MySQL resource provider runs as a service on a Windows Server 2016 Server Core virtual machine (for adapter version <= 1.1.47.0>) or a special Add-on RP Windows Server (for adapter version >= 1.1.93.0).

Důležité

Pouze poskytovatel prostředků by měl vytvořit položky na serverech, které jsou hostiteli SQL nebo MySQL.Only the resource provider should create items on servers that host SQL or MySQL. Položky vytvořené na hostitelském serveru, které nejsou vytvořené poskytovatelem prostředků, nejsou podporované a můžou mít za následek neshodné stavy.Items created on a host server that aren't created by the resource provider are unsupported, and may result in a mismatched state.

PožadavkyPrerequisites

Aby bylo možné nasadit poskytovatele prostředků MySQL Azure Stack hub, je nutné, aby bylo provedeno několik požadavků:There are several prerequisites that need to be in place before you can deploy the Azure Stack Hub MySQL resource provider:

  • Budete potřebovat počítač a účet, který má přístup:You'll need a computer and account that can access:

    • portál pro správu centra Azure Stack.the Azure Stack Hub administrator portal.
    • privilegovaný koncový bod.the privileged endpoint.
    • koncový bod správce Azure Resource Manager, https://management.region.<fqdn> kde <fqdn> je plně kvalifikovaný název domény (nebo https://management.local.azurestack.external Pokud používáte ASDK)the Azure Resource Manager admin endpoint, https://management.region.<fqdn>, where <fqdn> is your fully qualified domain name (or https://management.local.azurestack.external if using the ASDK)
    • Internet, pokud je váš rozbočovač Azure Stack nasazený tak, aby jako poskytovatele identity používal Azure Active Directory (AD).the Internet, if your Azure Stack Hub was deployed to use Azure Active Directory (AD) as your identity provider.
  • Pokud jste to ještě neudělali, zaregistrujte Azure Stack centrum s Azure, abyste si mohli stáhnout Azure Marketplace položky.If you haven't already, register Azure Stack Hub with Azure so you can download Azure Marketplace items.

  • Přidejte požadovaný virtuální počítač s Windows serverem do centra Azure Stack Marketplace.Add the required Windows Server VM to Azure Stack Hub Marketplace.

    • Pro MySQL RP verze <= 1.1.47.0 stáhněte bitovou kopii systému Windows server 2016 Datacenter-Server .For MySQL RP version <= 1.1.47.0, download the Windows Server 2016 Datacenter - Server Core image.
    • Pro MySQL RP verze >= 1.1.93.0 Stáhněte image Windows serveru Microsoft AzureStack Add-On RP .For MySQL RP version >= 1.1.93.0, download the Microsoft AzureStack Add-On RP Windows Server image. Tato verze Windows serveru je specializovaná pro Azure Stack infrastrukturu Add-On RP a není viditelná pro tržiště tenanta.This Windows Server version is specialize for Azure Stack Add-On RP Infrastructure and it is not visible to the tenant marketplace.
  • Stáhněte si podporovanou verzi binárního poskytovatele prostředků MySQL podle níže uvedené tabulky mapování verzí.Download the supported version of MySQL resource provider binary according to the version mapping table below. Spusťte samočinného extrahování pro extrakci staženého obsahu do dočasného adresáře.Run the self-extractor to extract the downloaded contents to a temporary directory.

    Podporovaná verze centra Azure StackSupported Azure Stack Hub version Verze MySQL RPMySQL RP version Windows Server, na kterém běží služba RPWindows Server that RP service is running on
    2008, 20052008, 2005 MySQL RP verze 1.1.93.1MySQL RP version 1.1.93.1 Microsoft AzureStack Add-on RP Windows ServerMicrosoft AzureStack Add-on RP Windows Server
    2005, 2002, 19102005, 2002, 1910 MySQL RP verze 1.1.47.0MySQL RP version 1.1.47.0 Windows Server 2016 Datacenter – jádro serveruWindows Server 2016 Datacenter - Server Core
    19081908 MySQL RP verze 1.1.33.0MySQL RP version 1.1.33.0 Windows Server 2016 Datacenter – jádro serveruWindows Server 2016 Datacenter - Server Core

Poznámka

Chcete-li nasadit poskytovatele MySQL v systému, který nemá přístup k Internetu, zkopírujte soubor mysql-connector-net-6.10.5.msi do místní cesty.To deploy the MySQL provider on a system that doesn't have internet access, copy the mysql-connector-net-6.10.5.msi file to a local path. Zadejte název cesty pomocí parametru DependencyFilesLocalPath .Provide the path name using the DependencyFilesLocalPath parameter.

V odpojeném scénáři proveďte následující kroky a stáhněte požadované moduly PowerShellu a zaregistrujte úložiště ručně.In a disconnected scenario, complete the following steps to download the required PowerShell modules and register the repository manually.

  1. Přihlaste se k počítači s připojením k Internetu a pomocí následujících skriptů si stáhněte moduly PowerShellu.Sign in to a computer with internet connectivity and use the following scripts to download the PowerShell modules.
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"
  1. V závislosti na verzi poskytovatele prostředků, který nasazujete, spusťte jeden ze skriptů.Depending on the version of resource provider that you are deploying, run one of the scripts.
# 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
  1. Stažené balíčky pak zkopírujete do zařízení USB.Then you copy the downloaded packages to a USB device.

  2. Přihlaste se k odpojené pracovní stanici a zkopírujte balíčky ze zařízení USB do umístění v pracovní stanici.Sign in to the disconnected workstation and copy the packages from the USB device to a location on the workstation.

  3. Zaregistrujte toto umístění jako místní úložiště.Register this location as a local 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" 

CertifikátyCertificates

Pouze pro instalace integrovaných systémů.For integrated systems installations only. Musíte zadat certifikát PKI SQL PaaS, který je popsaný v části volitelné certifikáty PaaS v tématu požadavky na infrastrukturu veřejných klíčů nasazení v centru Azure Stack.You must provide the SQL PaaS PKI certificate described in the optional PaaS certificates section of Azure Stack Hub deployment PKI requirements. Soubor. pfx umístěte do umístění zadaného parametrem DependencyFilesLocalPath .Place the .pfx file in the location specified by the DependencyFilesLocalPath parameter. Neposkytněte certifikát pro systémy ASDK.Don't provide a certificate for ASDK systems.

Nasazení poskytovatele prostředkůDeploy the resource provider

Po dokončení všech požadovaných součástí můžete skript DeployMySqlProvider.ps1 spustit z počítače, který má přístup ke koncovému bodu správce služby Azure Stack Azure Resource Manager hub a k privilegovanému koncovému bodu pro nasazení poskytovatele prostředků MySQL.After you've completed all of the prerequisites, you can run the DeployMySqlProvider.ps1 script from a computer that can access both the Azure Stack Hub Azure Resource Manager admin endpoint and the privileged endpoint, to deploy the MySQL resource provider. Skript DeployMySqlProvider.ps1 se extrahuje jako součást instalačních souborů poskytovatele prostředků MySQL, které jste stáhli pro vaši verzi centra Azure Stack.The DeployMySqlProvider.ps1 script is extracted as part of the MySQL resource provider installation files that you downloaded for your version of Azure Stack Hub.

Důležité

Před nasazením poskytovatele prostředků si přečtěte poznámky k verzi, kde najdete informace o nových funkcích, opravách a známých problémech, které by mohly mít vliv na nasazení.Before deploying the resource provider, review the release notes to learn about new functionality, fixes, and any known issues that could affect your deployment.

Pokud chcete nasadit poskytovatele prostředků MySQL, otevřete nové okno prostředí PowerShell se zvýšenými oprávněními (ne PowerShell ISE) a přejděte do adresáře, do kterého jste extrahovali binární soubory poskytovatele prostředků MySQL.To deploy the MySQL resource provider, open a new elevated PowerShell window (not PowerShell ISE) and change to the directory where you extracted the MySQL resource provider binary files.

Důležité

Důrazně doporučujeme, abyste před spuštěním aktualizačního skriptu vymazali mezipaměť clear-AzureRmContext-Scope CurrentUser a clear-AzureRmContext-Scope .We strongly recommend using Clear-AzureRmContext -Scope CurrentUser and Clear-AzureRmContext -Scope Process to clear the cache before running the update script.

Spusťte skript DeployMySqlProvider.ps1 , který dokončí následující úkoly:Run the DeployMySqlProvider.ps1 script, which completes the following tasks:

  • Nahraje certifikáty a jiné artefakty do účtu úložiště v Azure Stackovém centru.Uploads the certificates and other artifacts to a storage account on Azure Stack Hub.
  • Publikuje balíčky galerie, aby bylo možné nasadit databáze MySQL pomocí galerie.Publishes gallery packages so that you can deploy MySQL databases using the gallery.
  • Publikuje balíček galerie pro nasazení hostitelských serverů.Publishes a gallery package for deploying hosting servers.
  • Nasadí virtuální počítač pomocí image Windows serveru 2016 Core Image nebo image Windows serveru pro doplňky Microsoft AzureStack, kterou jste stáhli, a potom nainstaluje poskytovatele prostředků MySQL.Deploys a VM using the Windows Server 2016 core image or Microsoft AzureStack Add-on RP Windows Server image you downloaded, and then installs the MySQL resource provider.
  • Zaregistruje místní záznam DNS, který se mapuje na váš virtuální počítač poskytovatele prostředků.Registers a local DNS record that maps to your resource provider VM.
  • Zaregistruje poskytovatele prostředků s místní Azure Resource Manager pro účet operátora.Registers your resource provider with the local Azure Resource Manager for the operator account.

Poznámka

Po spuštění nasazení poskytovatele prostředků MySQL se vytvoří skupina prostředků System. Local. mysqladapter .When the MySQL resource provider deployment starts, the system.local.mysqladapter resource group is created. Dokončení nasazení potřebných pro tuto skupinu prostředků může trvat až 75 minut.It may take up to 75 minutes to finish the deployments required to this resource group. Neměli byste umístit žádné další prostředky do skupiny prostředků System. Local. mysqladapter .You should not place any other resources in the system.local.mysqladapter resource group.

Parametry DeployMySqlProvider.ps1DeployMySqlProvider.ps1 parameters

Tyto parametry můžete zadat z příkazového řádku.You can specify these parameters from the command line. Pokud ne, nebo pokud se nějaké ověření parametru nepodaří, budete vyzváni k zadání požadovaných parametrů.If you don't, or if any parameter validation fails, you're prompted to provide the required parameters.

Název parametruParameter name DescriptionDescription Komentář nebo výchozí hodnotaComment or default value
CloudAdminCredentialCloudAdminCredential Přihlašovací údaje pro správce cloudu, které jsou nezbytné pro přístup k privilegovanému koncovému bodu.The credential for the cloud administrator, necessary for accessing the privileged endpoint. PovinnéRequired
AzCredentialAzCredential Přihlašovací údaje pro účet správce služby Azure Stack hub.The credentials for the Azure Stack Hub service admin account. Použijte stejné přihlašovací údaje, které jste použili k nasazení centra Azure Stack.Use the same credentials that you used for deploying Azure Stack Hub. Pokud účet, který používáte se službou AzCredential, vyžaduje vícefaktorové ověřování (MFA), skript se nezdaří.The script will fail if the account you use with AzCredential requires multi-factor authentication (MFA). PovinnéRequired
VMLocalCredentialVMLocalCredential Přihlašovací údaje pro účet místního správce virtuálního počítače poskytovatele prostředků MySQL.The credentials for the local administrator account of the MySQL resource provider VM. PovinnéRequired
PrivilegedEndpointPrivilegedEndpoint IP adresa nebo název DNS privilegovaného koncového bodu.The IP address or DNS name of the privileged endpoint. PovinnéRequired
AzureEnvironmentAzureEnvironment Prostředí Azure účtu správce služby používaného pro nasazení centra Azure Stack.The Azure environment of the service admin account used for deploying Azure Stack Hub. Vyžaduje se jenom pro nasazení Azure AD.Required only for Azure AD deployments. Podporované názvy prostředí jsou AzureCloud, AzureUSGovernment nebo, pokud používáte Čína Azure AD AzureChinaCloud.Supported environment names are AzureCloud, AzureUSGovernment, or if using a China Azure AD, AzureChinaCloud. AzureCloudAzureCloud
DependencyFilesLocalPathDependencyFilesLocalPath V případě pouze integrovaných systémů musí být soubor Certificate. pfx umístěn v tomto adresáři.For integrated systems only, your certificate .pfx file must be placed in this directory. V případě odpojených prostředí stáhněte mysql-connector-net-6.10.5.msi do tohoto adresáře.For disconnected environments, download mysql-connector-net-6.10.5.msi to this directory. Volitelně můžete zkopírovat jeden web Windows Update balíček MSU zde.You can optionally copy one Windows Update MSU package here. Volitelné (povinné pro integrované systémy nebo odpojená prostředí)Optional (mandatory for integrated systems or disconnected environments)
DefaultSSLCertificatePasswordDefaultSSLCertificatePassword Heslo pro certifikát. pfx.The password for the .pfx certificate. PovinnéRequired
MaxRetryCountMaxRetryCount Počet pokusů o opakování všech operací, pokud dojde k selhání.The number of times you want to retry each operation if there's a failure. 22
RetryDurationRetryDuration Interval časového limitu mezi opakovanými pokusy (v sekundách).The timeout interval between retries, in seconds. 120120
OdinstalaceUninstall Odebere poskytovatele prostředků a všechny přidružené prostředky (viz následující poznámky).Removes the resource provider and all associated resources (see the following notes). NeNo
DebugModeDebugMode Zabraňuje automatickému vyčištění při selhání.Prevents automatic cleanup on failure. NeNo
AcceptLicenseAcceptLicense Přeskočí výzvu k přijetí licence GPL.Skips the prompt to accept the GPL license. https://www.gnu.org/licenses/old-licenses/gpl-2.0.html

Nasazení poskytovatele prostředků MySQL pomocí vlastního skriptuDeploy the MySQL resource provider using a custom script

Pokud nasazujete poskytovatele prostředků MySQL verze 1.1.33.0 nebo předchozí verze, budete muset v PowerShellu nainstalovat konkrétní verze modulů AzureRm. zaváděcího nástroje a Azure Stack hub.If you are deploying the MySQL resource provider version 1.1.33.0 or previous versions, you need to install specific versions of AzureRm.BootStrapper and Azure Stack Hub modules in PowerShell. Pokud nasazujete poskytovatele prostředků MySQL verze 1.1.47.0 nebo novější, skript nasazení automaticky stáhne a nainstaluje potřebné moduly PowerShellu pro vás do cesty C:\Program Files\SqlMySqlPsh..If you are deploying the MySQL resource provider version 1.1.47.0 or later, the deployment script will automatically download and install the necessary PowerShell modules for you to path 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

Poznámka

V odpojeném scénáři je nutné stáhnout požadované moduly prostředí PowerShell a zaregistrovat úložiště ručně v rámci požadavků.In disconnected scenario, you need to download the required PowerShell modules and register the repository manually as a prerequisite.

Chcete-li při nasazování poskytovatele prostředků eliminovat jakoukoli ruční konfiguraci, můžete přizpůsobit následující skript.To eliminate any manual configuration when deploying the resource provider, you can customize the following script. Podle potřeby změňte výchozí informace o účtu a hesla pro nasazení centra Azure Stack.Change the default account information and passwords as needed for your Azure Stack Hub deployment.

# 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 dokončení instalačního skriptu poskytovatele prostředků aktualizujte prohlížeč, abyste se ujistili, že vidíte nejnovější aktualizace a zavřete aktuální relaci PowerShellu.When the resource provider installation script finishes, refresh your browser to make sure you can see the latest updates and close the current PowerShell session.

Ověření nasazení pomocí portálu Azure Stack hubVerify the deployment by using the Azure Stack Hub portal

  1. Přihlaste se k portálu pro správu jako správce služby.Sign in to the administrator portal as the service admin.
  2. Vyberte Skupiny prostředků.Select Resource Groups.
  3. Vyberte systém. <location> . skupina prostředků mysqladapterSelect the system.<location>.mysqladapter resource group.
  4. Na stránce Souhrn pro skupinu prostředků by se neměla nasazovat žádná neúspěšná nasazení.On the summary page for Resource group Overview, there should be no failed deployments.
  5. Nakonec vyberte virtuální počítače na portálu pro správu, abyste ověřili, jestli se virtuální počítač poskytovatele prostředků MySQL úspěšně vytvořil a běží.Finally, select Virtual machines in the administrator portal to verify that the MySQL resource provider VM was successfully created and is running.

Další krokyNext steps

Přidat hostitelské serveryAdd hosting servers