Snabbstart: Använd ett Azure CLI-kommando, az postgres up (förhandsversion) för att skapa en Azure Database for PostgreSQL – enskild server
Viktigt
Azure CLI-kommandot az postgres up är en förhandsversion.
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 skapar kommandot en exempeldatabas, en rotanvändare i databasen, öppnar brandväggen för Azure-tjänster och skapar brandväggsregler för az postgres up klientdatorn. Dessa standardvärden hjälper till att påskynda utvecklingsprocessen.
Förutsättningar
Om du inte har en Azure-prenumeration kan du skapa ett kostnadsfritt konto innan du börjar.
Den här artikeln kräver att du kör Azure CLI version 2.0 eller senare lokalt. Kör kommandot az --version om du vill se vilken version som är installerad. Om du behöver installera eller uppgradera kan du läsa Installera Azure CLI.
Du måste logga in på ditt konto med kommandot az login. Observera ID-egenskapen från kommandoutdata för motsvarande prenumerationsnamn.
az login
Om du har flera prenumerationer ska du välja lämplig prenumeration där resursen ska debiteras. Välj det specifika prenumerations-ID:t under ditt konto med hjälp av kommandot az account set. Ersätt egenskapen prenumerations-ID från az login output för din prenumeration i platshållaren för prenumerations-ID.
az account set --subscription <subscription id>
Skapa en Azure Database for PostgreSQL-server
Om du vill använda kommandona installerar du tillägget db-up. Om ett fel returneras ser du till 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ärdet | 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 {prisnivå}_{beräkningsgenerering}_{vCores} i snabbformat. Standardvärdet är en Generell användning Gen5-server med 2 virtuella kärnor. Mer information om nivåerna finns på vår prissättningssida. |
| backup-retention | 7 | Hur länge en säkerhetskopia bevaras. Enheten är dagar. |
| geo-redundant-backup | Inaktiverad | Huruvida geo-redundanta säkerhetskopieringar ska aktiveras för den här servern eller inte. |
| location | USA, västra 2 | 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 | Administratörens användarnamn. |
| admin-password | Systemgenererad | Lösenordet för administratörsanvändaren. |
Anteckning
Mer information om kommandot az postgres up och dess ytterligare parametrar finns i Azure CLI-dokumentationen.
När servern har skapats levereras den med följande inställningar:
- En brandväggsregel som kallas "devbox" skapas. Azure CLI försöker identifiera IP-adressen för den dator som kommandot
az postgres upkö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 så att den accepterar anslutningar från alla Azure-resurser, inklusive resurser som inte ingår i din prenumeration.
- En tom databas med namnet "sampledb" skapas
- En ny användare med namnet "root" med behörigheten "sampledb" skapas
Anteckning
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. Be IT-avdelningen öppna port 5432 för att ansluta till servern.
Hämta anslutningsinformationen
När kommandot az postgres up har slutförts returneras en lista över anslutningssträngar för populära programmeringsspråk till dig. Dessa anslutningssträngar är förkonfigurerade med de specifika attributen för den nya Azure Database for PostgreSQL servern.
Du kan använda kommandot az postgres show-connection-string för att lista dessa anslutningssträngar igen.
Rensa resurser
Rensa alla resurser som du skapade i snabbstarten med hjälp av följande kommando. Det här kommandot tar 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