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

Importante

A partire dalla build 2108 dell'hub di Azure Stack, i provider di risorse SQL e MySQL vengono offerti alle sottoscrizioni a cui è stato concesso l'accesso. Se si vuole iniziare a usare questa funzionalità o se è necessario eseguire l'aggiornamento da una versione precedente, aprire un caso di supporto e i tecnici del supporto guideranno l'utente nel processo di distribuzione o aggiornamento.

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

Il provider di risorse MySQL viene eseguito come servizio su un Windows Server speciale con componente aggiuntivo RP.

Importante

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 possono 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. Questo passaggio è obbligatorio perché ci si connette e si scaricano elementi in Marketplace da Azure.

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 dell'hub di Azure Stack è disconnessa o parzialmente connessa, sono necessari prerequisiti aggiuntivi per completare 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 consentirà all'hub di Azure Stack di creare e registrare correttamente i provider di risorse più recenti (ad esempio Hub eventi e altri) con il tenant di Microsoft Entra. Si tratta di un'azione una tantum che deve essere eseguita dopo l'aggiornamento alla build 1910 o successiva. Se questo passaggio non viene completato, le installazioni del provider di risorse del Marketplace avranno esito negativo.

   • Dopo aver aggiornato l'istanza dell'hub di Azure Stack alla versione 1910 o successiva, seguire le istruzioni per clonare/scaricare il repository degli strumenti dell'hub di Azure Stack.
   • Seguire quindi le istruzioni per Aggiornamento dell'hub di Azure Stack Microsoft Entra Home Directory (dopo l'installazione di aggiornamenti o 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à.

• Scarica la versione supportata del file binario del provider di risorse MySQL in base alla tabella di corrispondenza della versione 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 Di Microsoft AzureStack Windows Server 1.2009.0

• Assicurarsi che la macchina virtuale Windows Server richiesta venga scaricata in Azure Stack Hub Marketplace. Scaricare manualmente l'immagine secondo la tabella di mapping delle versioni sopra, se necessario.

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

  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 Azure Stack Hub - 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 Azure Stack Hub, seleziona Gestione del Marketplace a sinistra, e seleziona il provider di risorse.

2. Dopo aver scaricato il provider di risorse MySQL e altri software necessari, Marketplace Management mostra i pacchetti "Provider di risorse server MySQL" con lo stato "Non installato". Potrebbero essere presenti 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. Sotto il passaggio 2. Preparare i segreti, selezionare Aggiungi certificato, e verrà 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 prima di procedere con il passaggio successivo verrà visualizzato un segno di spunta verde. Ora seleziona il pulsante Configura + Installa accanto a 3 Installa il provider di risorse.

2. Sarà quindi necessario fornire un URI BLOB dell'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 file mysql-connector-net-8.0.21.msi 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. Incolla il blob URI (ad esempio https://<storageAccountName>.blob.<region>.<FQDN>/<containerName>/mysql-connector-net-8.0.21.msi) nella casella di testo e fai clic su OK.

3. Verrà 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 del server MySQL abbia avuto esito positivo tornando alla pagina Gestione del 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 Azure Stack Hub 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 dell'hub di Azure Stack.

Importante

Prima di distribuire il provider di risorse, esaminare le note sulla versione per informazioni sulle nuove funzionalità, sulle correzioni e sugli eventuali problemi noti che potrebbero influire sulla distribuzione.

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.

Importante

È consigliabile usare Clear-AzureRmContext -Scope CurrentUser e Clear-AzureRmContext -Scope Processo per cancellare la cache prima di eseguire lo script di distribuzione o aggiornamento.

Nota

Se si distribuisce il provider di risorse mySQL Server V1 in un ambiente disconnesso, copiare il file mysql-connector-net-6.10.5.msi in un percorso locale. Specificare il nome del percorso usando il parametro DependencyFilesLocalPath.

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 per consentire la distribuzione dei database MySQL utilizzando la galleria.
• Pubblica un pacchetto della raccolta per la distribuzione dei server di hosting.
• Distribuisce una macchina virtuale usando l'immagine principale di Windows Server 2016 o l'immagine di Windows Server del componente aggiuntivo Microsoft AzureStack scaricata e 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.

Nota

All'avvio della distribuzione del provider di risorse MySQL, viene creato il system.local.mysqladapter gruppo di risorse. Il completamento delle distribuzioni necessarie per questo gruppo di risorse può richiedere fino a 75 minuti. Non inserire altre risorse nel system.local.mysqladapter gruppo di risorse.

parametri DeployMySqlProvider.ps1

È possibile specificare questi parametri dalla riga di comando. In caso contrario, o se la convalida dei parametri non riesce, viene richiesto di specificare i parametri necessari.

Il nome del parametro	Descrizione	Commento o valore predefinito
CloudAdminCredential	Credenziali per l'amministratore cloud, necessarie per accedere all'endpoint con privilegi.	obbligatorio
AzCredential	Credenziali per l'account amministratore del servizio hub di Azure Stack. Usare le stesse credenziali usate per la distribuzione dell'hub di Azure Stack. Lo script avrà esito negativo se l'account usato con AzCredential richiede l'autenticazione a più fattori (MFA).	obbligatorio
VMLocalCredential	Credenziali per l'account amministratore locale della macchina virtuale del provider di risorse MySQL.	obbligatorio
Punto di Accesso Privilegiato	Indirizzo IP o nome DNS dell'endpoint con privilegi.	obbligatorio
AzureEnvironment	Ambiente di Azure dell'account amministratore del servizio usato per la distribuzione dell'hub di Azure Stack. Obbligatorio solo per le distribuzioni di Microsoft Entra. I nomi di ambiente supportati sono AzureCloud, AzureUSGovernmento se si usa un ID Microsoft Entra cina, AzureChinaCloud.	AzureCloud
DependencyFilesLocalPath	Solo per i sistemi integrati, il file con estensione pfx del certificato deve essere inserito in questa directory. Per gli ambienti disconnessi, scaricare i file mysql-connector-net-6.10.5.msi in questa directory. Facoltativamente, puoi copiare un pacchetto MSU di Windows Update qui.	facoltativi ( obbligatori per sistemi integrati o ambienti disconnessi)
defaultSSLCertificatePassword	Password per il certificato pfx.	obbligatorio
MaxRetryCount	Numero di tentativi di ripetizione di ogni operazione in caso di errore.	2
Durata Riprova	Intervallo di timeout tra tentativi, in secondi.	120
Disinstallare	Rimuove il provider di risorse e tutte le risorse associate (vedere le note seguenti).	No
DebugMode	Impedisce la pulizia automatica in caso di errore.	No
AccettaLicenza	Ignora la richiesta di accettare la licenza GP. https://www.gnu.org/licenses/old-licenses/gpl-2.0.html

Distribuire il provider di risorse MySQL usando uno script personalizzato

Se si distribuisce il provider di risorse MySQL versione 1.1.47.0 o successiva, lo script di distribuzione scaricherà e installerà automaticamente i moduli di PowerShell necessari per il percorso C:\Programmi\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

Nota

In uno scenario disconnesso, è necessario scaricare i moduli di PowerShell necessari e registrare il repository manualmente come prerequisito.

Per eliminare qualsiasi configurazione manuale durante la distribuzione del provider di risorse, è possibile 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 l'hub di Azure Stack usa l'ID Microsoft Entra come provider di identità, verificare che la macchina virtuale che abbia installato il provider di risorse del server MySQL abbia connettività Internet in uscita.

Se è necessario ottenere l'indirizzo IP della macchina virtuale che ha installato il provider di risorse del server MySQL (ad esempio, aggiungere l'INDIRIZZO IP all'elenco di indirizzi consentiti del firewall), è necessario aprire un caso di supporto e fare in modo che il tecnico del supporto renda temporaneamente visibile la sottoscrizione del provider di risorse del server MySQL. È quindi possibile individuare la macchina virtuale nella sottoscrizione e ottenere il relativo INDIRIZZO IP.

Passaggi successivi

Aggiungere server di hosting