Azure Stack Hub'da SQL Server kaynak sağlayıcısını dağıtma
Önemli
Azure Stack Hub derlemesi 2108'den başlayarak SQL ve MySQL kaynak sağlayıcıları, erişim izni verilen aboneliklere sunulur. Bu özelliği kullanmaya başlamak istiyorsanız veya önceki bir sürümden yükseltmeniz gerekiyorsa bir destek olayı açın ; destek mühendislerimiz dağıtım veya yükseltme işleminde size yol gösterir.
SQL veritabanlarını Azure Stack Hub hizmeti olarak kullanıma açmak için Azure Stack Hub SQL Server kaynak sağlayıcısını kullanın.
SQL kaynak sağlayıcısı, Windows Server 2016 Server Core sanal makinesinde hizmet olarak çalışır.
SQL kaynak sağlayıcısı, özel bir Eklenti RP Windows Server'da hizmet olarak çalışır.
Önemli
SQL veya MySQL barındıran sunucularda yalnızca kaynak sağlayıcısının öğe oluşturması gerekir. Kaynak sağlayıcısı tarafından oluşturulmayan bir konak sunucusunda oluşturulan öğeler desteklenmez ve eşleşmeyen bir duruma neden olabilir.
Önemli
V2.x SQL/MySQL kaynak sağlayıcısı, ASDK'de desteklenmeyen Dağıtım Kaynak Sağlayıcısı (DRP) yükleme mekanizmasını kullanır. Bu nedenle, V2.x SQL/MySQL kaynak sağlayıcısı ASDK'de desteklenmez.
Önkoşullar
Zaten bir kaynak sağlayıcısı yüklediyseniz, büyük olasılıkla aşağıdaki önkoşulları tamamladınız ve bu bölümü atlayabilirsiniz. Aksi takdirde, devam etmeden önce şu adımları tamamlayın:
Henüz yapmadıysanız Azure Stack Hub örneğinizi Azure'a kaydedin. Azure'dan markete bağlanıp öğeleri indirdiğiniz için bu adım gereklidir.
Azure Stack Hub yönetici portalının Market Yönetimi özelliği hakkında bilginiz yoksa Market öğelerini Azure'dan indirme ve Azure Stack Hub'da yayımlama konusunu gözden geçirin. Makale, Azure'dan Azure Stack Hub marketine öğe indirme işleminde size yol gösterir. Hem bağlı hem de bağlantısız senaryoları kapsar. Azure Stack Hub örneğinizin bağlantısı kesildiyse veya kısmen bağlıysa, yükleme hazırlığında tamamlanması gereken ek önkoşullar vardır.
Microsoft Entra giriş dizininizi güncelleştirin. Derleme 1910'dan itibaren yeni bir uygulamanın giriş dizini kiracınıza kaydedilmesi gerekir. Bu uygulama, Azure Stack Hub'ın daha yeni kaynak sağlayıcılarını (Event Hubs ve diğerleri gibi) Microsoft Entra kiracınıza başarıyla oluşturmasını ve kaydetmesini sağlar. Bu, derleme 1910 veya daha yeni bir sürüme yükselttikten sonra yapılması gereken tek seferlik bir eylemdir. Bu adım tamamlanmazsa market kaynak sağlayıcısı yüklemeleri başarısız olur.
- Azure Stack Hub örneğinizi 1910 veya üzeri bir sürüme başarıyla güncelleştirdikten sonra Azure Stack Hub Araçları deposunu kopyalama/indirme yönergelerini izleyin.
- Ardından Azure Stack Hub Microsoft Entra Giriş Dizinini Güncelleştirme (güncelleştirmeleri veya yeni Kaynak Sağlayıcılarını yükledikten sonra) yönergeleri izleyin.
kaynak sağlayıcısı önkoşullarını SQL Server
Aşağıdakilere erişebilen bir bilgisayara ve hesaba ihtiyacınız vardır:
- Azure Stack Hub yönetici portalı.
- ayrıcalıklı uç nokta (yalnızca SQL Server kaynak sağlayıcısı V1'i dağıtırken veya SQL Server kaynak sağlayıcısı V1'den SQL Server kaynak sağlayıcısı V2'ye yükseltirken gereklidir).
- Azure Resource Manager yönetici uç noktası,
https://adminmanagement.region.<fqdn>
burada<fqdn>
tam etki alanı adınızdır. - Azure Stack Hub'ınız kimlik sağlayıcınız olarak Microsoft Entra ID kullanacak şekilde dağıtıldıysa İnternet...
Aşağıdaki sürüm eşleme tablosuna göre SQL kaynak sağlayıcısı ikili dosyasının desteklenen sürümünü indirin. V2 SQL kaynak sağlayıcısı için market öğesini Azure Stack Hub'a indirin.
Desteklenen Azure Stack Hub sürümü SQL RP sürümü RP hizmetinin üzerinde çalıştığı Windows Server 2206, 2301, 2306, 2311 SQL RP sürüm 2.0.13.x Microsoft AzureStack Eklentisi RP Windows Server 1.2009.0 2108, 2206 SQL RP sürüm 2.0.6.x Microsoft AzureStack Eklentisi RP Windows Server 1.2009.0 Gerekli Windows Server VM'sinin Azure Stack Hub Market'e indirildiğinden emin olun. Gerekirse görüntüyü yukarıdaki sürüm eşleme tablosuna göre el ile indirin.
Veri merkezi tümleştirme önkoşullarının karşılandığından emin olun:
Önkoşul Başvuru Koşullu DNS iletme doğru ayarlanmış. Azure Stack Hub veri merkezi tümleştirmesi - DNS Kaynak sağlayıcıları için gelen bağlantı noktaları açık. Azure Stack Hub veri merkezi tümleştirmesi - Gelen bağlantı noktaları ve protokoller PKI sertifika konusu ve SAN doğru ayarlanmış. Azure Stack Hub dağıtımı zorunlu PKI önkoşulları
Azure Stack Hub dağıtımı PaaS sertifikası önkoşullarıSertifikayı hazırlayın. (Yalnızca tümleşik sistem yüklemeleri için.)
- Azure Stack Hub dağıtım PKI gereksinimlerinin isteğe bağlı PaaS sertifikaları bölümünde açıklanan SQL PaaS PKI sertifikasını sağlamanız gerekir. Konu Diğer Adı (SAN) şu adlandırma desenine uymalıdır: CN=*.dbadapter.<bölge.><fqdn>, parola korumalı.
- SQL Server kaynak sağlayıcısı V1'i dağıtırken, .pfx dosyasını DependencyFilesLocalPath parametresi tarafından belirtilen konuma yerleştirin. ASDK sistemleri için sertifika sağlama.
- SQL Server kaynak sağlayıcısı V2'yi dağıtırken sertifikayı aşağıdaki yükleme adımları için hazırlayın.
Bağlantısı kesilmiş senaryo
Bağlantısız bir senaryoda SQL Server kaynak sağlayıcısı V2'yi dağıtırken market öğelerini Azure Stack Hub'a indirme yönergelerini izleyerek SQL Server kaynak sağlayıcısı öğesini ve Eklenti RP Windows Server öğesini Azure Stack Hub ortamınıza indirin.
Bağlantısı kesilmiş bir senaryoda SQL Server kaynak sağlayıcısı V1'i dağıtırken, gerekli PowerShell modüllerini indirmek ve depoyu el ile kaydetmek için aşağıdaki adımları tamamlayın.
İnternet bağlantısı olan bir bilgisayarda oturum açın ve PowerShell modüllerini indirmek için aşağıdaki betikleri kullanın.
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"
Dağıttığınız kaynak sağlayıcısı sürümüne bağlı olarak betiklerden birini çalıştırın.
# 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
Ardından indirilen paketleri bir USB cihazına kopyalarsınız.
Bağlantısı kesilmiş iş istasyonunda oturum açın ve paketleri USB cihazından iş istasyonundaki bir konuma kopyalayın.
Bu konumu yerel depo olarak kaydedin.
# 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"
SQL kaynak sağlayıcısı V2'yi dağıtma
V1 sürümünden yükseltme yapıyorsanız SQL Server kaynak sağlayıcısını güncelleştirme belgesine bakın.
Yüklemeyi başlat
Henüz yapmadıysanız Azure Stack Hub yönetici portalında oturum açın, sol taraftaki Market Yönetimi'ni ve kaynak sağlayıcıları'nı seçin.
SQL kaynak sağlayıcısı ve diğer gerekli yazılımlar indirildikten sonra, Market Yönetimi "SQL Server kaynak sağlayıcısı" paketlerini "Yüklü Değil" durumuyla gösterir. "İndirildi" durumunu gösteren başka paketler de olabilir.
Yüklemek istediğiniz satırı seçin. SQL Server kaynak sağlayıcısı yükleme paketi sayfasında üst kısımda mavi bir başlık gösterilir. Yüklemeyi başlatmak için başlığı seçin.
Ön koşulları yükleme
Ardından yükleme sayfasına aktarılırsınız. Yükleme işlemine başlamak için Önkoşulları Yükle'yi seçin.
Önkoşulların yüklenmesinin başarılı geçmesini bekleyin. Sonraki adıma geçmeden önce Önkoşulları yükle'nin yanında yeşil bir onay işareti görmeniz gerekir.
Gizli dizileri hazırlama
2'nin altında. Gizli dizileri hazırlama adımında Sertifika ekle'yi seçtiğinizde Sertifika ekle paneli görüntülenir.
Sertifika dosya adı alanının hemen sağındaki Sertifika ekle'de gözat düğmesini seçin. Önkoşulları tamamlarken temin ettiğiniz .pfx sertifika dosyasını seçin.
SQL Server kaynak sağlayıcısı SSL Sertifikası için güvenli bir dize oluşturmak için sağladığınız parolayı girin. Ardından Ekle'yi seçin.
Kaynak sağlayıcısını yükleme
Sertifikanın yüklenmesi başarılı olduğunda, sonraki adıma geçmeden önce Gizli dizileri hazırlama'nın yanında yeşil bir onay işareti görmeniz gerekir. Şimdi 3 Kaynak sağlayıcısını yükle'nin yanındaki Yükle düğmesini seçin.
Ardından, SQL kaynak sağlayıcısının yüklendiğini gösteren aşağıdaki sayfayı göreceksiniz.
Yüklemenin tam bildirimini bekleyin. Bu işlem, Azure Stack Hub türünüze bağlı olarak genellikle bir veya daha fazla saat sürer.
Market Yönetimi, Kaynak Sağlayıcıları sayfasına dönerek SQL Server kaynak sağlayıcısı yüklemesinin başarılı olduğunu doğrulayın. SQL Server kaynak sağlayıcısının durumu "Yüklü" olarak gösterilmelidir.
SQL kaynak sağlayıcısı V1'i dağıtma
Tüm önkoşulları tamamladıktan sonra, indirilen yükleme paketini geçici bir dizine ayıklamak için kendi kendine ayıklayıcıyı çalıştırın. sql kaynak sağlayıcısını dağıtmak için DeploySqlProvider.ps1 betiğini hem Azure Stack Hub Azure Resource Manager yönetici uç noktasına hem de ayrıcalıklı uç noktaya erişebilen bir bilgisayardan çalıştırın. DeploySqlProvider.ps1 betiği, Azure Stack Hub sürümünüz için indirdiğiniz SQL kaynak sağlayıcısı ikili dosyasının bir parçası olarak ayıklanır.
Önemli
Kaynak sağlayıcısını dağıtmadan önce, yeni işlevler, 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.
SQL kaynak sağlayıcısını dağıtmak için yeni bir yükseltilmiş PowerShell penceresi açın (PowerShell ISE'yi değil) ve SQL kaynak sağlayıcısı ikili dosyalarını ayıkladığınız dizine geçin.
Önemli
Dağıtma veya güncelleştirme betiğini çalıştırmadan önce önbelleği temizlemek için Clear-AzureRmContext -Scope CurrentUser ve Clear-AzureRmContext -Scope Process kullanmanızı kesinlikle öneririz.
Aşağıdaki görevleri tamamlayan DeploySqlProvider.ps1 betiğini çalıştırın:
- Sertifikaları ve diğer yapıtları Azure Stack Hub'daki bir depolama hesabına yükler.
- Galeriyi kullanarak SQL veritabanlarını dağıtabilmeniz için galeri paketlerini yayımlar.
- Barındırma sunucularını dağıtmak için bir galeri paketi yayımlar.
- İndirdiğiniz Windows Server 2016 çekirdek görüntüsünü veya Microsoft AzureStack Eklentisi RP Windows Server görüntüsünü kullanarak bir VM dağıtır ve ardından SQL kaynak sağlayıcısını yükler.
- Kaynak sağlayıcısı VM'nize eşleyen yerel bir DNS kaydını kaydeder.
- Kaynak sağlayıcınızı operatör hesabı için yerel Azure Resource Manager kaydeder.
Not
SQL kaynak sağlayıcısı dağıtımı başlatıldığında system.local.sqladapter kaynak grubu oluşturulur. Bu kaynak grubuna gerekli dağıtımların tamamlanması 75 dakika kadar sürebilir. System.local.sqladapter kaynak grubuna başka kaynak yerleştirmemelisiniz.
parametreleri DeploySqlProvider.ps1
Komut satırından aşağıdaki parametreleri belirtebilirsiniz. Aksi takdirde veya herhangi bir parametre doğrulaması başarısız olursa, gerekli parametreleri sağlamanız istenir.
Parametre adı | Açıklama | Açıklama veya varsayılan değer |
---|---|---|
CloudAdminCredential | Ayrıcalıklı uç noktaya erişmek için gerekli olan bulut yöneticisinin kimlik bilgileri. | Gerekli |
AzCredential | Azure Stack Hub hizmet yöneticisi hesabının kimlik bilgileri. Azure Stack Hub'ı dağıtmak için kullandığınız kimlik bilgilerini kullanın. AzCredential ile kullandığınız hesap çok faktörlü kimlik doğrulaması (MFA) gerektiriyorsa betik başarısız olur. | Gerekli |
VMLocalCredential | SQL kaynak sağlayıcısı VM'sinin yerel yönetici hesabının kimlik bilgileri. | Gerekli |
PrivilegedEndpoint | Ayrıcalıklı uç noktanın IP adresi veya DNS adı. | Gerekli |
AzureEnvironment | Azure Stack Hub'ı dağıtmak için kullanılan hizmet yöneticisi hesabının Azure ortamı. Yalnızca Microsoft Entra dağıtımları için gereklidir. Desteklenen ortam adları AzureCloud, AzureUSGovernment veya Çin Microsoft Entra ID kullanıyorsanız AzureChinaCloud'dur. | AzureCloud |
DependencyFilesLocalPath | Yalnızca tümleşik sistemler için sertifika .pfx dosyanız bu dizine yerleştirilmelidir. İsteğe bağlı olarak bir Windows Update MSU paketini buraya kopyalayabilirsiniz. | İsteğe bağlı (tümleşik sistemler için zorunlu ) |
DefaultSSLCertificatePassword | .pfx sertifikasının parolası. | Gerekli |
MaxRetryCount | Bir hata olduğunda her işlemi yeniden deneme sayısı. | 2 |
RetryDuration | Yeniden denemeler arasındaki zaman aşımı aralığı (saniye cinsinden). | 120 |
Kaldır | Kaynak sağlayıcısını ve ilişkili tüm kaynakları kaldırır (aşağıdaki notlara bakın). | No |
DebugMode | Hata durumunda otomatik temizlemeyi önler. | No |
Özel betik kullanarak SQL kaynak sağlayıcısını dağıtma
SQL kaynak sağlayıcısı sürüm 1.1.33.0 veya önceki sürümleri dağıtıyorsanız, PowerShell'de AzureRm.BootStrapper ve Azure Stack Hub modüllerinin belirli sürümlerini yüklemeniz gerekir.
SQL kaynak sağlayıcısı sürüm 1.1.47.0 veya üzerini dağıtıyorsanız, dağıtım betiği C:\Program Files\SqlMySqlPsh yolunu izlemeniz için gerekli PowerShell modüllerini otomatik olarak indirir ve yükler.
# 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 -RequiredVersion 0.5.0 -Force
Use-AzureRmProfile -Profile 2018-03-01-hybrid -Force
Install-Module -Name AzureStack -RequiredVersion 1.6.0
Not
Bağlantısız senaryoda, gerekli PowerShell modüllerini indirmeniz ve depoyu el ile önkoşul olarak kaydetmeniz gerekir.
Kaynak sağlayıcısını dağıtırken el ile gerçekleştirilen tüm yapılandırmaları ortadan kaldırmak için aşağıdaki betiği özelleştirebilirsiniz. Azure Stack Hub dağıtımınız için gereken varsayılan hesap bilgilerini ve parolaları değiştirin.
# 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 values for the <environment name> parameter are AzureCloud, AzureChinaCloud, or AzureUSGovernment depending which Azure subscription you're using.
$AzureEnvironment = "<EnvironmentName>"
# Point to the directory where the resource provider installation files were extracted.
$tempDir = 'C:\TEMP\SQLRP'
# 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 local admin account.
$vmLocalAdminPass = ConvertTo-SecureString 'P@ssw0rd1' -AsPlainText -Force
$vmLocalAdminCreds = New-Object System.Management.Automation.PSCredential ("sqlrpadmin", $vmLocalAdminPass)
# Add the cloudadmin credential that's 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\DeploySQLProvider.ps1 `
-AzCredential $AdminCreds `
-VMLocalCredential $vmLocalAdminCreds `
-CloudAdminCredential $cloudAdminCreds `
-PrivilegedEndpoint $privilegedEndpoint `
-AzureEnvironment $AzureEnvironment `
-DefaultSSLCertificatePassword $PfxPass `
-DependencyFilesLocalPath $tempDir\cert
Kaynak sağlayıcısı yükleme betiği tamamlandığında, en son güncelleştirmeleri görebildiğinizden emin olmak için tarayıcınızı yenileyin ve geçerli PowerShell oturumunu kapatın.
Azure Stack Hub portalını kullanarak V1 dağıtımını doğrulama
- Yönetici portalında hizmet yöneticisi olarak oturum açın.
- Kaynak Grupları’nı seçin.
- Sistemi seçin.<location.sqladapter> kaynak grubu.
- Kaynak grubuna Genel Bakış özet sayfasında başarısız dağıtım olmamalıdır.
- Son olarak, YÖNETICI portalında Sanal makineler'i seçerek SQL kaynak sağlayıcısı VM'sinin başarıyla oluşturulduğunu ve çalıştığını doğrulayın.
Microsoft Entra ID için önemli yapılandırma
Azure Stack Hub'ınız kimlik sağlayıcısı olarak Microsoft Entra ID kullanıyorsa, SQL Server kaynak sağlayıcısını yüklemiş olan VM'nin giden İnternet bağlantısına sahip olduğundan emin olun.
SQL Server kaynak sağlayıcısını yüklemiş olan VM'nin IP'sini almanız gerekiyorsa (örneğin IP'yi güvenlik duvarı izin verilenler listenize ekleyin), bir destek olayı açmanız ve destek mühendisinin SQL Server kaynak sağlayıcısı aboneliğini geçici olarak görünür hale getirmesini sağlamalısınız. Ardından VM'yi abonelikte bulabilir ve IP'sini alabilirsiniz.