Démarrage rapide : créer une instance d’Azure Database pour PostgreSQL – Serveur flexible avec Azure CLI
S’APPLIQUE À :
Azure Database pour PostgreSQL – Serveur flexible
Ce guide de démarrage rapide montre comment utiliser les commandes Azure CLI dans Azure Cloud Shell afin de créer une instance de serveur flexible Azure Database pour PostgreSQL en cinq minutes. Si vous n’avez pas d’abonnement Azure, créez un compte gratuit avant de commencer.
Lancement d’Azure Cloud Shell
Azure Cloud Shell est un interpréteur de commandes interactif et gratuit que vous pouvez utiliser pour exécuter les étapes de cet article. Il contient des outils Azure courants préinstallés et configurés pour être utilisés avec votre compte.
Pour ouvrir Cloud Shell, sélectionnez simplement Essayer en haut à droite d’un bloc de code. Vous pouvez également ouvrir Cloud Shell dans un onglet distinct du navigateur en accédant à https://shell.azure.com/bash. Sélectionnez Copier pour copier les blocs de code, collez-les dans Cloud Shell et sélectionnez Entrée pour les exécuter.
Si vous préférez installer et utiliser l’interface de ligne de commande en local, ce guide de démarrage rapide nécessite au minimum la version 2.0 d’Azure CLI. Exécutez az --version pour trouver la version. Si vous devez installer ou mettre à niveau, voir Installer Azure CLI.
Prérequis
Vous devez vous connecter à votre compte à l’aide de la commande az login. Notez la propriété id dans la sortie, qui correspond à l’ID d’abonnement de votre compte Azure.
az login
Sélectionnez l’abonnement spécifique sous votre compte à l’aide de la commande az account set. Utilisez la valeur id figurant dans la sortie de la commande az login comme valeur de l’argument subscription dans la commande. Si vous avez plusieurs abonnements, sélectionnez l’abonnement approprié dans lequel la ressource doit être facturée. Pour accéder à l’ensemble de votre abonnement, utilisez az account list.
az account set --subscription <subscription id>
Créer un serveur flexible
Créez un groupe de ressources Azure à l’aide de la commande az group create, puis créez votre instance de serveur flexible Azure Database pour PostgreSQL à l’intérieur de ce groupe de ressources. Vous devez fournir un nom unique. L’exemple suivant crée un groupe de ressources nommé myresourcegroup à l’emplacement eastus.
az group create --name myresourcegroup --location eastus
Créez une instance de serveur flexible Azure Database pour PostgreSQL avec la commande az postgres flexible-server create. Un serveur peut contenir plusieurs bases de données. La commande suivante crée un serveur dans le groupe de ressources que vous venez de créer :
az postgres flexible-server create --name mydemoserver --resource-group myresourcegroup
Étant donné que la méthode de connectivité par défaut est Accès public (adresses IP autorisées), la commande vous invite à confirmer si vous souhaitez ajouter votre adresse IP et/ou toutes les adresses IP (plage allant de 0.0.0.0.0 à 255.255.255.255) à la liste des adresses autorisées.
Le serveur créé possède les attributs suivants :
- Le même emplacement que votre groupe de ressources
- Nom d’utilisateur administrateur et mot de passe administrateur générés automatiquement (que vous devez enregistrer dans un endroit sécurisé)
- Une base de données par défaut nommée « flexibleserverdb »
- Valeurs par défaut du service pour les configurations serveur restantes : niveau de calcul (Usage général), taille de calcul/SKU (
Standard_D2s_v3- 2 vCore, 8 Go de RAM), période de conservation des sauvegardes (7 jours) et version de PostgreSQL (13)
Remarque
Une fois le serveur créé, il n’est pas possible de changer la méthode de connectivité. Par exemple, si vous avez sélectionné Accès privé (intégration au réseau virtuel) pendant la création, vous ne pouvez pas remplacer cette méthode par Accès public (adresses IP autorisées) à l’issue de la création. Nous vous recommandons vivement de sélectionner l'Accès privé lors de la création d'un serveur afin de pouvoir y accéder en toute sécurité à l'aide de l'intégration au réseau virtuel. Pour en savoir plus sur l'accès privé, consultez l'article consacré aux concepts.
Si vous souhaitez changer les valeurs par défaut, reportez-vous aux informations de référence d’Azure CLI sur az postgres flexible-server create.
Remarque
Les connexions au serveur flexible Azure Database pour PostgreSQL communiquent via le port 5432. Si vous essayez de vous connecter à partir d’un réseau d’entreprise, le trafic sortant sur le port 5432 peut être bloqué. Dans ce cas, vous ne pouvez pas vous connecter à votre serveur, sauf si votre service informatique ouvre le port 5432. Si vous activez PgBouncer sur votre instance de serveur flexible Azure Database pour PostgreSQL en vue de l’utiliser pour vous connecter, notez que votre service informatique doit ouvrir le port 6432 sur lequel il s’exécute pour autoriser le trafic sortant.
Obtenir les informations de connexion
Pour vous connecter à votre serveur, vous devez fournir des informations sur l’hôte et des informations d’identification pour l’accès.
az postgres flexible-server show --name mydemoserver --resource-group myresourcegroup
Le résultat est au format JSON. Notez les valeurs fullyQualifiedDomainName et administratorLogin. Vous avez normalement enregistré le mot de passe à l’étape précédente.
{
"administratorLogin": "myadmin",
"availabilityZone": "3",
"backup": {
"backupRetentionDays": 7,
"earliestRestoreDate": "2022-10-20T18:03:50.989428+00:00",
"geoRedundantBackup": "Disabled"
},
"earliestRestoreDate": null,
"fullyQualifiedDomainName": "mydemoserver.postgres.database.azure.com",
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myresourcegroup/providers/Microsoft.DBforPostgreSQL/flexibleServers/mydemoserver",
"location": "eastus",
"name": "mydemoserver",
"network": {
"delegatedSubnetResourceId": null,
"privateDnsZoneArmResourceId": null,
"publicNetworkAccess": "Enabled"
},
"resourceGroup": "myresourcegroup",
"sku": {
"name": "Standard_D2s_v3",
"tier": "GeneralPurpose"
},
"state": "Ready",
"storage": {
"storageSizeGb": 128
},
"tags": null,
"type": "Microsoft.DBforPostgreSQL/flexibleServers",
"version": "13"
}
Se connecter à l'aide du client de ligne de commande PostgreSQL
Tout d’abord, installez l’outil en ligne de commande psql.
Avec psql, connectez-vous à la base de données « flexibleserverdb » en utilisant la commande suivante. Remplacez les valeurs par le nom de domaine et le nom d’utilisateur générés automatiquement.
psql -h mydemoserver.postgres.database.azure.com -U myadmin flexibleserverdb
Notes
Si vous recevez une erreur The parameter PrivateDnsZoneArguments is required, and must be provided by customer, cela signifie que vous utilisez peut-être une version antérieure d’Azure CLI. Mettez à niveau Azure CLI et recommencez l’opération.
Nettoyer les ressources
Si vous n’avez pas besoin de ces ressources pour un autre guide de démarrage rapide ou didacticiel, vous pouvez les supprimer en exécutant la commande suivante :
az group delete --name myresourcegroup
Si vous souhaitez juste supprimer uniquement le serveur nouvellement créé, exécutez la commande az postgres flexible-server delete.
az postgres flexible-server delete --resource-group myresourcegroup --name mydemoserver