Démarrage rapide : Utiliser la commande az postgres up pour créer une instance Azure Database pour PostgreSQL – Serveur unique
S’APPLIQUE À :
Azure Database pour PostgreSQL – Serveur unique
Important
Azure Database pour PostgreSQL - Serveur unique est en voie de mise hors service. Nous vous recommandons vivement de procéder à une mise à niveau vers un serveur flexible Azure Database pour PostgreSQL. Pour plus d’informations sur la migration vers le Serveur flexible Azure Database pour PostgreSQL, consultez l’article Qu’arrive-t-il au Serveur unique Azure Database pour PostgreSQL ?.
Base de données Azure pour PostgreSQL est un service géré qui vous permet d’exécuter, de gérer et de mettre à l’échelle des bases de données PostgreSQL hautement disponibles dans le cloud. L’interface de ligne de commande (CLI) Azure permet de créer et gérer des ressources Azure à partir de la ligne de commande ou dans les scripts. Ce démarrage rapide vous montre comment utiliser la commande az postgres up pour créer un serveur Azure Database pour PostgreSQL à partir d’Azure CLI. En plus de créer le serveur, la commande az postgres up crée un exemple de base de données, un utilisateur racine dans la base de données, ouvre le pare-feu pour les services Azure et crée des règles de pare-feu par défaut pour l’ordinateur client. Ces valeurs par défaut aident à accélérer le processus de développement.
Si vous n’avez pas d’abonnement Azure, créez un compte gratuit Azure avant de commencer.
Créer un serveur Azure Database pour PostgreSQL
Prérequis
Utilisez l’environnement Bash dans Azure Cloud Shell. Pour plus d’informations, consultez Démarrage rapide pour Bash dans Azure Cloud Shell.
Si vous préférez exécuter les commandes de référence de l’interface de ligne de commande localement, installez l’interface Azure CLI. Si vous exécutez sur Windows ou macOS, envisagez d’exécuter Azure CLI dans un conteneur Docker. Pour plus d’informations, consultez Guide pratique pour exécuter Azure CLI dans un conteneur Docker.
Si vous utilisez une installation locale, connectez-vous à Azure CLI à l’aide de la commande az login. Pour finir le processus d’authentification, suivez les étapes affichées dans votre terminal. Pour connaître les autres options de connexion, consultez Se connecter avec Azure CLI.
Lorsque vous y êtes invité, installez l’extension Azure CLI lors de la première utilisation. Pour plus d’informations sur les extensions, consultez Utiliser des extensions avec Azure CLI.
Exécutez az version pour rechercher la version et les bibliothèques dépendantes installées. Pour effectuer une mise à niveau vers la dernière version, exécutez az upgrade.
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 aussi lancer Cloud Shell dans un onglet distinct du navigateur en accédant à https://shell.azure.com.
Quand Cloud Shell s’ouvre, vérifiez que Bash est sélectionné pour votre environnement. Les sessions ultérieures utiliseront Azure CLI dans un environnement Bash. Sélectionnez Copier pour copier les blocs de code, collez-les dans Cloud Shell, puis appuyez sur Entrée pour les exécuter.
Connexion à Azure
Cloud Shell est automatiquement authentifié sous le compte initial utilisé pour la connexion. Utilisez le script suivant pour vous connecter avec un autre abonnement, en remplaçant <Subscription ID> par votre ID d’abonnement Azure. Si vous n’avez pas d’abonnement Azure, créez un compte gratuit Azure avant de commencer.
subscription="<subscriptionId>" # add subscription here
az account set -s $subscription # ...or use 'az login'
Pour plus d’informations, consultez Définir l’abonnement actif ou Se connecter de manière interactive
Installez l’extension db-up. Si une erreur est retournée, vérifiez que vous avez installé la dernière version d’Azure CLI. Consultez Installer Azure CLI.
az extension add --name db-up
Créez un serveur Azure Database pour PostgreSQL à l’aide de la commande suivante :
az postgres up
Le serveur est créé avec les valeurs par défaut suivantes (sauf si vous les remplacez manuellement) :
| Paramètre | Valeur par défaut | Description |
|---|---|---|
| server-name | Générée par le système | Un nom unique qui identifie votre serveur Azure Database pour PostgreSQL. |
| resource-group | Générée par le système | Nouveau groupe de ressources Azure. |
| sku-name | GP_Gen5_2 | Nom du la référence SKU. Suit la convention {niveau tarifaire}_{génération de calcul}_{vCores} dans le raccourci. Par défaut, il s’agit d’un serveur à usage général de 5e génération à 2 vCores. Consultez notre page de tarifs pour plus d’informations sur les niveaux de service. |
| backup-retention | 7 | Durée de conservation d’une sauvegarde. Exprimée en jours. |
| geo-redundant-backup | Désactivé | Indique si les sauvegardes géoredondantes doivent être activées ou non pour ce serveur. |
| location | westus2 | Emplacement Azure du serveur. |
| ssl-enforcement | Désactivé | Indique si le protocole TLS/SSL doit être activé ou non pour ce serveur. |
| storage-size | 5120 | Capacité de stockage du serveur (en mégaoctets). |
| version | 10 | La version principale de PostgreSQL. |
| admin-user | Générée par le système | Le nom d’utilisateur pour l’administrateur. |
| admin-password | Générée par le système | Mot de passe de l’utilisateur Administrateur. |
Notes
Pour plus d’informations sur la commande az postgres up et ses paramètres supplémentaires, consultez la documentation Azure CLI.
Une fois que votre serveur est créé, il présente les paramètres suivants :
- Une règle de pare-feu appelée « devbox » est créée. Azure CLI tente de détecter l’adresse IP de la machine à partir de laquelle la commande
az postgres upest exécutée et autorise cette adresse IP. - « Autoriser l’accès aux services Azure » est défini sur ACTIVÉ. Ce paramètre configure le pare-feu du serveur pour qu’il accepte les connexions de toutes les ressources Azure, y compris celles qui ne font pas partie de votre abonnement.
- Une base de données nommée « sampledb » est créée
- Un utilisateur nommé « root » est créé avec des privilèges « sampledb »
Notes
Azure Database pour PostgreSQL communique sur le port 5432. Lorsque vous vous connectez à partir d’un réseau d’entreprise, le trafic sortant sur le port 5432 peut être bloqué par le pare-feu de votre réseau. Pour vous connecter à votre serveur, demandez à votre service informatique d’ouvrir le port 5432.
Obtenir les informations de connexion
Une fois que la commande az postgres up a abouti, une liste de chaînes de connexion pour les langages de programmation les plus courants vous est retournée. Ces chaînes de connexion sont préconfigurées avec les attributs spécifiques de votre nouveau serveur Azure Database pour PostgreSQL.
Vous pouvez utiliser la commande az postgres show-connection-string pour lister à nouveau ces chaînes de connexion.
Nettoyer les ressources
Supprimez toutes les ressources que vous avez créées au cours de ce démarrage rapide à l’aide de la commande ci-dessous. Cette commande supprime le serveur Azure Database pour PostgreSQL et le groupe de ressources.
az postgres down --delete-group
Si vous souhaitez simplement supprimer le serveur nouvellement créé, vous pouvez exécuter la commande az postgres down.
az postgres down