Azure Stack hub 'da MySQL kaynak sağlayıcısını dağıtmaDeploy the MySQL resource provider on Azure Stack Hub

MySQL veritabanlarını Azure Stack hub hizmeti olarak göstermek için MySQL Server kaynak sağlayıcısını kullanın.Use the MySQL Server resource provider to expose MySQL databases as an Azure Stack Hub service. MySQL kaynak sağlayıcısı bir Windows Server 2016 Server Core sanal makinesinde (bağdaştırıcı sürümü <= 1.1.47.0>) veya özel bir Add-on RP Windows Server (bağdaştırıcı sürümü >= 1.1.93.0 için) bir hizmet olarak çalışır.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).

Önemli

Yalnızca kaynak sağlayıcısı SQL veya MySQL barındıran sunucularda öğeler oluşturmalı.Only the resource provider should create items on servers that host SQL or MySQL. Kaynak sağlayıcısı tarafından oluşturulmamış bir ana bilgisayar sunucusunda oluşturulan öğeler desteklenmez ve bu durum eşleşmeyen bir duruma neden olabilir.Items created on a host server that aren't created by the resource provider are unsupported, and may result in a mismatched state.

ÖnkoşullarPrerequisites

Azure Stack hub MySQL kaynak sağlayıcısını dağıtabilmeniz için önce yerine getirmeniz gereken birkaç önkoşul vardır:There are several prerequisites that need to be in place before you can deploy the Azure Stack Hub MySQL resource provider:

  • Erişebileceği bir bilgisayar ve hesaba ihtiyacınız vardır:You'll need a computer and account that can access:

    • Azure Stack merkezi Yönetici portalı.the Azure Stack Hub administrator portal.
    • ayrıcalıklı uç nokta.the privileged endpoint.
    • https://management.region.<fqdn> <fqdn> tam etki alanı adınız (veya https://management.local.azurestack.external asdk kullanılıyorsa) Azure Resource Manager yönetici uç noktası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)
    • Azure Stack hub 'ınız, kimlik sağlayıcınız olarak Azure Active Directory (AD) kullanmak üzere dağıtılmışsa Internet.the Internet, if your Azure Stack Hub was deployed to use Azure Active Directory (AD) as your identity provider.
  • Henüz yapmadıysanız Azure Market öğelerini indirebilmeniz için Azure Stack hub 'ı Azure 'a kaydettirin.If you haven't already, register Azure Stack Hub with Azure so you can download Azure Marketplace items.

  • Gerekli Windows Server VM 'sini Azure Stack hub marketi 'ne ekleyin.Add the required Windows Server VM to Azure Stack Hub Marketplace.

    • MySQL RP sürüm <= 1.1.47.0 için Windows Server 2016 Datacenter-Server Core görüntüsünü indirin.For MySQL RP version <= 1.1.47.0, download the Windows Server 2016 Datacenter - Server Core image.
    • MySQL RP sürüm >= 1.1.93.0 için Microsoft AzureStack Add-On RP Windows Server görüntüsünü indirin.For MySQL RP version >= 1.1.93.0, download the Microsoft AzureStack Add-On RP Windows Server image. Bu Windows Server sürümü, Azure Stack Add-On RP altyapısı için specialize ve kiracı Marketi tarafından görülemez.This Windows Server version is specialize for Azure Stack Add-On RP Infrastructure and it is not visible to the tenant marketplace.
  • MySQL kaynak sağlayıcısı ikilisinin desteklenen sürümünü aşağıdaki sürüm eşleme tablosuna göre indirin.Download the supported version of MySQL resource provider binary according to the version mapping table below. İndirilen içerikleri geçici bir dizine ayıklamak için Self-Extractor ' i çalıştırın.Run the self-extractor to extract the downloaded contents to a temporary directory.

    Desteklenen Azure Stack hub sürümüSupported Azure Stack Hub version MySQL RP sürümüMySQL RP version RP hizmetinin üzerinde çalıştığı Windows ServerWindows Server that RP service is running on
    2008, 20052008, 2005 MySQL RP sürüm 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 sürüm 1.1.47.0MySQL RP version 1.1.47.0 Windows Server 2016 Datacenter-Sunucu ÇekirdeğiWindows Server 2016 Datacenter - Server Core
    19081908 MySQL RP sürüm 1.1.33.0MySQL RP version 1.1.33.0 Windows Server 2016 Datacenter-Sunucu ÇekirdeğiWindows Server 2016 Datacenter - Server Core

Not

MySQL sağlayıcısını Internet erişimi olmayan bir sisteme dağıtmak için mysql-connector-net-6.10.5.msi dosyasını bir yerel yola kopyalayın.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. Dependencyfileslocalpath parametresini kullanarak yol adını sağlayın.Provide the path name using the DependencyFilesLocalPath parameter.

Bağlantısı kesilen bir senaryoda, gerekli PowerShell modüllerini indirmek ve depoyu el ile kaydetmek için aşağıdaki adımları izleyin.In a disconnected scenario, complete the following steps to download the required PowerShell modules and register the repository manually.

  1. İnternet bağlantısı olan bir bilgisayarda oturum açın ve PowerShell modüllerini indirmek için aşağıdaki komut dosyalarını kullanın.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. Dağıttığınız kaynak sağlayıcının sürümüne bağlı olarak, betiklerin birini çalıştırın.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. Daha sonra indirilen paketleri bir USB cihazına kopyalayabilirsiniz.Then you copy the downloaded packages to a USB device.

  2. Bağlantısı kesilen iş istasyonunda oturum açın ve paketleri USB cihazdan iş istasyonundaki bir konuma kopyalayın.Sign in to the disconnected workstation and copy the packages from the USB device to a location on the workstation.

  3. Bu konumu yerel bir depo olarak kaydedin.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" 

SertifikalarCertificates

Yalnızca tümleşik sistem yüklemeleri için.For integrated systems installations only. Azure Stack hub DAĞıTıMı PKI gereksinimlerininIsteğe bağlı PaaS sertifikaları bölümünde açıklanan SQL PaaS PKI sertifikasını sağlamanız gerekir.You must provide the SQL PaaS PKI certificate described in the optional PaaS certificates section of Azure Stack Hub deployment PKI requirements. . Pfx dosyasını Dependencyfileslocalpath parametresi tarafından belirtilen konuma yerleştirin.Place the .pfx file in the location specified by the DependencyFilesLocalPath parameter. ASDK sistemleri için bir sertifika sağlamaymayın.Don't provide a certificate for ASDK systems.

Kaynak sağlayıcısını dağıtmaDeploy the resource provider

Tüm önkoşulları tamamladıktan sonra, MySQL kaynak sağlayıcısını dağıtmak için hem Azure Stack hub Azure Resource Manager yönetici uç noktasına hem de ayrıcalıklı uç noktaya erişebilen bir bilgisayardan DeployMySqlProvider.ps1 betiğini çalıştırabilirsiniz.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. DeployMySqlProvider.ps1 betiği, Azure Stack hub 'ınızın sürümü için indirdiğiniz MySQL kaynak sağlayıcısı yükleme dosyalarının bir parçası olarak ayıklanır.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.

Önemli

Kaynak sağlayıcısını dağıtılmadan önce, yeni işlevsellik, düzeltmeler ve dağıtımınızı etkileyebilecek bilinen sorunlar hakkında bilgi edinmek için sürüm notlarını gözden geçirin.Before deploying the resource provider, review the release notes to learn about new functionality, fixes, and any known issues that could affect your deployment.

MySQL kaynak sağlayıcısı 'nı dağıtmak için Yeni bir yükseltilmiş PowerShell penceresi açın (PowerShell ISE) ve MySQL kaynak sağlayıcısı ikili dosyalarını ayıkladığınız dizine geçin.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.

Önemli

Güncelleştirme betiğini çalıştırmadan önce önbelleği temizlemek için clear-azurermcontext-Scope CurrentUser ve clear-Azurermcontext-Scope işlemini kullanmanızı kesinlikle öneririz.We strongly recommend using Clear-AzureRmContext -Scope CurrentUser and Clear-AzureRmContext -Scope Process to clear the cache before running the update script.

Aşağıdaki görevleri tamamlayan DeployMySqlProvider.ps1 betiğini çalıştırın:Run the DeployMySqlProvider.ps1 script, which completes the following tasks:

  • Sertifikaları ve diğer yapıtları Azure Stack hub 'ındaki bir depolama hesabına yükler.Uploads the certificates and other artifacts to a storage account on Azure Stack Hub.
  • Galeriyi kullanarak MySQL veritabanlarını dağıtabilmeniz için Galeri paketleri yayımlar.Publishes gallery packages so that you can deploy MySQL databases using the gallery.
  • Barındırma sunucularını dağıtmak için bir galeri paketi yayımlar.Publishes a gallery package for deploying hosting servers.
  • , İndirdiğiniz Windows Server 2016 Core görüntüsünü veya Microsoft AzureStack Add-on RP Windows Server görüntüsünü kullanarak bir VM dağıtır ve ardından MySQL kaynak sağlayıcısını kurar.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.
  • Kaynak sağlayıcısı VM 'niz ile eşleşen yerel bir DNS kaydını kaydeder.Registers a local DNS record that maps to your resource provider VM.
  • Kaynak sağlayıcınızı operatör hesabı için yerel Azure Resource Manager kaydeder.Registers your resource provider with the local Azure Resource Manager for the operator account.

Not

MySQL kaynak sağlayıcısı dağıtımı başladığında, System. Local. mysqladapter kaynak grubu oluşturulur.When the MySQL resource provider deployment starts, the system.local.mysqladapter resource group is created. Bu kaynak grubuna gereken dağıtımların tamamlanması 75 dakika sürebilir.It may take up to 75 minutes to finish the deployments required to this resource group. System. Local. mysqladapter kaynak grubuna başka herhangi bir kaynak yerleştirmemelisiniz.You should not place any other resources in the system.local.mysqladapter resource group.

DeployMySqlProvider.ps1 parametreleriDeployMySqlProvider.ps1 parameters

Komut satırından bu parametreleri belirtebilirsiniz.You can specify these parameters from the command line. Aksi takdirde veya herhangi bir parametre doğrulaması başarısız olursa, gerekli parametreleri sağlamanız istenir.If you don't, or if any parameter validation fails, you're prompted to provide the required parameters.

Parametre adıParameter name AçıklamaDescription Açıklama veya varsayılan değerComment or default value
CloudAdminCredentialCloudAdminCredential Ayrıcalıklı uç noktaya erişmek için gerekli olan bulut yöneticisinin kimlik bilgileri.The credential for the cloud administrator, necessary for accessing the privileged endpoint. GerekliRequired
AzCredentialAzCredential Azure Stack hub hizmeti yönetici hesabı için kimlik bilgileri.The credentials for the Azure Stack Hub service admin account. Azure Stack hub 'ı dağıtmak için kullandığınız kimlik bilgilerini kullanın.Use the same credentials that you used for deploying Azure Stack Hub. AzCredential ile kullandığınız hesap Multi-Factor Authentication (MFA) gerektiriyorsa betik başarısız olur.The script will fail if the account you use with AzCredential requires multi-factor authentication (MFA). GerekliRequired
VMLocalCredentialVMLocalCredential MySQL kaynak sağlayıcısı VM 'sinin yerel yönetici hesabının kimlik bilgileri.The credentials for the local administrator account of the MySQL resource provider VM. GerekliRequired
Ayrıcalıklı GedendpointPrivilegedEndpoint Ayrıcalıklı uç noktanın IP adresi veya DNS adı.The IP address or DNS name of the privileged endpoint. GerekliRequired
AzureEnvironmentAzureEnvironment Azure Stack hub 'ı dağıtmak için kullanılan hizmet yönetici hesabının Azure ortamı.The Azure environment of the service admin account used for deploying Azure Stack Hub. Yalnızca Azure AD dağıtımları için gereklidir.Required only for Azure AD deployments. Desteklenen ortam adları Azurecsesli, AzureUSGovernment veya Çin Azure AD, AzureChinaCloud kullanıyorsa.Supported environment names are AzureCloud, AzureUSGovernment, or if using a China Azure AD, AzureChinaCloud. AzureCloudAzureCloud
DependencyFilesLocalPathDependencyFilesLocalPath Yalnızca tümleşik sistemler için Certificate. pfx dosyanızın bu dizine yerleştirilmesi gerekir.For integrated systems only, your certificate .pfx file must be placed in this directory. Bağlantısı kesilen ortamlar için mysql-connector-net-6.10.5.msi bu dizine indirin.For disconnected environments, download mysql-connector-net-6.10.5.msi to this directory. İsteğe bağlı olarak, bir Windows Update MSU paketini buraya kopyalayabilirsiniz.You can optionally copy one Windows Update MSU package here. Isteğe bağlı (tümleşik sistemler veya bağlantısı kesilen ortamlar için zorunlu )Optional (mandatory for integrated systems or disconnected environments)
DefaultSSLCertificatePasswordDefaultSSLCertificatePassword . Pfx sertifikası için parola.The password for the .pfx certificate. GerekliRequired
MaxRetryCountMaxRetryCount Bir hata oluşursa her işlemi yeniden denemek istediğiniz zaman sayısı.The number of times you want to retry each operation if there's a failure. 22
RetryDurationRetryDuration Yeniden denemeler arasındaki zaman aşımı aralığı (saniye cinsinden).The timeout interval between retries, in seconds. 120120
KaldırUninstall Kaynak sağlayıcıyı ve tüm ilişkili kaynakları kaldırır (aşağıdaki notlara bakın).Removes the resource provider and all associated resources (see the following notes). HayırNo
DebugModeDebugMode Hata durumunda otomatik temizlemeyi önler.Prevents automatic cleanup on failure. HayırNo
AcceptLicenseAcceptLicense GPL lisansını kabul etmek için isteği atlar.Skips the prompt to accept the GPL license. https://www.gnu.org/licenses/old-licenses/gpl-2.0.html

Özel bir betik kullanarak MySQL kaynak sağlayıcısını dağıtmaDeploy the MySQL resource provider using a custom script

MySQL kaynak sağlayıcısı sürüm 1.1.33.0 veya önceki sürümlerini dağıtıyorsanız, PowerShell 'de Azurerm. BootStrapper ve Azure Stack hub modüllerinin belirli sürümlerini yüklemeniz gerekir.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. MySQL kaynak sağlayıcısı sürüm 1.1.47.0 veya üstünü dağıtıyorsanız dağıtım betiği, sizin için gerekli PowerShell modüllerini C:\Program Files\sqlmysqlpshpath yoluna otomatik olarak indirip yükler.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

Not

Bağlantısı kesik senaryosunda, gerekli PowerShell modüllerini indirmeniz ve depoyu bir önkoşul olarak el ile kaydetmeniz gerekir.In disconnected scenario, you need to download the required PowerShell modules and register the repository manually as a prerequisite.

Kaynak sağlayıcıyı dağıttığınızda el ile yapılandırmayı ortadan kaldırmak için aşağıdaki betiği özelleştirebilirsiniz.To eliminate any manual configuration when deploying the resource provider, you can customize the following script. Azure Stack hub dağıtımınız için gereken varsayılan hesap bilgilerini ve parolaları değiştirin.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

Kaynak sağlayıcısı yükleme betiği tamamlandığında, en son güncelleştirmeleri görebilmeniz ve geçerli PowerShell oturumunu kapattığınızdan emin olmak için tarayıcınızı yenileyin.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.

Azure Stack hub portalını kullanarak dağıtımı doğrulamaVerify the deployment by using the Azure Stack Hub portal

  1. Hizmet Yöneticisi olarak yönetici portalında oturum açın.Sign in to the administrator portal as the service admin.
  2. Kaynak Grupları’nı seçin.Select Resource Groups.
  3. Sistemi seçin . <location> .. mysqladapter kaynak grubu.Select the system.<location>.mysqladapter resource group.
  4. Kaynak grubuna genel bakış Özet sayfasında, başarısız dağıtımlar olmaması gerekir.On the summary page for Resource group Overview, there should be no failed deployments.
  5. Son olarak, MySQL kaynak sağlayıcısı VM 'sinin başarıyla oluşturulduğunu ve çalıştığını doğrulamak için yönetici portalında sanal makineler ' i seçin.Finally, select Virtual machines in the administrator portal to verify that the MySQL resource provider VM was successfully created and is running.

Sonraki adımlarNext steps

Barındırma sunucuları eklemeAdd hosting servers