Distribuire il provider di risorse di SQL Server in Azure StackDeploy the SQL Server resource provider on Azure Stack

Usare il provider di risorse di Server SQL di Azure Stack per esporre i database SQL come servizio di Azure Stack.Use the Azure Stack SQL Server resource provider to expose SQL databases as an Azure Stack service. Il provider di risorse SQL viene eseguito come servizio in una macchina virtuale di Windows Server 2016 Server Core (VM).The SQL resource provider runs as a service on a Windows Server 2016 Server Core virtual machine (VM).

PrerequisitiPrerequisites

Esistono diversi prerequisiti che devono essere presenti prima di poter distribuire il provider di risorse SQL di Azure Stack.There are several prerequisites that need to be in place before you can deploy the Azure Stack SQL resource provider. Per soddisfare questi requisiti, completare i passaggi seguenti in un computer che possa accedere all'endpoint della macchina virtuale con privilegi:To meet these requirements, complete the following steps on a computer that can access the privileged endpoint VM:

CertificatiCertificates

Per le installazioni di sistemi integrati solo.For integrated systems installations only. È necessario fornire il certificato PKI PaaS SQL descritto nella sezione certificati PaaS facoltativa del i requisiti di infrastruttura a chiave pubblica di Azure Stack deployment.You must provide the SQL PaaS PKI certificate described in the optional PaaS certificates section of Azure Stack deployment PKI requirements. Inserire il file con estensione pfx nel percorso specificato per il DependencyFilesLocalPath parametro.Place the .pfx file in the location specified by the DependencyFilesLocalPath parameter. Non specificare un certificato per i sistemi ASDK.Do not provide a certificate for ASDK systems.

Distribuire il provider di risorse SQLDeploy the SQL resource provider

Dopo avere ottenuto installati tutti i prerequisiti, eseguire la DeploySqlProvider.ps1 script per distribuire il provider di risorse SQL.After you've got all the prerequisites installed, run the DeploySqlProvider.ps1 script to deploy the SQL resource provider. Lo script DeploySqlProvider.ps1 viene estratta come parte del file binario del provider di risorse SQL che è stato scaricato per la versione di Azure Stack.The DeploySqlProvider.ps1 script is extracted as part of the SQL resource provider binary that you downloaded for your version of Azure Stack.

Per distribuire il provider di risorse SQL, aprire una nuovo con privilegi elevati (non PowerShell ISE) finestra di PowerShell e passare alla directory in cui sono stati estratti i file binari di risorsa del provider SQL.To deploy the SQL resource provider, open a new elevated PowerShell window (not PowerShell ISE) and change to the directory where you extracted the SQL resource provider binary files. È consigliabile usare una nuova finestra di PowerShell per evitare potenziali problemi causati da moduli di PowerShell che sono già caricati.We recommend using a new PowerShell window to avoid potential problems caused by PowerShell modules that are already loaded.

Eseguire lo script DeploySqlProvider.ps1, che completa le attività seguenti:Run the DeploySqlProvider.ps1 script, which completes the following tasks:

  • Carica i certificati e altri elementi in un account di archiviazione in Azure Stack.Uploads the certificates and other artifacts to a storage account on Azure Stack.
  • Pubblica pacchetti di raccolta in modo che è possibile distribuire database SQL usando la raccolta.Publishes gallery packages so you can deploy SQL databases using the gallery.
  • Pubblica un pacchetto di raccolta per la distribuzione di server di hosting.Publishes a gallery package for deploying hosting servers.
  • Consente di distribuire una macchina virtuale usando l'immagine di Windows Server 2016 core scaricato e quindi installa il provider di risorse SQL.Deploys a VM using the Windows Server 2016 core image you downloaded, and then installs the SQL resource provider.
  • Registra un record DNS locale che esegue il mapping al provider di risorse della macchina virtuale.Registers a local DNS record that maps to your resource provider VM.
  • Registra il provider di risorse con locale Azure Resource Manager per l'account operatore.Registers your resource provider with the local Azure Resource Manager for the operator account.

Nota

All'avvio di distribuzione del provider di risorse SQL, il system.local.sqladapter viene creato il gruppo di risorse.When the SQL resource provider deployment starts, the system.local.sqladapter resource group is created. Potrebbero occorrere fino a 75 minuti per completare le distribuzioni richieste per questo gruppo di risorse.It may take up to 75 minutes to finish the required deployments to this resource group.

Parametri DeploySqlProvider.ps1DeploySqlProvider.ps1 parameters

È possibile specificare i parametri seguenti dalla riga di comando.You can specify the following parameters from the command line. In caso contrario, o se ha esito negativo qualsiasi convalida dei parametri, viene chiesto di fornire i parametri obbligatori.If you don't, or if any parameter validation fails, you're prompted to provide the required parameters.

Nome parametroParameter name DESCRIZIONEDescription Commento o il valore predefinitoComment or default value
CloudAdminCredentialCloudAdminCredential Le credenziali per l'amministratore del cloud, necessaria per l'accesso all'endpoint con privilegi.The credential for the cloud administrator, necessary for accessing the privileged endpoint. ObbligatorioRequired
AzCredentialAzCredential Le credenziali per l'account di amministratore del servizio di Azure Stack.The credentials for the Azure Stack service admin account. Usare le stesse credenziali usate per la distribuzione di Azure Stack.Use the same credentials that you used for deploying Azure Stack. ObbligatorioRequired
VMLocalCredentialVMLocalCredential Le credenziali per l'account amministratore locale del provider di risorse SQL macchina virtuale.The credentials for the local administrator account of the SQL resource provider VM. ObbligatorioRequired
PrivilegedEndpointPrivilegedEndpoint L'indirizzo IP o nome DNS dell'endpoint con privilegi.The IP address or DNS name of the privileged endpoint. ObbligatorioRequired
DependencyFilesLocalPathDependencyFilesLocalPath Per i sistemi integrati, i file con estensione pfx del certificato deve trovarsi in questa directory.For integrated systems only, your certificate .pfx file must be placed in this directory. È facoltativamente possibile copiare un pacchetto di Windows Update MSU qui.You can optionally copy one Windows Update MSU package here. Facoltativo (obbligatorio per i sistemi integrati)Optional (mandatory for integrated systems)
DefaultSSLCertificatePasswordDefaultSSLCertificatePassword La password per il certificato con estensione pfx.The password for the .pfx certificate. ObbligatorioRequired
MaxRetryCountMaxRetryCount Il numero di volte in cui che si desidera ripetere ogni operazione se si verifica un errore.The number of times you want to retry each operation if there's a failure. 22
RetryDurationRetryDuration L'intervallo di timeout tra i tentativi, in secondi.The timeout interval between retries, in seconds. 120120
DisinstallareUninstall Rimuove il provider di risorse e tutte le risorse associate (vedere le note seguenti).Removes the resource provider and all associated resources (see the following notes). No No
DebugModeDebugMode Impedisce la pulizia automatica in caso di errore.Prevents automatic cleanup on failure. No No

Distribuire il provider di risorse SQL usando uno script personalizzatoDeploy the SQL resource provider using a custom script

Per eliminare qualsiasi configurazione manuale quando si distribuisce il provider di risorse, è possibile personalizzare lo script seguente.To eliminate any manual configuration when deploying the resource provider, you can customize the following script. Modificare le informazioni sull'account predefinito e le password in base alle esigenze per la distribuzione di Azure Stack.Change the default account information and passwords as needed for your Azure Stack deployment.

# Install the AzureRM.Bootstrapper module, set the profile and install the AzureStack module
Install-Module -Name AzureRm.BootStrapper -Force
Use-AzureRmProfile -Profile 2017-03-09-profile
Install-Module  -Name AzureStack -RequiredVersion 1.3.0

# Use the NetBIOS name for the Azure Stack domain. On the Azure Stack 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 virtual machines
$privilegedEndpoint = "AzS-ERCS01"

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

# Change to the directory folder where you extracted the installation files. Do not provide a certificate on ASDK!
. $tempDir\DeploySQLProvider.ps1 `
    -AzCredential $AdminCreds `
    -VMLocalCredential $vmLocalAdminCreds `
    -CloudAdminCredential $cloudAdminCreds `
    -PrivilegedEndpoint $privilegedEndpoint `
    -DefaultSSLCertificatePassword $PfxPass `
    -DependencyFilesLocalPath $tempDir\cert

Al termine dello script di installazione provider di risorse, aggiornare il browser per assicurarsi che è possibile visualizzare gli aggiornamenti più recenti.When the resource provider installation script finishes, refresh your browser to make sure you can see the latest updates.

Verificare la distribuzione usando il portale di Azure StackVerify the deployment using the Azure Stack portal

È possibile usare i seguenti passaggi verificare che il provider di risorse SQL sia distribuito correttamente.You can use the following steps verify that the SQL resource provider is successfully deployed.

  1. Accedere al portale di amministrazione come amministratore del servizio.Sign in to the admin portal as the service administrator.
  2. Selezionare gruppi di risorse.Select Resource Groups.
  3. Selezionare il system.< ubicazione>.sqladapter gruppo di risorse.Select the system.<location>.sqladapter resource group.
  4. Nella pagina di riepilogo per il gruppo di risorse panoramica, non dovrebbe esserci alcun distribuzioni non riuscite.On the summary page for Resource group Overview, there should be no failed deployments.

    Verificare la distribuzione del provider di risorse SQL

Passaggi successiviNext steps

Aggiungere server di hostingAdd hosting servers