Schnellstart: Erstellen einer Instanz von Azure Database for PostgreSQL – Single Server mit dem Befehl „az postgres up preview“
GILT FÜR:
Azure Database for PostgreSQL – Single Server
Wichtig
Azure Database for PostgreSQL – Single Server wird eingestellt. Es wird dringend empfohlen, ein Upgrade auf Azure Database for PostgreSQL – Flexibler Server auszuführen. Weitere Informationen zum Migrieren zu Azure Database for PostgreSQL – Flexibler Server finden Sie unter Was geschieht mit Azure Database for PostgreSQL – Einzelserver?.
Azure-Datenbank für PostgreSQL ist ein verwalteter Dienst, mit dem Sie hochverfügbare PostgreSQL-Datenbanken in der Cloud ausführen, verwalten und skalieren können. Die Azure CLI dient zum Erstellen und Verwalten von Azure-Ressourcen über die Befehlszeile oder mit Skripts. In diesem Schnellstart wird veranschaulicht, wie Sie mithilfe der Azure-Befehlszeilenschnittstelle und des Befehls az postgres up einen Azure Database for PostgreSQL-Server erstellen. Zusätzlich zum Server erstellt der Befehl az postgres up auch eine Beispieldatenbank und einen Root-Benutzer in der Datenbank, er öffnet die Firewall für Azure-Dienste und erstellt Firewallregeln für den Clientcomputer. Diese Standardeinstellungen tragen zur Beschleunigung des Entwicklungsprozesses bei.
Sollten Sie über kein Azure-Abonnement verfügen, können Sie zunächst ein kostenloses Azure-Konto erstellen.
Erstellen einer Azure-Datenbank für PostgreSQL-Server
Voraussetzungen
Verwenden Sie die Bash-Umgebung in Azure Cloud Shell. Weitere Informationen finden Sie unter Schnellstart für Bash in Azure Cloud Shell.
Wenn Sie CLI-Referenzbefehle lieber lokal ausführen, installieren Sie die Azure CLI. Wenn Sie Windows oder macOS ausführen, sollten Sie die Azure CLI in einem Docker-Container ausführen. Weitere Informationen finden Sie unter Ausführen der Azure CLI in einem Docker-Container.
Wenn Sie eine lokale Installation verwenden, melden Sie sich mithilfe des Befehls az login bei der Azure CLI an. Führen Sie die in Ihrem Terminal angezeigten Schritte aus, um den Authentifizierungsprozess abzuschließen. Informationen zu anderen Anmeldeoptionen finden Sie unter Anmelden mit der Azure CLI.
Installieren Sie die Azure CLI-Erweiterung beim ersten Einsatz, wenn Sie dazu aufgefordert werden. Weitere Informationen zu Erweiterungen finden Sie unter Verwenden von Erweiterungen mit der Azure CLI.
Führen Sie az version aus, um die installierte Version und die abhängigen Bibliotheken zu ermitteln. Führen Sie az upgrade aus, um das Upgrade auf die aktuelle Version durchzuführen.
Starten von Azure Cloud Shell
Azure Cloud Shell ist eine kostenlose interaktive Shell, mit der Sie die Schritte in diesem Artikel durchführen können. Sie verfügt über allgemeine vorinstallierte Tools und ist für die Verwendung mit Ihrem Konto konfiguriert.
Wählen Sie zum Öffnen von Cloud Shell oben rechts in einem Codeblock einfach die Option Ausprobieren. Sie können Cloud Shell auch auf einem separaten Browsertab starten, indem Sie zu https://shell.azure.com navigieren.
Überprüfen Sie nach dem Öffnen von Cloud Shell, ob Bash für Ihre Umgebung ausgewählt ist. In den folgenden Sitzungen wird die Azure CLI in einer Bash-Umgebung verwendet. Wählen Sie Kopieren aus, um die Codeblöcke zu kopieren. Fügen Sie sie in Cloud Shell ein, und drücken Sie die EINGABETASTE, um sie auszuführen.
Anmelden bei Azure
Cloud Shell wird automatisch unter dem Konto authentifiziert, mit dem die Anmeldung anfänglich erfolgt ist. Verwenden Sie das folgende Skript, um sich mit einem anderen Abonnement anzumelden, und ersetzen Sie <Subscription ID> durch Ihre Azure-Abonnement-ID. Wenn Sie kein Azure-Abonnement haben, erstellen Sie ein kostenloses Azure-Konto, bevor Sie beginnen.
subscription="<subscriptionId>" # add subscription here
az account set -s $subscription # ...or use 'az login'
Weitere Informationen finden Sie unter Festlegen des aktiven Abonnements oder unter Interaktives Anmelden.
Installieren Sie die db-up-Erweiterung. Falls ein Fehler auftritt, vergewissern Sie sich, dass die neueste Version der Azure-Befehlszeilenschnittstelle installiert ist. Weitere Informationen finden Sie unter Installieren der Azure-Befehlszeilenschnittstelle.
az extension add --name db-up
Erstellen Sie mit dem folgenden Befehl einen Azure Database for PostgreSQL-Server:
az postgres up
Der Server wird mit den folgenden Standardwerten erstellt (sofern Sie diese nicht manuell überschreiben):
| Einstellung | Standardwert | Beschreibung |
|---|---|---|
| Servername | Systemgeneriert | Ein eindeutiger Name, der Ihren Azure-Datenbank für PostgreSQL-Server identifiziert. |
| resource-group | Systemgeneriert | Eine neue Azure-Ressourcengruppe |
| sku-name | GP_Gen5_2 | Der Name der SKU. Folgt der Konvention „{Tarif}_{Computegeneration}_{virtuelle Kerne}“ in Kurzform. Der Standardwert ist ein Gen5-Server vom Typ „Universell“ mit zwei virtuellen Kernen. Informationen zu den Tarifen finden Sie auf der Seite mit der Preisübersicht. |
| backup-retention | 7 | Gibt an, wie lange eine Sicherung aufbewahrt wird. Die Einheit ist Tage. |
| geo-redundant-backup | Disabled | Gibt an, ob georedundante Sicherungen für diesen Server aktiviert werden sollen. |
| location | westus2 | Der Azure-Standort für den Server. |
| ssl-enforcement | Disabled | Gibt an, ob TLS/SSL für diesen Server aktiviert werden soll. |
| storage-size | 5120 | Die Speicherkapazität des Servers (Einheit: MB). |
| version | 10 | Die PostgreSQL-Hauptversion. |
| admin-user | Systemgeneriert | Der Benutzername für den Administrator. |
| admin-password | Systemgeneriert | Das Kennwort des Administratorbenutzers. |
Hinweis
Weitere Informationen zum Befehl az postgres up und den zugehörigen zusätzlichen Parametern finden Sie in der Dokumentation der Azure-Befehlszeilenschnittstelle.
Nach der Erstellung weist Ihr Server die folgenden Einstellungen auf:
- Es wird eine Firewallregel namens „devbox“ erstellt. Die Azure-Befehlszeilenschnittstelle versucht, die IP-Adresse des Computers zu ermitteln, auf dem der Befehl
az postgres upausgeführt wird, und lässt diese IP-Adresse zu. - „Zugriff auf Azure-Dienste zulassen“ ist aktiviert. Mit dieser Einstellung wird die Firewall des Servers so konfiguriert, dass sie Verbindungen von allen Azure-Ressourcen akzeptiert – auch von Ressourcen, die nicht in Ihrem Abonnement enthalten sind.
- Es wird eine leere Datenbank mit der Bezeichnung „sampledb“ erstellt.
- Es wird ein neuer Benutzer mit dem Namen „root“ und Berechtigungen für „sampledb“ erstellt.
Hinweis
Azure Database for PostgreSQL kommuniziert über Port 5432. Wenn Sie eine Verbindung aus einem Unternehmensnetzwerk heraus herstellen, wird der ausgehende Datenverkehr über Port 5432 von der Firewall Ihres Netzwerks unter Umständen nicht zugelassen. Ihre IT-Abteilung muss Port 5432 öffnen, damit Sie eine Verbindung mit Ihrem Server herstellen können.
Abrufen der Verbindungsinformationen
Nach Abschluss des Befehls az postgres up wird eine Liste von Verbindungszeichenfolgen für verbreitete Programmiersprachen an Sie zurückgegeben. Diese Verbindungszeichenfolgen sind mit bestimmten Attributen Ihres neu erstellten Azure Database for PostgreSQL-Servers vorkonfiguriert.
Sie können den Befehl az postgres show-connection-string verwenden, um diese Verbindungszeichenfolgen erneut aufzulisten.
Bereinigen von Ressourcen
Bereinigen Sie alle im Schnellstart erstellten Ressourcen mit dem folgenden Befehl. Dieser Befehl löscht den Azure Database for PostgreSQL-Server und die Ressourcengruppe.
az postgres down --delete-group
Wenn Sie nur den neu erstellten Server löschen möchten, können Sie den Befehl az postgres down ausführen.
az postgres down