De SQL Server-resourceprovider implementeren in Azure Stack Hub

Belangrijk

Vanaf Azure Stack Hub build 2108 worden de SQL- en MySQL-resourceproviders aangeboden aan abonnementen die toegang hebben gekregen. Als u deze functie wilt gaan gebruiken of als u een upgrade wilt uitvoeren van een vorige versie, een ondersteuningsaanvraag openen en onze ondersteuningstechnici begeleiden u bij de implementatie of het upgradeproces.

Gebruik de Azure Stack Hub SQL Server-resourceprovider om SQL-databases beschikbaar te maken als een Azure Stack Hub-service.

De SQL-resourceprovider wordt uitgevoerd als een service op een speciale Add-on RP Windows Server.

Belangrijk

Alleen de resourceprovider mag items maken op servers waarop SQL of MySQL wordt gehost. Items die zijn gemaakt op een hostserver die niet door de resourceprovider worden gemaakt, worden niet ondersteund en kunnen leiden tot een niet-overeenkomende status.

Belangrijk

De V2.x SQL/MySQL-resourceprovider maakt gebruik van het DRP-installatiemechanisme (Deployment Resource Provider), dat niet wordt ondersteund in de ASDK. Daarom wordt de V2.x SQL/MySQL-resourceprovider niet ondersteund in de ASDK.

Voorwaarden

Als u al een resourceprovider hebt geïnstalleerd, hebt u waarschijnlijk de volgende vereisten voltooid en kunt u deze sectie overslaan. Voer anders de volgende stappen uit voordat u doorgaat:

1. Uw Azure Stack Hub-exemplaar registreren bij Azure, als u dit nog niet hebt gedaan. Deze stap is vereist, omdat u verbinding maakt met en items downloadt naar Marketplace vanuit Azure.

2. Als u niet bekend bent met de Marketplace-beheerfunctie van de Azure Stack Hub-beheerdersportal, raadpleegt u Marketplace-items downloaden van Azure en publiceert u naar Azure Stack Hub. Het artikel begeleidt u bij het downloaden van items van Azure naar de Azure Stack Hub Marketplace. Het omvat zowel verbonden als niet-verbonden scenario's. Als de verbinding met uw Azure Stack Hub-exemplaar is verbroken of gedeeltelijk is verbonden, zijn er aanvullende vereisten om de installatie te voltooien.

3. Werk de basismap van Microsoft Entra bij. Vanaf Build 1910 moet een nieuwe toepassing worden geregistreerd in uw home-directory-tenant. Met deze app kan Azure Stack Hub nieuwe resourceproviders (zoals Event Hubs en anderen) succesvol registreren en maken binnen uw Microsoft Entra-tenant. Dit is een eenmalige actie die moet worden uitgevoerd na een upgrade naar build 1910 of hoger. Als deze stap niet is voltooid, mislukken de installaties van marketplace-resourceproviders.

   • Nadat u uw Azure Stack Hub-exemplaar hebt bijgewerkt naar 1910 of hoger, volgt u de instructies voor het klonen/downloaden van de azure Stack Hub Tools-opslagplaats.
   • Volg vervolgens de instructies voor Het bijwerken van de Microsoft Entra-basismap van Azure Stack Hub (na het installeren van updates of nieuwe resourceproviders).

Vereisten voor SQL Server-resourceprovider

• U hebt een computer en account nodig die toegang hebben tot:

  • de Azure Stack Hub-beheerdersportal.
  • het bevoegde eindpunt (alleen nodig wanneer u SQL Server-resourceprovider V1 implementeert of een upgrade uitvoert van SQL Server-resourceprovider V1 naar SQL Server-resourceprovider V2).
  • het Azure Resource Manager-beheereindpunt, https://adminmanagement.region.<fqdn>, waarbij <fqdn> uw volledig gekwalificeerde domeinnaam is.
  • internet, als uw Azure Stack Hub is geïmplementeerd voor het gebruik van Microsoft Entra-id als uw id-provider.

• Download de ondersteunde versie van het binaire bestand van de SQL-resourceprovider volgens de onderstaande tabel met versietoewijzingen. Voor V2 SQL-resourceprovider het Marketplace-item downloaden naar Azure Stack Hub.

  Ondersteunde Versie van Azure Stack Hub	SQL RP-versie	Windows Server waarop de RP-service wordt uitgevoerd
  2206, 2301, 2306, 2311	SQL RP-versie 2.0.13.x	Microsoft Azure Stack-extensie RP Windows Server 1.2009.0
  2108, 2206	SQL RP-versie 2.0.6.x	Microsoft Azure Stack Add-on RP Windows Server 1.2009.0

• Zorg ervoor dat de vereiste Windows Server-VM is gedownload naar Azure Stack Hub Marketplace. Download de afbeelding handmatig volgens de bovenstaande versie-tabel, indien nodig.

• Zorg ervoor dat aan de vereisten voor datacenterintegratie wordt voldaan:

  Voorwaarde	Referentie
  Voorwaardelijke DNS-doorsturen is juist ingesteld.	Azure Stack Hub-datacenterintegratie - DNS-
  Binnenkomende poorten voor resourceproviders zijn geopend.	Integratie van Azure Stack Hub-datacenters - inkomende poorten en protocollen
  PKI-certificaatonderwerp en SAN zijn correct ingesteld.	vereiste PKI-vereisten voor azure Stack Hub-implementatie paaS-certificaatvereisten voor PaaS-implementatie van Azure Stack Hub

• Bereid het certificaat voor. (Alleen voor installaties van geïntegreerde systemen.)

  • U moet het SQL PaaS PKI-certificaat opgeven dat wordt beschreven in de sectie optionele PaaS-certificaten van PKI-implementatievereisten voor Azure Stack Hub. De alternatieve naam van het onderwerp (SAN) moet voldoen aan het volgende naamgevingspatroon: CN=*.dbadapter.<regio>.<fqdn>, met wachtwoordbeveiliging.
  • Wanneer u SQL Server-resourceprovider V1 implementeert, plaatst u het PFX-bestand op de locatie die is opgegeven door de parameter DependencyFilesLocalPath. Geef geen certificaat op voor ASDK-systemen.
  • Bij het implementeren van SQL Server-resourceprovider V2 bereidt u het certificaat voor op de volgende installatiestappen.

Scenario met niet-verbonden verbinding

Wanneer u SQL Server-resourceprovider V2 implementeert in een niet-verbonden scenario, volgt u de Marketplace-items downloaden naar Azure Stack Hub instructie voor het downloaden van het item van de SQL Server-resourceprovider en het invoegtoepassings-RP Windows Server-item in uw Azure Stack Hub-omgeving.

Wanneer u SQL Server-resourceprovider V1 implementeert in een niet-verbonden scenario, voert u de volgende stappen uit om de vereiste PowerShell-modules te downloaden en de opslagplaats handmatig te registreren.

1. Meld u aan bij een computer met internetverbinding en gebruik de volgende scripts om de PowerShell-modules te downloaden.

   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"
   

2. Voer een van de scripts uit, afhankelijk van de versie van de resourceprovider die u implementeert.

   # 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
   

3. Vervolgens kopieert u de gedownloade pakketten naar een USB-apparaat.

4. Meld u aan bij het niet-verbonden werkstation en kopieer de pakketten van het USB-apparaat naar een locatie op het werkstation.

5. Registreer deze locatie als een lokale opslagplaats.

   # 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"
   

De SQL-resourceprovider V2 implementeren

Als u een upgrade uitvoert van een V1-versie, raadpleegt u het document De SQL Server-resourceprovider bijwerken.

Installatie starten

1. Als u dat nog niet hebt gedaan, meldt u zich aan bij de Azure Stack Hub-beheerportal, selecteert u Marketplace-beheer aan de linkerkant en selecteert u Resourceproviders.

2. Zodra de SQL-resourceprovider en andere vereiste software zijn gedownload, worden in Marketplace-beheer de pakketten 'SQL Server-resourceprovider' weergegeven met de status 'Niet geïnstalleerd'. Er kunnen andere pakketten zijn die de status 'Gedownload' weergeven.

3. Selecteer de rij die u wilt installeren. Op de installatiepakketpagina van de SQL Server-resourceprovider ziet u een blauwe banner bovenaan. Selecteer de banner om de installatie te starten.

Vereisten installeren

1. Vervolgens wordt u overgebracht naar de installatiepagina. Selecteer Installatievereisten om het installatieproces te starten.

2. Wacht totdat de installatie van vereisten is voltooid. U zou een groen vinkje moeten zien naast Vereisten installeren voordat u doorgaat met de volgende stap.

Geheimen voorbereiden

1. Onder stap 2. Bereid geheimen voor, selecteer Certificaat toevoegenen het deelvenster Een certificaat toevoegen wordt weergegeven.

2. Selecteer de bladerknop op Een certificaat toevoegen, rechts van het veld bestandsnaam van het certificaat. Selecteer het PFX-certificaatbestand dat u hebt aangeschaft bij het voltooien van de vereisten.

3. Voer het wachtwoord in dat u hebt opgegeven om een beveiligde tekenreeks te maken voor SSL-certificaat van SQL Server-resourceprovider. Selecteer vervolgens toevoegen.

Resourceprovider installeren

1. Wanneer de installatie van het certificaat is voltooid, ziet u een groen vinkje naast Geheimen voorbereiden voordat u doorgaat met de volgende stap. Selecteer nu de knop Installeren naast 3 Resourceprovider installeren.

2. Vervolgens ziet u de volgende pagina, die aangeeft dat de SQL-resourceprovider wordt geïnstalleerd.

3. Wacht op de melding dat de installatie is voltooid. Dit proces duurt meestal een of meer uren, afhankelijk van uw Type Azure Stack Hub.

4. Controleer of de installatie van de SQL Server-resourceprovider is geslaagd door terug te keren naar de pagina Marketplace-beheer, resourceproviders. De status van de SQL Server-resourceprovider moet 'Geïnstalleerd' weergeven.

De SQL-resourceprovider V1 implementeren

Nadat u alle vereisten hebt voltooid, voert u de self-extractor uit om het gedownloade installatiepakket te extraheren naar een tijdelijke map. voer het DeploySqlProvider.ps1-script uit vanaf een computer die toegang heeft tot zowel het Azure Stack Hub Azure Resource Manager-beheereindpunt als het bevoegde eindpunt om de SQL-resourceprovider te implementeren. Het DeploySqlProvider.ps1 script wordt geëxtraheerd als onderdeel van het binaire bestand van de SQL-resourceprovider dat u hebt gedownload voor uw versie van Azure Stack Hub.

Belangrijk

Voordat u de resourceprovider implementeert, bekijkt u de releaseopmerkingen voor meer informatie over nieuwe functionaliteit, oplossingen en bekende problemen die van invloed kunnen zijn op uw implementatie.

Als u de SQL-resourceprovider wilt implementeren, opent u een nieuwe PowerShell-venster met verhoogde bevoegdheid (niet PowerShell ISE) en gaat u naar de map waarin u de binaire bestanden van de SQL-resourceprovider hebt uitgepakt.

Belangrijk

We raden u ten zeerste aan om Clear-AzureRmContext -Scope CurrentUser en Clear-AzureRmContext -Scope Process te gebruiken om de cache te wissen voordat u het implementatie- of updatescript uitvoert.

Voer het DeploySqlProvider.ps1-script uit, waarmee de volgende taken worden voltooid:

• Uploadt de certificaten en andere artefacten naar een opslagaccount in Azure Stack Hub.
• Hiermee publiceert u galeriepakketten, zodat u SQL-databases kunt implementeren met behulp van de galerie.
• Hiermee publiceert u een galeriepakket voor het implementeren van hostingservers.
• Hiermee wordt een VM geïmplementeerd met behulp van de Windows Server 2016 core image of de Microsoft Azure Stack Add-on RP Windows Server image die u hebt gedownload, waarna de SQL-resourceprovider wordt geïnstalleerd.
• Registreert een lokale DNS-record die is toegewezen aan de VM van uw resourceprovider.
• Registreert uw resourceprovider bij de lokale Azure Resource Manager voor het operatoraccount.

Notitie

Wanneer de implementatie van de SQL-resourceprovider wordt gestart, wordt de system.local.sqladapter resourcegroep gemaakt. Het kan tot 75 minuten duren voordat de vereiste implementaties naar deze resourcegroep zijn voltooid. Plaats geen andere resources in de system.local.sqladapter resourcegroep.

DeploySqlProvider.ps1 parameters

U kunt de volgende parameters opgeven vanaf de opdrachtregel. Als u dat niet doet of als er een parametervalidatie mislukt, wordt u gevraagd om de vereiste parameters op te geven.

Parameternaam	Beschrijving	Opmerking of standaardwaarde
CloudAdminCredential	De referentie voor de cloudbeheerder, die nodig is voor toegang tot het bevoegde eindpunt.	Vereist
AzCredential-	De referenties voor het Azure Stack Hub-servicebeheerder-account. Gebruik dezelfde referenties die u hebt gebruikt voor het implementeren van Azure Stack Hub. Het script mislukt als het account dat u met AzCredential gebruikt, meervoudige verificatie (MFA) vereist.	Vereist
VMLocalCredential-	De inloggegevens voor het beheerdersaccount van de SQL-resourceprovider-VM.	Vereist
PrivilegedEndpoint-	Het IP-adres of de DNS-naam van het bevoegde eindpunt.	Vereist
Azure-omgeving	De Azure-omgeving van het servicebeheerdersaccount dat wordt gebruikt voor het implementeren van Azure Stack Hub. Alleen vereist voor Microsoft Entra-implementaties. Ondersteunde omgevingsnamen zijn AzureCloud, AzureUSGovernmentof als u een Microsoft Entra-id van China gebruikt, AzureChinaCloud.	AzureCloud
DependencyFilesLocalPath-	Alleen voor geïntegreerde systemen moet het PFX-certificaatbestand in deze map worden geplaatst. U kunt hier desgewenst één Windows Update MSU-pakket kopiëren.	Optionele (verplichte voor geïntegreerde systemen)
DefaultSSLCertificatePassword	Het wachtwoord voor het PFX-certificaat.	Vereist
MaxRetryCount	Het aantal keren dat u elke bewerking opnieuw wilt uitvoeren als er een fout optreedt.	2
RetryDuration	Het time-outinterval tussen nieuwe pogingen, in seconden.	120
De-installatie van	Hiermee verwijdert u de resourceprovider en alle bijbehorende resources (zie de volgende opmerkingen).	Nee
DebugMode-	Voorkomt automatische opschoning bij een mislukking.	Nee

De SQL-resourceprovider implementeren met behulp van een aangepast script

Als u de SQL-resourceprovider versie 1.1.47.0 of hoger implementeert, downloadt en installeert het implementatiescript automatisch de benodigde PowerShell-modules voor u naar het pad 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 -RequiredVersion 0.5.0 -Force
Use-AzureRmProfile -Profile 2018-03-01-hybrid -Force
Install-Module -Name AzureStack -RequiredVersion 1.6.0

Notitie

In een niet-verbonden scenario moet u de vereiste PowerShell-modules downloaden en de opslagplaats handmatig registreren als een vereiste.

Als u handmatige configuratie wilt elimineren bij het implementeren van de resourceprovider, kunt u het volgende script aanpassen. Wijzig zo nodig de standaardaccountgegevens en wachtwoorden voor uw Azure Stack Hub-implementatie.

# 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

Wanneer het installatiescript van de resourceprovider is voltooid, vernieuwt u de browser om te controleren of u de meest recente updates kunt zien en de huidige PowerShell-sessie kunt sluiten.

De V1-implementatie controleren met behulp van de Azure Stack Hub-portal

1. Meld u als servicebeheerder aan bij de beheerdersportal.
2. Selecteer Resourcegroepen.
3. Selecteer het systeem.<locatie>.sqladapter resourcegroep.
4. Op de overzichtspagina voor Overzicht van resourcegroepen mogen er geen mislukte implementaties zijn.
5. Selecteer tot slot virtuele machines in de beheerportal om te verifiëren dat de VM van de SQL-resourceprovider succesvol is aangemaakt en actief is.

Belangrijke configuratie voor Microsoft Entra-id

Als uw Azure Stack Hub Gebruikmaakt van Microsoft Entra ID als een id-provider, moet u ervoor zorgen dat de VM die sql Server-resourceprovider heeft geïnstalleerd uitgaande internetverbinding heeft.

Als het IP-adres moet worden opgehaald van de VIRTUELE machine waarop de SQL Server-resourceprovider is geïnstalleerd (bijvoorbeeld het IP-adres toevoegen aan de acceptatielijst voor de firewall), moet u een ondersteuningsaanvraag openen en moet de ondersteuningstechnicus het ABONNEMENT van de SQL Server-resourceprovider tijdelijk zichtbaar maken. Vervolgens kunt u de VIRTUELE machine in het abonnement vinden en het IP-adres ophalen.

Volgende stappen

hostingservers toevoegen