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

Importante

Les fournisseurs de ressources SQL et MySQL pour Azure Stack Hub sont déconseillés et ne sont pas disponibles pour l'intégration de nouveaux clients. Au lieu de cela, déployez SQL ou MySQL directement sur des machines virtuelles et gérez-les à l’aide d’outils et pratiques standard. Les déploiements existants des fournisseurs de ressources continuent d’être pris en charge, mais aucune nouvelle fonctionnalité de développement ou d’intégration n’est planifiée.

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

Le fournisseur de ressources MySQL s’exécute en tant que service sur une machine virtuelle Windows Server 2016 Server Core.

Le fournisseur de ressources MySQL s’exécute en tant que service sur un serveur Windows Server spécial Add-on RP.

Seul le fournisseur de ressources doit créer des éléments sur les serveurs qui hébergent SQL ou MySQL. Les éléments créés sur un serveur hôte qui ne sont pas créés par le fournisseur de ressources ne sont pas pris en charge et peuvent entraîner une incompatibilité.

Conditions préalables

Si vous avez déjà installé un fournisseur de ressources, vous avez probablement effectué les prérequis suivants et pouvez ignorer cette section. Sinon, effectuez ces étapes avant de continuer.

  1. Inscrivez votre instance Azure Stack Hub auprès d’Azure si ce n’est déjà fait. Vous devez inscrire votre instance de Azure Stack Hub auprès de Azure, car vous vous connecterez à Azure et téléchargerez des éléments à partir de la Place de marché.

  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 de Azure Stack Hub est déconnectée ou partiellement connectée, vous devez remplir des prérequis supplémentaires en vue de l’installation.

  3. Mettez à jour votre répertoire de base Microsoft Entra. À partir de la version 1910, vous devez enregistrer une nouvelle application dans le locataire de votre annuaire de base. Cette application permet à Azure Stack Hub de créer et d’enregistrer avec succès des fournisseurs de ressources plus récents (comme Azure Event Hubs, entre autres) dans votre tenant Microsoft Entra.

    Cette action est requise après la mise à niveau vers la build 1910 ou ultérieure. Si vous n’effectuez pas cette étape, les installations des fournisseurs de ressources à partir de la Place de marché échouent.

  4. Une fois que vous avez correctement mis à jour votre instance de Azure Stack Hub vers la version 1910 ou ultérieure, suivez les instructions pour cloner/télécharger le référentiel Azure Stack Hub Tools.

  5. Suivez les instructions pour mettre à jour le répertoire de base Azure Stack Hub Microsoft Entra (après avoir installé des mises à jour ou de nouveaux fournisseurs de ressources).

Conditions préalables du fournisseur de ressources MySQL Server

  • Vous avez 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).
    • au point de terminaison d’administration Azure Resource Manager, https://adminmanagement.region.<fqdn>, où <fqdn> représente votre nom de domaine complet
    • l'Internet, si votre Azure Stack Hub a été déployé pour utiliser Microsoft Entra ID en tant que fournisseur d'identité.
  • Téléchargez la version prise en charge du binaire du fournisseur de ressources MySQL selon la table de correspondance des versions figurant dans la section suivante. 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 Microsoft AzureStack Add-on RP Windows Server 1.2009.0
    2108, 2206 MySQL RP version 2.0.6.x Microsoft AzureStack Add-on 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 de la table de mappage de version si nécessaire.

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

    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 le SAN sont correctement définis. Conditions préalables obligatoires PKI pour le déploiement d’Azure Stack HubConditions préalables pour les certificats PaaS 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. L’autre nom de l’objet doit respecter le modèle de nommage suivant : CN=*.dbadapter.<région>.<fqdn>, avec protection par mot de passe. Capture d’écran du certificat.
    • 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 hors connexion

Lors du déploiement du fournisseur de ressources MySQL Server V2 dans un scénario déconnecté, suivez les instructions de téléchargement des éléments de la Place de marché vers 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 vous ne l'avez pas déjà fait, connectez-vous au portail administrateur Azure Stack Hub, sélectionnez Marketplace Management à gauche, puis sélectionnez Resource providers.

  2. Après avoir téléchargé le fournisseur de ressources MySQL et d’autres logiciels requis, la Gestion de la Place de marché affiche les packages « Fournisseur de ressources MySQL Server » avec l’état « Non installé ». Vous pouvez voir d’autres packages qui affichent l’état « Téléchargé ».

    Capture d’écran de la gestion du marketplace avant d’installer le RP.

  3. Sélectionnez la ligne à 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. Capture d'écran de la gestion de la place de marché pour commencer l'installation du RP.

Installer les prérequis

  1. Ensuite, vous êtes transféré vers la page d’installation. Sélectionnez Prérequis pour l’installation pour commencer le processus d’installation. Capture d’écran des prérequis d’installation de la gestion de la Place de marché.

  2. Attendez que l’installation des prérequis réussisse. Vous devez voir une coche verte à côté de Prérequis pour l’installation avant de passer à l’étape suivante. Capture d'écran de la gestion de la place de marché : l'installation des prérequis a réussi.

Préparer les secrets

  1. Sous le 2. Préparer l’étape des secrets , sélectionnez Ajouter un certificat. Le panneau Ajouter un certificat s’affiche. Capture d'écran des secrets de préparation de la gestion de la place de marché.

  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. Capture d’écran de certificat d’ajout de gestion de la place de marché.

Configurer et installer le fournisseur de ressources

  1. Une fois le certificat installé avec succès, une coche verte s’affiche à côté de Préparer les secrets. Sélectionnez maintenant le bouton Configurer + Installer en regard de 3 Installer le fournisseur de ressources. Capture d'écran de l'installation du RP de démarrage de la gestion de la place de marché.

  2. Ensuite, fournissez 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 ». Capture d’écran de la création d’un compte de stockage. Capture d’écran de la création d’un conteneur de stockage.

    • Chargez le mysql-connector-net-8.0.21.msi fichier à partir de votre dossier local dans le conteneur de stockage nouvellement créé. Capture d’écran du chargement du connecteur MySQL sur le conteneur.

    Importante

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

    • Copiez l’URI d’objet blob. Capture d’écran de la copie de l’URI du connecteur MySQL.

    • Revenez à la page de configuration de MySQL RP. Collez l’URI d’objet blob (par exemple) https://<storageAccountName>.blob.<region>.<FQDN>/<containerName>/mysql-connector-net-8.0.21.msidans la zone de texte et sélectionnez OK. Capture d’écran de la fourniture de l’URI du connecteur MySQL.

  3. Ensuite, vous voyez la page suivante, qui indique que le fournisseur de ressources MySQL est en cours d’installation. Capture d'écran de l'installation du RP de gestion de la place de marché.

  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. Capture d'écran de l'installation du RP de gestion de la place de marché en cours.

  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é ». Capture d'écran de la place de marché RP installée.

Déployer le fournisseur de ressources SQL V1

Une fois toutes les conditions préalables remplies, 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 de Azure Stack Hub.

Importante

Avant de déployer le fournisseur de ressources, passez en revue les notes de publication pour en savoir plus sur les nouvelles fonctionnalités, les correctifs et les problèmes connus susceptibles d’affecter votre déploiement.

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.

Importante

Utilisez Clear-AzureRmContext -Scope CurrentUser et Clear-AzureRmContext -Scope Process pour effacer le cache avant d’exécuter le script de déploiement ou de mise à jour.

Remarque

Si vous déployez le fournisseur de ressources MySQL Server V1 dans un environnement déconnecté, copiez le fichier mysql-connector-net-6.10.5.msi dans un chemin d’accès local. Indiquez le nom du chemin à l’aide du paramètre DependencyFilesLocalPath .

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éployer une machine virtuelle en utilisant l’image Windows Server 2016 Core ou l’image Windows Server du module complémentaire RP Microsoft AzureStack que vous avez téléchargée, puis installer 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.

Remarque

Lorsque le déploiement du fournisseur de ressources MySQL démarre, le groupe de ressources system.local.mysqladapter est créé. La fin des déploiements requis pour ce groupe de ressources peut prendre jusqu’à 75 minutes. Ne placez aucune autre ressource dans le groupe de ressources system.local.mysqladapter .

paramètres de DeployMySqlProvider.ps1

Spécifiez ces paramètres à partir de la ligne de commande. Si vous ne les spécifiez pas ou si une validation de paramètre échoue, le script vous invite à fournir les paramètres requis.

Nom du paramètre Descriptif Commentaire ou valeur par défaut
CloudAdminCredential Informations d’identification de l’administrateur cloud, nécessaires pour accéder au point de terminaison privilégié. Obligatoire
AzCredential Informations d’identification pour le compte d’administrateur du service Azure Stack Hub. Utilisez les mêmes informations d’identification que celles que vous avez utilisées pour déployer Azure Stack Hub. Le script échoue si le compte que vous utilisez avec AzCredential nécessite une authentification multifacteur (MFA). Obligatoire
VMLocalCredential Informations d’identification pour le compte d’administrateur local de la machine virtuelle du fournisseur de ressources MySQL. Obligatoire
PrivilegedEndpoint Adresse IP ou nom DNS du point de terminaison privilégié. Obligatoire
AzureEnvironment Environnement Azure du compte d’administrateur de service utilisé pour le déploiement d’Azure Stack Hub. Obligatoire uniquement pour les déploiements Microsoft Entra. Les noms d’environnement pris en charge sont AzureCloud, AzureUSGovernment ou si vous utilisez un ID Microsoft Entra chine, AzureChinaCloud. AzureCloud
DependencyFilesLocalPath Pour les systèmes intégrés uniquement, placez votre fichier .pfx de certificat dans ce répertoire. Pour les environnements déconnectés, téléchargez mysql-connector-net-6.10.5.msi dans ce répertoire. Vous pouvez éventuellement copier un package MSU Windows Update ici. Facultatif (obligatoire pour les systèmes intégrés ou les environnements déconnectés)
DefaultSSLCertificatePassword Mot de passe du certificat .pfx. Obligatoire
MaxRetryCount Nombre de fois où vous souhaitez réessayer chaque opération en cas de défaillance. 2
RetryDuration Intervalle de délai d’expiration entre les nouvelles tentatives, en secondes. 01:20:21
Désinstaller Supprime le fournisseur de ressources et toutes les ressources associées (consultez les notes suivantes). Non
DebugMode Empêche le nettoyage automatique en cas d’échec. Non
AcceptLicense Ignore l’invite à accepter la licence GPL. https://www.gnu.org/licenses/old-licenses/gpl-2.0.html

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.33.0 ou antérieure, vous devez installer des versions spécifiques d'AzureRm.BootStrapper et des modules Azure Stack Hub dans PowerShell.

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 le chemin d’accès 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

Remarque

Dans le scénario déconnecté, vous devez télécharger les modules PowerShell requis et inscrire le référentiel manuellement en tant que prérequis.

Pour éliminer toute configuration manuelle lors du déploiement du fournisseur de ressources, personnalisez 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 groupe de ressources system.<location>.mysqladapter.
  4. Sur la page récapitulative de l'aperçu du groupe de ressources, il ne doit y avoir aucun déploiement é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 installe le fournisseur de ressources MySQL Server dispose d’une connectivité Internet sortante.

Étapes suivantes

Ajouter des serveurs d’hébergement