Distribuire il provider di risorse MySQL nell'hub di Azure Stack

Usare il provider di risorse del server MySQL per esporre i database MySQL come servizio hub di Azure Stack.

Solo il provider di risorse deve creare elementi nei server che ospitano SQL o MySQL. Gli elementi creati in un server host che non vengono creati dal provider di risorse non sono supportati e potrebbero causare uno stato non corrispondente.

Prerequisiti

Se è già stato installato un provider di risorse, è probabile che siano stati completati i prerequisiti seguenti e che sia possibile ignorare questa sezione. In caso contrario, completare questi passaggi prima di continuare.

1. Registrare l'istanza dell'hub di Azure Stack con Azure, se non è stato fatto. È necessario registrare l'istanza di hub di Azure Stack con Azure perché ci si connetterà a Azure e scaricare elementi dal marketplace.

2. Se non si ha familiarità con la funzionalità di gestione del Marketplace del portale di amministrazione dell'hub di Azure Stack, esaminare Scaricare gli elementi del Marketplace da Azure e pubblicarli nell'hub di Azure Stack. L'articolo illustra il processo di download di elementi da Azure al marketplace dell'hub di Azure Stack. Vengono illustrati gli scenari connessi e disconnessi. Se l'istanza di hub di Azure Stack è disconnessa o parzialmente connessa, è necessario completare ulteriori prerequisiti per la preparazione dell'installazione.

3. Aggiornare la home directory di Microsoft Entra. A partire dalla build 1910, è necessario registrare una nuova applicazione nel tenant della home directory. Questa app consente ad hub di Azure Stack di creare e registrare con successo provider di risorse più recenti (ad esempio Hub eventi di Azure e altri ancora) nel tenant Microsoft Entra.

   Questa azione è necessaria dopo l'aggiornamento alla build 1910 o successiva. Se non si completa questo passaggio, le installazioni dei provider di risorse dal marketplace hanno esito negativo.

4. Dopo aver aggiornato correttamente l'istanza di hub di Azure Stack alla versione 1910 o successiva, seguire le instructions per clonare/scaricare il repository hub di Azure Stack Tools.

5. Seguire le istruzioni per aggiornare la directory principale Microsoft Entra di hub di Azure Stack (dopo l'installazione degli aggiornamenti o di nuovi provider di risorse).

Prerequisiti del provider di risorse mySQL Server

• È necessario un computer e un account a cui è possibile accedere:

  • portale di amministrazione dell'hub di Azure Stack.
  • l'endpoint con privilegi (necessario solo quando si distribuisce il provider di risorse del server MySQL V1 o si esegue l'aggiornamento dal provider di risorse del server MySQL V1 al provider di risorse del server MySQL V2).
  • l'endpoint amministrativo di Azure Resource Manager, https://adminmanagement.region.<fqdn>, dove <fqdn> è il nome di dominio completamente qualificato.
  • Internet, se l'hub di Azure Stack è stato distribuito per usare l'ID Microsoft Entra come provider di identità.

• Scaricare la versione supportata del binario del provider di risorse MySQL in base alla tabella di corrispondenza delle versioni riportata nella sezione seguente. Per il provider di risorse MySQL V2, scaricare l'elemento del marketplace nell'hub di Azure Stack.

  Versione supportata dell'hub di Azure Stack	Versione rp di MySQL	Windows Server in cui è in esecuzione il servizio RP
  2206, 2301, 2306, 2311	MySQL RP versione 2.0.13.x	Componente aggiuntivo RP di Microsoft AzureStack Windows Server 1.2009.0
  2108, 2206	MySQL RP versione 2.0.6.x	Componente aggiuntivo RP di Microsoft AzureStack Windows Server 1.2009.0

• Assicurarsi che la macchina virtuale Windows Server richiesta venga scaricata in hub di Azure Stack Marketplace. Scaricare manualmente l'immagine in base alla tabella di corrispondenza delle versioni, se necessario.

• Verificare che siano soddisfatti i prerequisiti di integrazione del data center:

  Prerequisito	Riferimento
  L'inoltro DNS condizionale è impostato correttamente.	Integrazione del centro dati dell'Hub di Azure Stack - DNS
  Le porte in ingresso per i provider di risorse sono aperte.	Integrazione del data center di hub di Azure Stack - Pubblicazione degli endpoint
  L'oggetto del certificato PKI e la san sono impostati correttamente.	prerequisiti obbligatori per la distribuzione dell'hub di Azure Stackprerequisiti del certificato PaaS per la distribuzione dell'hub di Azure Stack

• Preparare il certificato. (Per installazioni di sistemi integrati solo.)

  • È necessario specificare il certificato PKI PaaS SQL descritto nella sezione facoltativa dei certificati PaaS di requisiti PKI per la distribuzione dell'hub di Azure Stack. Il nome alternativo del soggetto (SAN) deve rispettare il modello di denominazione seguente: CN=*.dbadapter.<'area>.<fqdn>, con password protetta.
  • Quando si distribuisce il provider di risorse del server MySQL V1, inserire il file pfx nel percorso specificato dal parametro DependencyFilesLocalPath. Non fornire un certificato per i sistemi ASDK.
  • Quando si distribuisce il provider di risorse mySQL Server V2, preparare il certificato per i passaggi di installazione seguenti.

Scenario disconnesso

Quando si distribuisce il provider di risorse del server MySQL V2 in uno scenario disconnesso, seguire le istruzioni per scaricare gli elementi del marketplace nell'Hub di Azure Stack per scaricare l'elemento del provider di risorse MySQL Server e l'elemento Componente aggiuntivo RP Windows Server nell'ambiente dell'Hub di Azure Stack.

Quando si distribuisce il provider di risorse del server MySQL V1 in uno scenario disconnesso, completare la procedura seguente per scaricare i moduli di PowerShell necessari e registrare manualmente il repository.

1. Accedere a un computer con connettività Internet e usare gli script seguenti per scaricare i moduli di PowerShell.

   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. A seconda della versione del provider di risorse da distribuire, eseguire uno degli script.

   # 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. Copiare quindi i pacchetti scaricati in un dispositivo USB.

4. Accedere alla workstation disconnessa e copiare i pacchetti dal dispositivo USB in una posizione sulla workstation.

5. Registrare questa posizione come repository locale.

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

Distribuire il provider di risorse MySQL V2

Se si esegue l'aggiornamento da una versione V1, fare riferimento alla documentazione Aggiornare il provider di risorse del server MySQL.

Avviare l'installazione

1. Se non l'hai già fatto, accedi al portale di amministrazione di hub di Azure Stack, seleziona Marketplace Management a sinistra e seleziona Provider di risorse.

2. Dopo aver scaricato il provider di risorse MySQL e altri software necessari, Gestione del Marketplace mostra i pacchetti "Provider di risorse server MySQL" con lo stato "Non installato". Potrebbero essere visualizzati altri pacchetti che mostrano lo stato "Scaricato".

   

3. Selezionare la riga da installare. La pagina del pacchetto di installazione del provider di risorse MySQL Server mostra un banner blu nella parte superiore. Selezionare il banner per avviare l'installazione.

Installare i prerequisiti

1. Successivamente, si viene trasferiti alla pagina di installazione. Selezionare Installare i prerequisiti per avviare il processo di installazione.

2. Attendere che l'installazione dei prerequisiti abbia esito positivo. Accanto a Installare i prerequisiti verrà visualizzato un segno di spunta verde prima di procedere al passaggio successivo.

Preparare segreti

1. Nel passaggio 2. Preparare i segreti, seleziona Aggiungi certificato. Viene visualizzato il pannello Aggiungi un certificato .

2. Selezionare il pulsante Sfoglia in Aggiungi un certificato, proprio a destra del campo del nome file del certificato. Selezionare il file di certificato .pfx ottenuto quando hai completato i prerequisiti.

3. Immettere la password specificata per creare una stringa sicura per il certificato SSL del provider di risorse di SQL Server. Selezionare quindi Aggiungi.

Configurare e installare il provider di risorse

1. Quando l'installazione del certificato ha esito positivo, accanto a Preparare i segreti viene visualizzato un segno di spunta verde. Ora seleziona il pulsante Configura + Installa accanto a 3 Installa il provider di risorse.

2. Specificare quindi un URI BLOB hub di Azure Stack per il connettore MySQL.

   • Esaminare la licenza GP di MySQL Connector qui e scaricare la versione 8.0.21 in una cartella locale.

   • Creare un account di archiviazione con la sottoscrizione dell'operatore predefinito e creare un contenitore con il livello di accesso "BLOB" o "Contenitore".

   • Caricare il mysql-connector-net-8.0.21.msi file dalla cartella locale nel contenitore di archiviazione appena creato.

   Importante

   Assicurarsi che la versione del connettore MySQL sia 8.0.21.

   • Copiare l'URI del BLOB.

   • Tornare alla pagina di configurazione di MySQL RP. Incollare l'URI del BLOB ( ad esempio , https://<storageAccountName>.blob.<region>.<FQDN>/<containerName>/mysql-connector-net-8.0.21.msi) nella casella di testo e selezionare OK.

3. Verrà quindi visualizzata la pagina seguente, che indica che è in corso l'installazione del provider di risorse MySQL.

4. Attendere la notifica di completamento dell'installazione. Questo processo richiede in genere una o più ore, a seconda del tipo di hub di Azure Stack.

5. Verificare che l'installazione del provider di risorse di MySQL Server sia riuscita tornando alla pagina Gestione marketplace, Provider di risorse. Lo stato del provider di risorse del server MySQL deve essere "Installato".

Distribuire il provider di risorse SQL V1

Dopo aver completato tutti i prerequisiti, eseguire l'estrattore automatico per estrarre il pacchetto di installazione scaricato in una directory temporanea. Eseguire lo script di DeployMySqlProvider.ps1 da un computer che può accedere sia all'endpoint amministratore di hub di Azure Stack di Azure Resource Manager che all'endpoint con privilegi, per distribuire il provider di risorse MySQL. Lo script DeployMySqlProvider.ps1 viene estratto come parte dei file di installazione del provider di risorse MySQL scaricati per la versione di hub di Azure Stack.

Per distribuire il provider di risorse MySQL, aprire un nuova finestra di PowerShell con privilegi elevati (non PowerShell ISE) e passare alla directory in cui sono stati estratti i file binari del provider di risorse MySQL.

Eseguire lo script DeployMySqlProvider.ps1, che completa le attività seguenti:

• Carica i certificati e altri artefatti in un account di archiviazione nell'hub di Azure Stack.
• Pubblica i pacchetti della galleria in modo da poter distribuire database MySQL tramite la galleria.
• Pubblica un pacchetto della raccolta per la distribuzione dei server di hosting.
• Distribuisce una VM usando l'immagine Core di Windows Server 2016 oppure l'immagine di Windows Server dell'Add-on RP di Microsoft Azure Stack scaricata, quindi installa il provider di risorse MySQL.
• Registra un record DNS locale mappato alla macchina virtuale del provider di risorse.
• Registra il provider di risorse con Azure Resource Manager locale per l'account dell'operatore.

parametri DeployMySqlProvider.ps1

Specificare questi parametri dalla riga di comando. Se non vengono specificati o se la convalida dei parametri ha esito negativo, lo script richiede di specificare i parametri necessari.

Distribuire il provider di risorse MySQL usando uno script personalizzato

Se distribuisci il provider di risorse MySQL versione 1.1.47.0 o versione successiva, lo script di distribuzione scarica e installa automaticamente i moduli PowerShell necessari nel percorso 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

Per eliminare qualsiasi configurazione manuale durante la distribuzione del provider di risorse, personalizzare lo script seguente. Modificare le informazioni e le password predefinite dell'account in base alle esigenze per la distribuzione dell'hub di Azure Stack.

# 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

Al termine dello script di installazione del provider di risorse, aggiornare il browser per assicurarsi di visualizzare gli aggiornamenti più recenti e chiudere la sessione corrente di PowerShell.

Verificare la distribuzione V1 usando il portale dell'hub di Azure Stack

1. Accedere al portale di amministrazione come amministratore del servizio.
2. Selezionare Gruppi di Risorse.
3. Selezionare il sistema . Ubicazione<>.mysqladapter gruppo di risorse.
4. Nella pagina di riepilogo panoramica del gruppo di risorse non devono essere presenti distribuzioni non riuscite.
5. Infine, selezionare Macchine virtuali nel portale di amministrazione per verificare che la macchina virtuale del provider di risorse MySQL sia stata creata correttamente ed è in esecuzione.

Configurazione importante per Microsoft Entra ID

Se il hub di Azure Stack usa Microsoft Entra ID come provider di identità, assicurarsi che la macchina virtuale che installa il provider di risorse del server MySQL abbia connettività Internet in uscita.

Passaggi successivi

Aggiungere server di hosting