Déployer le fournisseur de ressources MySQL sur Azure Stack Hub

Utilisez le fournisseur de ressources MySQL Server pour exposer les bases de données MySQL en tant que service Azure Stack Hub.

Conditions préalables

Si vous avez déjà installé un fournisseur de ressources, vous avez probablement rempli les prérequis suivants et pouvez ignorer cette section. Sinon, faites ce qui suit avant de continuer :

1. Inscrivez votre instance Azure Stack Hub auprès d’Azure si ce n’est déjà fait. Cette étape est nécessaire, car vous allez vous connecter à la Place de marché et y télécharger des éléments à partir d’Azure.

2. Si vous ne connaissez pas la fonctionnalité Gestion de la Place de marché du portail administrateur Azure Stack Hub, consultez Télécharger des éléments de la Place de marché Azure et les publier sur Azure Stack Hub. Cet article vous guide tout au long du processus de téléchargement des éléments à partir d’Azure vers la Place de marché Azure Stack Hub. Il couvre les deux scénarios, connecté et déconnecté. Si votre instance Azure Stack Hub est déconnectée ou partiellement connectée, d’autres prérequis doivent être respectés en vue de l’installation.

3. Mettez à jour votre répertoire de base Microsoft Entra. À partir de la build 1910, une nouvelle application doit être inscrite dans votre abonné de répertoire de base. Cette application permet à Azure Stack Hub de créer et d’inscrire des fournisseurs de ressources plus récents (comme Event Hubs et d’autres) auprès de votre locataire Microsoft Entra. Il s’agit d’une action ponctuelle qui doit être effectuée après la mise à niveau vers la build 1910 ou une build plus récente. Si cette étape n’est pas effectuée, les installations du fournisseur de ressources échouent.

   • Après avoir correctement mis à jour votre instance Azure Stack Hub vers la build 1910 (ou supérieure), suivez les instructions relatives au clonage/téléchargement du dépôt d’outils Azure Stack Hub.
   • Ensuite, suivez les instructions pour mettre à jour le répertoire d’accueil Microsoft Entra De Azure Stack Hub (après avoir installé des mises à jour ou de nouveaux fournisseurs de ressources).

Conditions préalables du fournisseur de ressources MySQL Server

• Vous aurez besoin d’un ordinateur et d’un compte qui peuvent accéder à :

  • portail d’administration Azure Stack Hub.
  • le point de terminaison privilégié (nécessaire uniquement lorsque vous déployez le fournisseur de ressources MySQL Server V1 ou la mise à niveau du fournisseur de ressources MySQL Server V1 vers le fournisseur de ressources MySQL Server V2).
  • le point de terminaison d’administrateur Azure Resource Manager, https://adminmanagement.region.<fqdn>où <fqdn> se trouve votre nom de domaine complet.
  • Internet, si votre Azure Stack Hub a été déployé pour utiliser Microsoft Entra ID comme fournisseur d’identité.

• Téléchargez la version prise en charge du fichier binaire du fournisseur de ressources MySQL en fonction du tableau de mappage de version ci-dessous. Pour le fournisseur de ressources MySQL V2, téléchargez l’élément de la Place de marché sur Azure Stack Hub.

  Version d’Azure Stack Hub prise en charge	Version du fournisseur de ressources MySQL	Windows Server sur lequel le service rp s’exécute
  2206, 2301, 2306, 2311	MySQL RP version 2.0.13.x	Module complémentaire Microsoft AzureStack RP Windows Server 1.2009.0
  2108, 2206	MySQL RP version 2.0.6.x	Module complémentaire Microsoft AzureStack RP Windows Server 1.2009.0

• Vérifiez que la machine virtuelle Windows Server requise est téléchargée sur la Place de marché Azure Stack Hub. Téléchargez manuellement l’image en fonction du tableau de mappage de version ci-dessus si nécessaire.

• Vérifier que les conditions préalables à l’intégration du centre de données sont remplies :R

  Prérequis	Référence
  Le transfert DNS conditionnel est défini correctement.	Intégration du centre de données Azure Stack Hub - DNS
  Les ports entrants pour les fournisseurs de ressources sont ouverts.	Intégration du centre de données Azure Stack Hub - Publier des points de terminaison
  Le sujet du certificat PKI et san sont correctement définis.	Conditions préalables requises pour le déploiement d’Azure Stack Hub pour le déploiement PaaS obligatoires pour le déploiement d’Azure Stack Hub

• Préparer le certificat. (Pour les installations de systèmes intégrés uniquement.)

  • Vous devez fournir le certificat PKI PaaS SQL décrit dans la section facultative certificats PaaS des exigences relatives à l’infrastructure à clé publique de déploiement Azure Stack Hub. Le nom de remplacement de l’objet (SAN) doit respecter le modèle de nommage suivant : CN=*.dbadapter.<région>.<fqdn>, avec un mot de passe protégé.
  • Lors du déploiement du fournisseur de ressources MySQL Server V1, placez le fichier .pfx à l’emplacement spécifié par le paramètre DependencyFilesLocalPath . Ne fournissez pas de certificat pour les systèmes ASDK.
  • Lors du déploiement du fournisseur de ressources MySQL Server V2, préparez le certificat pour les étapes d’installation suivantes.

Scénario déconnecté

Lors du déploiement du fournisseur de ressources MySQL Server V2 dans un scénario déconnecté, suivez les éléments de la Place de marché de téléchargement vers l’instruction Azure Stack Hub pour télécharger l’élément du fournisseur de ressources MySQL Server et l’élément Windows Server du module complémentaire RP dans votre environnement Azure Stack Hub.

Lors du déploiement du fournisseur de ressources MySQL Server V1 dans un scénario déconnecté, effectuez les étapes suivantes pour télécharger les modules PowerShell requis et inscrire le référentiel manuellement.

1. Connectez-vous à un ordinateur disposant d’une connectivité Internet et utilisez les scripts suivants pour télécharger les modules 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. Selon la version du fournisseur de ressources que vous déployez, exécutez l’un des scripts.

   # 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. Ensuite, vous copiez les packages téléchargés sur un périphérique USB.

4. Connectez-vous à la station de travail déconnectée et copiez les packages du périphérique USB vers un emplacement sur la station de travail.

5. Inscrivez cet emplacement en tant que référentiel local.

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

Déployer le fournisseur de ressources MySQL V2

Si vous effectuez une mise à niveau à partir d’une version V1, reportez-vous au document Mettre à jour le fournisseur de ressources MySQL Server.

Démarrer l’installation

1. Si ce n'est déjà fait, connectez-vous au portail d'administration Azure Stack Hub, sélectionnez Gestion de la Place de marché sur la gauche, puis choisissez Fournisseurs de ressources.

2. Une fois que le fournisseur de ressources MySQL et d’autres logiciels requis ont été téléchargés, la Gestion de la Place de marché affiche les packages « Fournisseur de ressources MySQL Server » avec l’état « Non installé ». Il peut y avoir d’autres packages qui affichent l’état « Téléchargé ».

   

3. Sélectionnez la ligne que vous souhaitez installer. La page du package d’installation du fournisseur de ressources MySQL Server affiche une bannière bleue en haut. Sélectionnez la bannière pour démarrer l’installation.

Installer les prérequis

1. Vous êtes ensuite dirigé vers la page d’installation. Sélectionnez Prérequis pour l’installation pour commencer le processus d’installation.

2. Attendez la fin de l’installation des prérequis. Vous devez voir une coche verte en regard de Prérequis pour l’installation avant de passer à l’étape suivante.

Préparer les secrets

1. Sous le 2. Préparez l’étape des secrets , sélectionnez Ajouter un certificat et le panneau Ajouter un certificat s’affiche.

2. Sélectionnez le bouton Parcourir sur Ajouter un certificat, juste à droite du champ de nom de fichier du certificat. Sélectionnez le fichier de certificat .pfx que vous avez obtenu lors de la finalisation des prérequis.

3. Entrez le mot de passe que vous avez fourni pour créer une chaîne sécurisée pour le certificat SSL du fournisseur de ressources SQL Server. Ensuite, cliquez sur Ajouter.

Configurer et installer le fournisseur de ressources

1. Lorsque l’installation du certificat aboutit, vous devez voir une coche verte en regard de Préparer les secrets avant de passer à l’étape suivante. Sélectionnez maintenant le bouton Configurer + Installer en regard de 3 Installer le fournisseur de ressources.

2. Ensuite, vous devez fournir un URI d’objet blob Azure Stack Hub pour Le connecteur MySQL.

   • Passez en revue la licencePG de MySQL Connector ici et téléchargez la version 8.0.21 dans un dossier local.

   • Créez un compte de stockage avec votre abonnement opérateur par défaut et créez un conteneur avec le niveau d’accès « Blob » ou « Conteneur ».

   • Chargez le fichier mysql-connector-net-8.0.21.msi à partir de votre dossier local vers le conteneur de stockage nouvellement créé.

   Important

   Vérifiez que la version du connecteur MySQL est 8.0.21.

   • Copiez l’URI de l’objet blob.

   • Revenez à la page de configuration de MySQL RP. Collez l’URI de l’objet blob (par exemple, https://< storageAccountName.blob>.<région>.<FQDN>/<containerName>/mysql-connector-net-8.0.21.msi) dans la zone de texte, puis cliquez sur OK.

3. Vous verrez ensuite la page suivante, qui indique que le fournisseur de ressources MySQL est en cours d’installation.

4. Attendez la notification de fin de l’installation. Ce processus prend généralement une ou plusieurs heures, en fonction de votre type Azure Stack Hub.

5. Vérifiez que l’installation du fournisseur de ressources MySQL Server a réussi, en retournant à la page Gestion de la Place de marché, Fournisseurs de ressources . L’état du fournisseur de ressources MySQL Server doit afficher « Installé ».

Déployer le fournisseur de ressources SQL V1

Une fois que vous avez terminé toutes les conditions préalables, exécutez l’auto-extracteur pour extraire le package d’installation téléchargé dans un répertoire temporaire. Exécutez le script DeployMySqlProvider.ps1 à partir d’un ordinateur qui peut accéder à la fois au point de terminaison administrateur Azure Stack Hub Azure Resource Manager et au point de terminaison privilégié, pour déployer le fournisseur de ressources MySQL. Le script DeployMySqlProvider.ps1 est extrait dans le cadre des fichiers d’installation du fournisseur de ressources MySQL que vous avez téléchargés pour votre version d’Azure Stack Hub.

Pour déployer le fournisseur de ressources MySQL, ouvrez une nouvelle fenêtre PowerShell avec élévation de privilèges (et non PowerShell ISE) et passez au répertoire dans lequel vous avez extrait les fichiers binaires du fournisseur de ressources MySQL.

Exécutez le script DeployMySqlProvider.ps1 , qui effectue les tâches suivantes :

• Charge les certificats et d’autres artefacts dans un compte de stockage sur Azure Stack Hub.
• Publie des packages de galerie afin de pouvoir déployer des bases de données MySQL à l’aide de la galerie.
• Publie un package de galerie pour le déploiement de serveurs d’hébergement.
• Déploie une machine virtuelle à l’aide de l’image principale de Windows Server 2016 ou de l’image Windows Server du module complémentaire Microsoft AzureStack que vous avez téléchargée, puis installe le fournisseur de ressources MySQL.
• Inscrit un enregistrement DNS local mappé à votre machine virtuelle du fournisseur de ressources.
• Inscrit votre fournisseur de ressources auprès d’Azure Resource Manager local pour le compte d’opérateur.

paramètres de DeployMySqlProvider.ps1

Vous pouvez spécifier ces paramètres à partir de la ligne de commande. Si vous ne le faites pas ou si une validation de paramètre échoue, vous êtes invité à fournir les paramètres requis.

Déployer le fournisseur de ressources MySQL à l’aide d’un script personnalisé

Si vous déployez le fournisseur de ressources MySQL version 1.1.47.0 ou ultérieure, le script de déploiement télécharge et installe automatiquement les modules PowerShell nécessaires pour vous permettre de cheminer 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

Pour éliminer toute configuration manuelle lors du déploiement du fournisseur de ressources, vous pouvez personnaliser le script suivant. Modifiez les informations et mots de passe de compte par défaut en fonction des besoins de votre déploiement Azure Stack Hub.

# 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

Une fois le script d’installation du fournisseur de ressources terminé, actualisez votre navigateur pour vous assurer que vous pouvez voir les dernières mises à jour et fermer la session PowerShell actuelle.

Vérifier le déploiement V1 à l’aide du portail Azure Stack Hub

1. Connectez-vous au portail administrateur en tant qu’administrateur de service.
2. Cliquez sur Groupes de ressources.
3. Sélectionnez le système.<groupe de ressources location.mysqladapter>.
4. Dans la page récapitulative de la vue d’ensemble du groupe de ressources, aucun déploiement n’a échoué.
5. Enfin, sélectionnez Machines virtuelles dans le portail d’administration pour vérifier que la machine virtuelle du fournisseur de ressources MySQL a été correctement créée et s’exécute.

Configuration importante pour l’ID Microsoft Entra

Si votre azure Stack Hub utilise Microsoft Entra ID en tant que fournisseur d’identité, vérifiez que la machine virtuelle qui a installé le fournisseur de ressources MySQL Server dispose d’une connectivité Internet sortante.

Étapes suivantes

Ajouter des serveurs d’hébergement