Snabbstart: Använd kommandot az postgres up för att skapa en Azure Database for PostgreSQL – enskild server
GÄLLER FÖR: Azure Database for PostgreSQL – enskild server
Viktigt!
Azure Database for PostgreSQL – enskild server är på väg att dras tillbaka. Vi rekommenderar starkt att du uppgraderar till Azure Database for PostgreSQL – flexibel server. Mer information om hur du migrerar till Azure Database for PostgreSQL – flexibel server finns i Vad händer med Azure Database for PostgreSQL – enskild server?.
Azure Database för PostgreSQL är en hanterad tjänst som låter dig köra, hantera och skala högtillgängliga PostgreSQL-databaser i molnet. Azure CLI används för att skapa och hantera Azure-resurser från kommandoraden eller i skript. Den här snabbstarten visar hur du använder kommandot az postgres up för att skapa en Azure Database for PostgreSQL-server med hjälp av Azure CLI. Förutom att skapa servern az postgres up
skapar kommandot en exempeldatabas, en rotanvändare i databasen, öppnar brandväggen för Azure-tjänster och skapar standardbrandväggsregler för klientdatorn. Dessa standardvärden hjälper till att påskynda utvecklingsprocessen.
Om du inte har en Azure-prenumeration skapar du ett kostnadsfritt Azure-konto innan du börjar.
Skapa en Azure Database for PostgreSQL-server
Förutsättningar
Använd Bash-miljön i Azure Cloud Shell. Mer information finns i Snabbstart för Bash i Azure Cloud Shell.
Om du föredrar att köra CLI-referenskommandon lokalt installerar du Azure CLI. Om du kör i Windows eller macOS kan du köra Azure CLI i en Docker-container. Mer information finns i Så här kör du Azure CLI i en Docker-container.
Om du använder en lokal installation loggar du in på Azure CLI med hjälp av kommandot az login. Slutför autentiseringsprocessen genom att följa stegen som visas i terminalen. Andra inloggningsalternativ finns i Logga in med Azure CLI.
När du uppmanas att installera Azure CLI-tillägget vid första användningen. Mer information om tillägg finns i Använda tillägg med Azure CLI.
Kör az version om du vill hitta versionen och de beroende bibliotek som är installerade. Om du vill uppgradera till den senaste versionen kör du az upgrade.
Starta Azure Cloud Shell
Azure Cloud Shell är ett interaktivt gränssnitt som du kan använda för att utföra stegen i den här artikeln. Den har vanliga Azure-verktyg förinstallerat och har konfigurerats för användning med ditt konto.
Om du vill öppna Cloud Shell väljer du bara Prova från det övre högra hörnet i ett kodblock. Du kan också starta Cloud Shell i en separat webbläsarflik genom att gå till https://shell.azure.com.
När Cloud Shell öppnas kontrollerar du att Bash har valts för din miljö. Efterföljande sessioner använder Azure CLI i en Bash-miljö, Välj Kopiera för att kopiera kodblocken, klistra in dem i Cloud Shell och tryck på Retur för att köra det.
Logga in på Azure
Cloud Shell autentiseras automatiskt under det första kontot som loggas in med. Använd följande skript för att logga in med en annan prenumeration och ersätt <Subscription ID>
med ditt Azure-prenumerations-ID. Om du inte har en Azure-prenumeration skapar du ett kostnadsfritt Azure-konto innan du börjar.
subscription="<subscriptionId>" # add subscription here
az account set -s $subscription # ...or use 'az login'
Mer information finns i ange en aktiv prenumeration eller logga in interaktivt
Installera db-up-tillägget. Om ett fel returneras kontrollerar du att du har installerat den senaste versionen av Azure CLI. Se Installera Azure CLI.
az extension add --name db-up
Skapa en Azure Database for PostgreSQL-server med följande kommando:
az postgres up
Servern skapas med följande standardvärden (om du inte åsidosätter dem manuellt):
Inställning | Standardvärde | Beskrivning |
---|---|---|
server-name | Systemgenererad | Ett unikt namn som identifierar Azure Database för PostgreSQL-servern. |
resource-group | Systemgenererad | En ny Azure-resursgrupp. |
sku-name | GP_Gen5_2 | Namnet på SKU:n. Följer konventionen {pricing tier}_{compute generation}_{vCores} i kort hand. Standardvärdet är en General Purpose Gen5-server med 2 virtuella kärnor. Mer information om nivåerna finns på vår prissida . |
backup-retention | 7 | Hur länge en säkerhetskopia behålls. Enheten är dagar. |
geo-redundant-backup | Inaktiverad | Huruvida geo-redundanta säkerhetskopieringar ska aktiveras för den här servern eller inte. |
plats | westus2 | Azure-platsen för servern. |
ssl-enforcement | Inaktiverad | Om TLS/SSL ska vara aktiverat eller inte för den här servern. |
storage-size | 5120 | Serverns lagringskapacitet (enheten är megabyte). |
version | 10 | Huvudversion för PostgreSQL. |
admin-user | Systemgenererad | Användarnamnet för administratören. |
admin-password | Systemgenererad | Lösenordet för administratörsanvändaren. |
Kommentar
Mer information om az postgres up
kommandot och dess ytterligare parametrar finns i Azure CLI-dokumentationen.
När servern har skapats kommer den med följande inställningar:
- En brandväggsregel med namnet "devbox" skapas. Azure CLI försöker identifiera IP-adressen för den dator
az postgres up
som kommandot körs från och tillåter den IP-adressen. - "Tillåt åtkomst till Azure-tjänster" är inställt på PÅ. Den här inställningen konfigurerar serverns brandvägg för att acceptera anslutningar från alla Azure-resurser, inklusive resurser som inte finns i din prenumeration.
- En tom databas med namnet "sampledb" skapas
- En ny användare med namnet "root" med behörighet att "sampledb" skapas
Kommentar
Azure Database for PostgreSQL kommunicerar via port 5432. När du ansluter innifrån ett företagsnätverk är det möjligt att utgående trafik via port 5432 inte tillåts av nätverkets brandvägg. Låt IT-avdelningen öppna port 5432 för att ansluta till servern.
Hämta anslutningsinformationen
az postgres up
När kommandot har slutförts returneras en lista över anslutningssträng för populära programmeringsspråk till dig. Dessa anslutningssträng är förkonfigurerade med de specifika attributen för din nyligen skapade Azure Database for PostgreSQL-server.
Du kan använda kommandot az postgres show-connection-string för att visa dessa anslutningssträng igen.
Rensa resurser
Rensa alla resurser som du skapade i snabbstarten med hjälp av följande kommando. Det här kommandot tar bort Azure Database for PostgreSQL-servern och resursgruppen.
az postgres down --delete-group
Om du bara vill ta bort den nyligen skapade servern kan du köra kommandot az postgres down .
az postgres down