A MySQL erőforrás-szolgáltató üzembe helyezése Azure Stack központbanDeploy the MySQL resource provider on Azure Stack Hub

A MySQL-kiszolgáló erőforrás-szolgáltató használatával Azure Stack hub-szolgáltatásként elérhetővé teheti a MySQL-adatbázisokat.Use the MySQL Server resource provider to expose MySQL databases as an Azure Stack Hub service. A MySQL erőforrás-szolgáltató szolgáltatásként fut egy Windows Server 2016 Server Core virtuális gépen (az adapter verziója <= 1.1.47.0>), vagy egy speciális kiegészítő RP Windows Server (az adapter verziójához >= 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).

Fontos

Csak az erőforrás-szolgáltató hozhat létre elemeket az SQL vagy a MySQL-t futtató kiszolgálókon.Only the resource provider should create items on servers that host SQL or MySQL. Az erőforrás-szolgáltató által nem létrehozott gazdagép-kiszolgálón létrehozott elemek nem támogatottak, és nem egyező állapotot eredményezhetnek.Items created on a host server that aren't created by the resource provider are unsupported, and may result in a mismatched state.

ElőfeltételekPrerequisites

Az Azure Stack hub MySQL erőforrás-szolgáltató üzembe helyezése előtt több előfeltételt is meg kell adni:There are several prerequisites that need to be in place before you can deploy the Azure Stack Hub MySQL resource provider:

  • Szüksége lesz egy olyan számítógépre és fiókra, amely hozzáférhet a következőkhöz:You'll need a computer and account that can access:

    • az Azure stack hub felügyeleti portálon.the Azure Stack Hub administrator portal.
    • az emelt szintű végpont.the privileged endpoint.
    • a Azure Resource Manager felügyeleti végpont, https://management.region.<fqdn> ahol a a <fqdn> teljes tartománynév (vagy https://management.local.azurestack.external a ASDK használata esetén)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)
    • az Internet, ha a Azure Stack hub üzembe helyezése Azure Active Directory (AD) identitás-szolgáltatóként való használatára.the Internet, if your Azure Stack Hub was deployed to use Azure Active Directory (AD) as your identity provider.
  • Ha még nem tette meg, regisztráljon Azure stack hubot az Azure-ban, hogy letöltse az Azure Marketplace-elemeket.If you haven't already, register Azure Stack Hub with Azure so you can download Azure Marketplace items.

  • Adja hozzá a szükséges Windows Server-alapú virtuális gépet Azure Stack hub Marketplace-hez.Add the required Windows Server VM to Azure Stack Hub Marketplace.

    • A MySQL RP <= 1.1.47.0 esetében töltse le a Windows server 2016 Datacenter – Server Core rendszerképet.For MySQL RP version <= 1.1.47.0, download the Windows Server 2016 Datacenter - Server Core image.
    • A MySQL RP >= 1.1.93.0 esetében töltse le a Microsoft AzureStack Add-On RP Windows Server -rendszerképet.For MySQL RP version >= 1.1.93.0, download the Microsoft AzureStack Add-On RP Windows Server image. Ez a Windows Server-verzió a Azure Stack Add-On RP-infrastruktúrára specializálódott, és nem látható a bérlői piactéren.This Windows Server version is specialize for Azure Stack Add-On RP Infrastructure and it is not visible to the tenant marketplace.
  • Töltse le a MySQL erőforrás-szolgáltató bináris verziója támogatott verzióját az alábbi verzió-hozzárendelési táblázat szerint.Download the supported version of MySQL resource provider binary according to the version mapping table below. Futtassa az önálló kivonót a letöltött tartalmak ideiglenes könyvtárba való kinyeréséhez.Run the self-extractor to extract the downloaded contents to a temporary directory.

    Támogatott Azure Stack hub-verzióSupported Azure Stack Hub version MySQL RP-verzióMySQL RP version Az a Windows Server, amelyre az RP szolgáltatás futWindows Server that RP service is running on
    2008, 20052008, 2005 MySQL RP-verzió 1.1.93.1MySQL RP version 1.1.93.1 Microsoft AzureStack-bővítmény RP Windows ServerMicrosoft AzureStack Add-on RP Windows Server
    2005, 2002, 19102005, 2002, 1910 MySQL RP-verzió 1.1.47.0MySQL RP version 1.1.47.0 Windows Server 2016 Datacenter – Server CoreWindows Server 2016 Datacenter - Server Core
    19081908 MySQL RP-verzió 1.1.33.0MySQL RP version 1.1.33.0 Windows Server 2016 Datacenter – Server CoreWindows Server 2016 Datacenter - Server Core

Megjegyzés

Ha a MySQL-szolgáltatót olyan rendszeren szeretné telepíteni, amely nem rendelkezik internet-hozzáféréssel, másolja a mysql-connector-net-6.10.5.msi fájlt egy helyi elérési útra.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. Adja meg az elérési út nevét a DependencyFilesLocalPath paraméter használatával.Provide the path name using the DependencyFilesLocalPath parameter.

Leválasztott forgatókönyv esetén végezze el a következő lépéseket a szükséges PowerShell-modulok letöltéséhez és az adattár manuális regisztrálásához.In a disconnected scenario, complete the following steps to download the required PowerShell modules and register the repository manually.

  1. Jelentkezzen be egy internetkapcsolattal rendelkező számítógépre, és használja a következő parancsfájlokat a PowerShell-modulok letöltéséhez.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. A telepített erőforrás-szolgáltató verziójától függően futtassa az egyik parancsfájlt.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. Ezután másolja a letöltött csomagokat egy USB-eszközre.Then you copy the downloaded packages to a USB device.

  2. Jelentkezzen be a kapcsolat nélküli munkaállomásra, és másolja a csomagokat az USB-eszközről a munkaállomás egyik helyére.Sign in to the disconnected workstation and copy the packages from the USB device to a location on the workstation.

  3. Helyi tárházként regisztrálja ezt a helyet.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" 

TanúsítványokCertificates

Csak az integrált rendszerek telepítéséhez.For integrated systems installations only. Meg kell adnia az SQL Péter PKI-tanúsítványát, amely az Azure stack hub központi telepítésének PKI-követelményeinekopcionális, nem kötelezően megadandó tanúsítványok című szakaszában található.You must provide the SQL PaaS PKI certificate described in the optional PaaS certificates section of Azure Stack Hub deployment PKI requirements. Helyezze a. pfx-fájlt a DependencyFilesLocalPath paraméter által megadott helyre.Place the .pfx file in the location specified by the DependencyFilesLocalPath parameter. Ne adjon meg tanúsítványt a ASDK rendszerekhez.Don't provide a certificate for ASDK systems.

Az erőforrás-szolgáltató üzembe helyezéseDeploy the resource provider

Miután elvégezte az összes előfeltételt, futtathatja a DeployMySqlProvider.ps1 parancsfájlt egy olyan számítógépről, amely hozzáfér a Azure Stack hub Azure Resource Manager rendszergazdai végponthoz és a privilegizált végponthoz a MySQL erőforrás-szolgáltató üzembe helyezéséhez.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. A DeployMySqlProvider.ps1 szkript a MySQL erőforrás-szolgáltató telepítési fájljainak részeként lett kibontva, amelyeket a Azure Stack hub-verziójában töltött le.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.

Fontos

Az erőforrás-szolgáltató üzembe helyezése előtt tekintse át a kibocsátási megjegyzéseket, és ismerkedjen meg az új funkciókkal, javításokkal és az üzembe helyezést befolyásoló ismert problémákkal.Before deploying the resource provider, review the release notes to learn about new functionality, fixes, and any known issues that could affect your deployment.

A MySQL erőforrás-szolgáltató üzembe helyezéséhez nyisson meg egy új emelt szintű PowerShell-ablakot (ne PowerShell ISE), és váltson arra a könyvtárra, ahová kicsomagolta a MySQL erőforrás-szolgáltató bináris fájljait.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.

Fontos

Javasoljuk, hogy a Clear-AzureRmContext-scope CurrentUser és a Clear-AzureRmContext-scope folyamat használatával törölje a gyorsítótárat a Frissítési parancsfájl futtatása előtt.We strongly recommend using Clear-AzureRmContext -Scope CurrentUser and Clear-AzureRmContext -Scope Process to clear the cache before running the update script.

Futtassa a DeployMySqlProvider.ps1 parancsfájlt, amely a következő feladatokat hajtja végre:Run the DeployMySqlProvider.ps1 script, which completes the following tasks:

  • Feltölti a tanúsítványokat és egyéb összetevőket egy Azure Stack hub Storage-fiókjába.Uploads the certificates and other artifacts to a storage account on Azure Stack Hub.
  • Közzéteszi a katalógus-csomagokat, így a gyűjtemény használatával MySQL-adatbázisokat telepíthet.Publishes gallery packages so that you can deploy MySQL databases using the gallery.
  • Közzétesz egy gyűjtemény-csomagot az üzemeltetési kiszolgálók telepítéséhez.Publishes a gallery package for deploying hosting servers.
  • Üzembe helyez egy virtuális gépet a letöltött Windows Server 2016 Core rendszerkép vagy Microsoft AzureStack add-on RP Windows Server-rendszerkép használatával, majd telepíti a MySQL erőforrás-szolgáltatót.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.
  • Egy helyi DNS-rekordot regisztrál, amely az erőforrás-szolgáltató virtuális géphez van társítva.Registers a local DNS record that maps to your resource provider VM.
  • Regisztrálja az erőforrás-szolgáltatót a kezelő fiók helyi Azure Resource Manager.Registers your resource provider with the local Azure Resource Manager for the operator account.

Megjegyzés

Amikor elindul a MySQL erőforrás-szolgáltató üzembe helyezése, létrejön a System. local. mysqladapter erőforráscsoport.When the MySQL resource provider deployment starts, the system.local.mysqladapter resource group is created. Akár 75 percet is igénybe vehet, hogy elvégezze az ehhez az erőforráscsoporthoz szükséges központi telepítéseket.It may take up to 75 minutes to finish the deployments required to this resource group. Ne helyezzen más erőforrásokat a System. local. mysqladapter erőforráscsoporthoz.You should not place any other resources in the system.local.mysqladapter resource group.

DeployMySqlProvider.ps1 paraméterekDeployMySqlProvider.ps1 parameters

Ezeket a paramétereket megadhatja a parancssorból.You can specify these parameters from the command line. Ha nem, vagy ha valamelyik paraméter ellenőrzése sikertelen, a rendszer felszólítja a szükséges paraméterek megadására.If you don't, or if any parameter validation fails, you're prompted to provide the required parameters.

Paraméter neveParameter name LeírásDescription Megjegyzés vagy alapértelmezett értékComment or default value
CloudAdminCredentialCloudAdminCredential A rendszerjogosultságú végpont eléréséhez szükséges hitelesítő adatok a felhő rendszergazdájához.The credential for the cloud administrator, necessary for accessing the privileged endpoint. KötelezőRequired
AzCredentialAzCredential Az Azure Stack hub szolgáltatás rendszergazdai fiókjának hitelesítő adatai.The credentials for the Azure Stack Hub service admin account. Használja ugyanazokat a hitelesítő adatokat, amelyeket az Azure Stack hub üzembe helyezéséhez használt.Use the same credentials that you used for deploying Azure Stack Hub. A szkript sikertelen lesz, ha a AzCredential használt fiók többtényezős hitelesítést (MFA) igényel.The script will fail if the account you use with AzCredential requires multi-factor authentication (MFA). KötelezőRequired
VMLocalCredentialVMLocalCredential A MySQL erőforrás-szolgáltató virtuális gép helyi rendszergazdai fiókjának hitelesítő adatai.The credentials for the local administrator account of the MySQL resource provider VM. KötelezőRequired
PrivilegedEndpointPrivilegedEndpoint Az emelt szintű végpont IP-címe vagy DNS-neve.The IP address or DNS name of the privileged endpoint. KötelezőRequired
AzureEnvironmentAzureEnvironment Az Azure Stack hub üzembe helyezéséhez használt szolgáltatás-rendszergazdai fiók Azure-környezete.The Azure environment of the service admin account used for deploying Azure Stack Hub. Csak az Azure AD-telepítésekhez szükséges.Required only for Azure AD deployments. A támogatott környezeti nevek: AzureCloud, AzureUSGovernment, illetve kínai Azure ad-t, AzureChinaCloud-t használnak.Supported environment names are AzureCloud, AzureUSGovernment, or if using a China Azure AD, AzureChinaCloud. AzureCloudAzureCloud
DependencyFilesLocalPathDependencyFilesLocalPath Csak az integrált rendszerek esetében a tanúsítvány. pfx fájlját ebbe a könyvtárba kell helyezni.For integrated systems only, your certificate .pfx file must be placed in this directory. A leválasztott környezetek esetében töltse le mysql-connector-net-6.10.5.msi erre a könyvtárba.For disconnected environments, download mysql-connector-net-6.10.5.msi to this directory. Itt egy Windows Update MSU-csomagot is másolhat.You can optionally copy one Windows Update MSU package here. Nem kötelező (az integrált rendszerekhez és a leválasztott környezetekhez kötelező )Optional (mandatory for integrated systems or disconnected environments)
DefaultSSLCertificatePasswordDefaultSSLCertificatePassword A. pfx-tanúsítvány jelszava.The password for the .pfx certificate. KötelezőRequired
MaxRetryCountMaxRetryCount Az egyes műveletek újrapróbálkozási időpontjának száma, ha hiba történt.The number of times you want to retry each operation if there's a failure. 22
RetryDurationRetryDuration Az újrapróbálkozások közötti időtúllépési időköz (másodpercben).The timeout interval between retries, in seconds. 120120
EltávolításaUninstall Eltávolítja az erőforrás-szolgáltatót és az összes kapcsolódó erőforrást (lásd a következő megjegyzéseket).Removes the resource provider and all associated resources (see the following notes). NemNo
DebugModeDebugMode Megakadályozza a hibák automatikus törlését.Prevents automatic cleanup on failure. NemNo
AcceptLicenseAcceptLicense Kihagyja a kérést, hogy elfogadja a GPL-licencet.Skips the prompt to accept the GPL license. https://www.gnu.org/licenses/old-licenses/gpl-2.0.html

A MySQL erőforrás-szolgáltató üzembe helyezése egyéni parancsfájl használatávalDeploy the MySQL resource provider using a custom script

Ha a MySQL erőforrás-szolgáltató 1.1.33.0 vagy korábbi verzióit telepíti, telepítenie kell a AzureRm. BootStrapper és a Azure Stack hub-modulok adott verzióját a PowerShell-ben.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. Ha a MySQL erőforrás-szolgáltató 1.1.47.0 vagy újabb verzióját telepíti, akkor az üzembehelyezési parancsfájl automatikusan letölti és telepíti a szükséges PowerShell-modulokat a 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

Megjegyzés

A leválasztott forgatókönyvben le kell töltenie a szükséges PowerShell-modulokat, és manuálisan kell regisztrálnia az adattárat előfeltételként.In disconnected scenario, you need to download the required PowerShell modules and register the repository manually as a prerequisite.

Az erőforrás-szolgáltató üzembe helyezése során felmerülő manuális konfiguráció elkerülése érdekében testreszabhatja az alábbi parancsfájlt.To eliminate any manual configuration when deploying the resource provider, you can customize the following script. Az Azure Stack hub telepítéséhez szükség szerint módosítsa az alapértelmezett fiók adatait és a jelszavakat.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

Az erőforrás-szolgáltató telepítési parancsfájljának befejeződése után frissítse a böngészőt, és győződjön meg arról, hogy a legújabb frissítések láthatók, és hogy az aktuális PowerShell-munkamenetet lezárta.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.

A központi telepítés ellenőrzése a Azure Stack hub portál használatávalVerify the deployment by using the Azure Stack Hub portal

  1. Jelentkezzen be a felügyeleti portálra szolgáltatás-rendszergazdaként.Sign in to the administrator portal as the service admin.
  2. Válassza az Erőforráscsoportok lehetőséget.Select Resource Groups.
  3. Válassza ki a System. <location> . mysqladapter erőforráscsoport.Select the system.<location>.mysqladapter resource group.
  4. Az erőforráscsoport-áttekintés összefoglaló lapján nem lehetnek sikertelen központi telepítések.On the summary page for Resource group Overview, there should be no failed deployments.
  5. Végül válassza a virtuális gépek lehetőséget a felügyeleti portálon annak ellenőrzéséhez, hogy a MySQL erőforrás-szolgáltató virtuális gépe sikeresen létrejött-e, és fut-e.Finally, select Virtual machines in the administrator portal to verify that the MySQL resource provider VM was successfully created and is running.

További lépésekNext steps

Üzemeltetési kiszolgálók hozzáadásaAdd hosting servers