Skapa ett kluster

För att skapa ett kluster behöver du behörigheten postgrescluster/write i resursgruppen; rollerna Owner, Contributor och Databases Operator har den.

Öppna guiden

Öppna PostgreSQL i sidomenyn i portalen på https://portal.example.com och välj Skapa PostgreSQL-databaser. Guiden Skapa PostgreSQL-databaskluster har sex steg: Grundläggande, Databaskonfiguration, Resurser, Säkerhetskopiering, Övervakning och Granska & skapa. Nästa kontrollerar ett steg innan guiden går vidare, och Skicka på sista steget skapar klustret.

Grundläggande

• PostgreSQL-servernamn — 3 till 50 tecken: gemener, siffror och bindestreck, utan bindestreck först eller sist, och unikt i resursgruppen. Namnet kan inte ändras senare; klustrets adresser inom Kubernetes-klustret bildas av det, till exempel <name>-rw för den primära instansen.
• Boundary, Cluster och Resource group — var klustret körs. Varje fält fylls i åt dig när det bara finns ett val.

Databaskonfiguration

• PostgreSQL-version — huvudversionen: 13, 14, 15 eller 16. Standard är 16.
• Databasnamn — databasen som klustret skapas med: en gemen bokstav först, sedan gemener, siffror och understreck, högst 63 tecken. Det är också namnet på användaren som äger databasen och som anslutningssträngen loggar in som.

Inget av dem kan ändras i portalen efteråt. Versionen kan höjas senare via API:t — se Uppgradera huvudversionen.

Resurser

• Beräkningsplanen — ett kort per plan, med dess CPU, minne och beskrivning. När du väljer en plan fylls antalet instanser och lagringsstorleken nedan i, och varje instans CPU och minne sätts. Planerna finns i Beräkningsplaner och parametrar. När boundaryn begränsar vilka planer som får användas visas de andra men kan inte väljas, med skälet. En plan som ingen nod i klustret skulle kunna köra avvisas när du skickar, med skälet.
• Lagringsstorlek — storleken på varje instans datavolym, i hela GB. Den kan ökas senare, aldrig minskas.

Under Avancerat:

• Antal instanser — 1 till 10. Det börjar på planens antal; med fler än en tar en replik över när den primära går sönder. Ett annat antal än planens gör att klustret inte följer någon plan — Custom — se Justera resurser individuellt.
• Aktivera PgBouncer — kör en PgBouncer-anslutningspooler framför den primära instansen. Den är av om du inte slår på den här, oavsett vilken plan du valde. När den är på anger du PgBouncer-instanser (1 till 5) och Poolningsläge: Session (standard), Transaction eller Statement. Hur program använder poolern beskrivs i Via poolern.

Tips

Bestäm dig för poolning här. När klustret väl följer en plan är reglaget Aktivera PgBouncer i dess konfiguration skrivskyddat i portalen — se Anslutningspoolning.

Varje instans får också en separat volym för transaktionsloggen på alla planer utom nano; dess storlek kommer från planen.

Säkerhetskopiering

• Aktivera säkerhetskopieringar — av som standard. När det är på arkiverar klustret till plattformens säkerhetskopieringslager och tar en schemalagd ögonblicksbild; se Säkerhetskopior och återställning till tidpunkt. Säkerhetskopiering kräver ett säkerhetskopieringsmål som plattformens driftansvariga har satt upp.
• Bevarandepolicy för säkerhetskopior — ett tal och en enhet: d för dagar, w för veckor, m för månader, till exempel 30d (standard), 4w eller 6m. Se Lagringstid för vad som gäller i dag.
• Schema för säkerhetskopiering — Dagligen eller Varje vecka vid en tid på dygnet i UTC, eller ett Eget cron-uttryck med fem fält, i UTC. Standard är dagligen kl. 03.00 UTC.

Övervakning

Aktivera övervakning — på som standard — får operatorn att publicera PostgreSQL:s egna mätvärden för en Prometheus som samlar in dem. Kortet Mätvärden i klustrets Översikt visar instansernas resursanvändning oavsett om det är på eller inte.

Granska & skapa

Granska & skapa visar namn, resursgrupp, version och databas, lagring och resurser, instanserna — märkta Hög tillgänglighet när de är fler än en — poolning, övervakning och säkerhetskopiering. Skicka skapar klustret och går tillbaka till listan.

Klustrets status följer sedan operatorns arbete och visar Running när alla instanser är klara. Klustrets flik Operations visar varje instans som skapas, och varför en instans dröjer — se Ta reda på varför ett kluster inte blir klart.

Med CLI:t

stsh pg create orders-db -g my-resource-group -c my-cluster \
  --set computePlan=small --set databaseName=orders --set backupConfigured=true

-c anger det Kubernetes-kluster som databasen ska placeras på; plattformen avvisar ett skapande utan det. Varje inställning i guiden är ett fält du kan ange med --set; stsh pg create --help listar dem. Kommandot väntar tills skapandet är klart och avslutas med en felkod om det misslyckas.

Ett kluster som skapas med CLI:t eller API:t på planen standard eller större får PgBouncer som standard — i transaktionsläge, med två instanser — om du inte anger pgBouncerEnabled=false. Guiden anger alltid om poolning är på, så den standarden gäller aldrig där.

Via API:t

POST https://api.example.com/boundaries/<boundary-id>/resourcegroups/<resource-group>/resources/postgresclusters/orders-db
Content-Type: application/json

{
  "clusterId": "<cluster-id>",
  "computePlan": "small",
  "postgresVersion": "16",
  "databaseName": "orders",
  "backupConfigured": true,
  "backupSchedule": "0 3 * * *",
  "backupRetentionPolicy": "30d"
}

API:t tar emot versionerna 12 till 17. clusterId krävs. Fälten finns i modulens API-referens.

Nästa steg

• Anslut till ett kluster
• Nätverksåtkomst
• Skapa scheman och tabeller