Cluster und primäre Instanz erstellen

Console

1. Rufen Sie die Seite Cluster auf.

   Zu den Clustern

2. Klicken Sie auf Cluster erstellen.

3. Wählen Sie eine Clusterkonfiguration aus. Weitere Informationen zum Unterschied zwischen Konfigurationen mit hoher Verfügbarkeit und einfachen Konfigurationen finden Sie unter Knoten und Instanzen.

   Wenn Sie sich nicht sicher sind, ob Ihr neuer Cluster Lesepoolinstanzen benötigt, wählen Sie eine der Konfigurationen ohne Lesepools aus. Sie können dem Cluster später bei Bedarf Lesepoolinstanzen hinzufügen.

4. Klicken Sie auf Weiter.

5. Geben Sie im Abschnitt Cluster konfigurieren im Feld Cluster-ID eine ID für den Cluster ein.

6. Geben Sie im Feld Passwort ein anfängliches Passwort für den neuen Cluster ein. AlloyDB weist das angegebene Passwort dem Datenbanknutzer postgres zu, während der Cluster erstellt wird.

7. Wählen Sie im Feld Database version die Hauptversion von PostgreSQL aus, mit der die Datenbankserver des Clusters kompatibel sein sollen.

8. Wählen Sie eine Region aus. Für Entwicklungs- und Sandbox-Arbeitslasten sollten Sie die Form mit 1 vCPU (in der Vorschau) in Betracht ziehen, die in ausgewählten Regionen verfügbar ist. Weitere Informationen finden Sie unter Überlegungen zur Verwendung von 1 vCPU.

9. Wählen Sie einen Netzwerkpfad aus.

10. Optional: Wenn Sie einen bestimmten IP-Adressbereich auf diesen Cluster anwenden möchten, anstatt AlloyDB einen IP-Adressbereich auswählen zu lassen, gehen Sie so vor:

    1. Klicken Sie auf Option „Zugewiesener IP-Bereich“ einblenden.

    2. Wählen Sie in der Liste Zugewiesener IP-Bereich einen IP-Adressbereich aus.

    Weitere Informationen zu dieser Option finden Sie unter Cluster mit einem bestimmten IP-Adressbereich erstellen.

11. Optional: Wenn Sie diesen Cluster mit einem vom Kunden verwalteten Verschlüsselungsschlüssel (Customer-Managed Encryption Key, CMEK) anstelle der von Google verwalteten Verschlüsselung verschlüsseln möchten, führen Sie die folgenden zusätzlichen Schritte aus:

    1. Klicken Sie auf Erweiterte Verschlüsselungsoptionen.

    2. Wählen Sie Vom Kunden verwalteter Verschlüsselungsschlüssel (CMEK) aus.

    3. Wählen Sie im angezeigten Menü einen vom Kunden verwalteten Schlüssel aus.

       In der Google Cloud -Konsole wird diese Liste auf Schlüssel im selben Google Cloud -Projekt und derselben Region wie der neue Cluster beschränkt. Wenn Sie einen Schlüssel verwenden möchten, der nicht in dieser Liste enthalten ist, klicken Sie auf Ihr Schlüssel wird nicht angezeigt? Geben Sie den Namen der Schlüsselressource ein und geben Sie dann den Ressourcennamen des Schlüssels in das angezeigte Dialogfeld ein.

       Die Verwendung von CMEK mit AlloyDB erfordert eine zusätzliche Einrichtung. Weitere Informationen finden Sie unter CMEK mit AlloyDB verwenden.

    4. Klicken Sie auf Weiter.

12. Primäre Instanz konfigurieren:

    1. Geben Sie im Feld Instanz-ID eine ID für Ihre primäre Instanz ein.

    2. Wählen Sie eine der folgenden Maschinenserien aus:

       • C4A (Google Axion-basierte Maschinenreihe) (Vorschau)
       • N2 (x86-basierte Maschinenreihe) Dies ist die Standardmaschinenreihe.

    3. Wählen Sie einen Maschinentyp aus.

       • C4A unterstützt 1, 4, 8, 16, 32, 48, 64 und 72 Maschinentypen oder ‑formen.
       • N2 unterstützt 2, 4, 8, 16, 32, 64, 96 und 128 Maschinentypen oder ‑formen.

       Weitere Informationen zur Verwendung der C4A-Maschinenserie auf Axion-Basis, einschließlich des Maschinentyps mit 1 vCPU, finden Sie unter Hinweise zur Verwendung der C4A-Maschinenserie auf Axion-Basis.

    4. Optional: Legen Sie benutzerdefinierte Flags für Ihre Instanz fest. Gehen Sie für jede Markierung so vor:

       1. Klicken Sie auf Flag hinzufügen.
       2. Wählen Sie in der Liste Neues Datenbank-Flag ein Flag aus.
       3. Geben Sie einen Wert für das Flag an.
       4. Klicken Sie auf Fertig.

13. Wenn Sie einen Clustertyp ohne Lesepools ausgewählt haben, klicken Sie auf Cluster erstellen.

gcloud

Wenn Sie die gcloud CLI verwenden möchten, können Sie die Google Cloud CLI installieren und initialisieren oder Cloud Shell verwenden.

1. Verwenden Sie den Befehl gcloud alloydb clusters create, um den Cluster mit aktiviertem Zugriff auf private Dienste oder Private Service Connect zu erstellen.

   Zugriff auf private Dienste

   gcloud alloydb clusters create CLUSTER_ID \
       --database-version=POSTGRES_VERSION \
       --password=PASSWORD \
       --region=REGION_ID \
       --project=PROJECT_ID \
       --network=NETWORK

   Private Service Connect

   gcloud alloydb clusters create CLUSTER_ID \
       --database-version=POSTGRES_VERSION \
       --password=PASSWORD \
       --region=REGION_ID \
       --project=PROJECT_ID \
       --enable-private-service-connect 

   Ersetzen Sie Folgendes:

   • CLUSTER_ID: die ID des Clusters, den Sie erstellen. Sie muss mit einem Kleinbuchstaben beginnen und darf Kleinbuchstaben, Ziffern und Bindestriche enthalten.

   • VERSION: die Hauptversion von PostgreSQL, mit der die Datenbankserver des Clusters kompatibel sein sollen. Wählen Sie eine der folgenden Optionen aus:

     • 14, zur Kompatibilität mit PostgreSQL 14

     • 15, zur Kompatibilität mit PostgreSQL 15

     • 16, um die Kompatibilität mit PostgreSQL 16 zu gewährleisten. Dies ist die standardmäßige PostgreSQL-Version, die von AlloyDB unterstützt wird.

     • 17 für die Kompatibilität mit PostgreSQL 17 (Vorschau)

       Weitere Informationen zu den Einschränkungen, die für die Verwendung von PostgreSQL 17 in der Vorabversion gelten, finden Sie unter Vorabversion: Kompatibilität mit PostgreSQL 17.

   • PASSWORD: das Passwort für den Standardnutzer postgres.

   • NETWORK (optional): der Name des VPC-Netzwerk, das Sie für den Zugriff auf private Dienste für AlloyDB konfiguriert haben. Wenn Sie das Flag --network weglassen, verwendet AlloyDB das Netzwerk default.

   Bei einem freigegebene VPC-Netzwerk muss der vollständig qualifizierte Pfad des VPC-Netzwerks angegeben werden, z. B. projects/cymbal-project/global/networks/shared-vpc-network.

   • --enable-private-service-connect (Optional): Legen Sie diesen Wert fest, um Private Service Connect als Verbindungsmethode für den Cluster und seine Instanzen zu aktivieren.

   • REGION_ID: Die Region, in der sich der Cluster befinden soll.

   • PROJECT_ID: die ID des Projekts, in dem Sie den Cluster platzieren möchten.

   Dieser Befehl initiiert einen Vorgang mit langer Ausführungszeit und gibt eine Vorgangs-ID zurück.

2. Optional: Wenn Sie einen bestimmten IP-Adressbereich auf diesen Cluster anwenden möchten, anstatt AlloyDB einen IP-Adressbereich auswählen zu lassen, geben Sie das folgende Argument an:

   --allocated-ip-range-name=RANGE
   

   Ersetzen Sie RANGE durch den Namen des IP-Adressbereichs, den dieser Cluster für den Zugriff auf private Dienste verwenden soll.

   Weitere Informationen zu dieser Option finden Sie unter Cluster mit einem bestimmten IP-Adressbereich erstellen.

3. Optional: Wenn Sie diesen Cluster mit einem vom Kunden verwalteten Verschlüsselungsschlüssel (Customer-Managed Encryption Key, CMEK) anstelle der von Google verwalteten Standardverschlüsselung verschlüsseln möchten, geben Sie die folgenden Argumente an:

   --kms-key=KEY_ID \
   --kms-keyring=KEYRING_ID \
   --kms-location=LOCATION_ID \
   --kms-project=PROJECT_ID
   

   Ersetzen Sie Folgendes:

   • KEY_ID: Die ID des zu verwendenden CMEK-Schlüssels.

   • KEYRING_ID: die ID des Schlüsselbunds des Schlüssels.

   • LOCATION_ID: Die ID der Region des Schlüsselbunds, die mit der Region des Clusters übereinstimmen muss.

   • PROJECT_ID: Die ID des Projekts des Schlüsselbunds.

4. Prüfen Sie, ob der Vorgang erfolgreich war.

   gcloud alloydb operations describe OPERATION_ID \
       --region=REGION_ID \
       --project=PROJECT_ID

   Ersetzen Sie OPERATION_ID durch die Vorgangs-ID, die im vorherigen Schritt zurückgegeben wurde.

Nachdem Sie den primären Cluster erstellt haben, müssen Sie eine primäre Instanz erstellen.

Primäre Instanz erstellen

Verwenden Sie den Befehl gcloud alloydb instances create, um eine primäre Instanz zu erstellen.

    gcloud alloydb instances create INSTANCE_ID \
        --instance-type=PRIMARY \
        --cpu-count=CPU_COUNT \
        --machine-type=MACHINE_TYPE \
        --region=REGION_ID \
        --cluster=CLUSTER_ID \
        --project=PROJECT_ID \

Ersetzen Sie Folgendes:

• INSTANCE_ID: die ID der Instanz, die Sie erstellen. Sie muss mit einem Kleinbuchstaben beginnen und darf Kleinbuchstaben, Ziffern und Bindestriche enthalten.

• CPU_COUNT: Die Anzahl der N2-vCPUs, die Sie für die Instanz benötigen. N2 ist der Standardwert. Gültige Werte sind:

  • 2: 2 vCPUs, 16 GB RAM
  • 4: 4 vCPUs, 32 GB RAM
  • 8: 8 vCPUs, 64 GB RAM
  • 16: 16 vCPUs, 128 GB RAM
  • 32: 32 vCPUs, 256 GB RAM
  • 64: 64 vCPUs, 512 GB RAM
  • 96: 96 vCPUs, 768 GB RAM
  • 128: 128 vCPUs, 864 GB RAM

• MACHINE_TYPE: Dieser Parameter ist optional, wenn Sie N2-Maschinen bereitstellen. Wenn Sie die C4A-Maschinenserie auf Axion-Basis (Vorabversion) bereitstellen oder zwischen C4A- und N2-Maschinen migrieren möchten, wählen Sie diesen Parameter mit den folgenden Werten aus.

  Wenn Sie MACHINE_TYPE und CPU_COUNT zusammen verwenden, müssen die Werte in CPU_COUNT und MACHINE_TYPE übereinstimmen. Andernfalls wird ein Fehler ausgegeben.

  Wählen Sie für die C4A-Maschinenserie auf Axion-Basis den Maschinentyp mit den folgenden Werten aus:

  • c4a-highmem-1
  • c4a-highmem-4-lssd
  • c4a-highmem-8-lssd
  • c4a-highmem-16-lssd
  • c4a-highmem-32-lssd
  • c4a-highmem-48-lssd
  • c4a-highmem-64-lssd
  • c4a-highmem-72-lssd

  Wenn Sie C4A mit 4 vCPUs oder mehr bereitstellen möchten, verwenden Sie das Suffix lssd, um den ultraschnellen Cache zu aktivieren.

  Weitere Informationen zur Verwendung der C4A-Maschinenserie auf Axion-Basis, einschließlich des Maschinentyps mit 1 vCPU, finden Sie unter Hinweise zur Verwendung der C4A-Maschinenserie auf Axion-Basis.

  Verwenden Sie für die N2-Maschinenserie auf x86-Basis den Maschinentyp mit den folgenden Werten:

  • N2-highmem-2
  • N2-highmem-4
  • N2-highmem-8
  • N2-highmem-16
  • N2-highmem-32
  • N2-highmem-64
  • N2-highmem-96
  • N2-highmem-128

• REGION_ID: Die Region, in der sich die Instanz befinden soll.

• CLUSTER_ID: Die ID des Clusters, den Sie zuvor erstellt haben.

• PROJECT_ID: die ID des Projekts, in dem Ihr Cluster erstellt wurde.

Optional: Wenn Sie einen bestimmten IP-Adressbereich auf diese Instanz anwenden und alle auf Clusterebene konfigurierten Zuweisungen von IP-Adressbereichen überschreiben möchten, geben Sie das folgende Argument an:

    --allocated-ip-range-override=OVERRIDE_RANGE_NAME

Ersetzen Sie OVERRIDE_RANGE_NAME durch den Namen des IP-Adressbereichs, den diese Instanz für den Zugriff auf private Dienste verwenden soll, z. B. google-managed-services-default. Der Bereichsname muss RFC 1035 entsprechen. Der Name muss zwischen 1 und 63 Zeichen lang sein und dem regulären Ausdruck [a-z]([-a-z0-9]*[a-z0-9])? entsprechen.

Weitere Informationen zu dieser Option finden Sie unter Instanz mit einem bestimmten IP-Adressbereich erstellen.

Sie können auch eine AlloyDB-Instanz mit aktiviertem Private Service Connect erstellen. Informationen zum Erstellen einer primären Instanz für einen Cluster mit aktiviertem Private Service Connect finden Sie unter AlloyDB-Instanz erstellen.

Terraform

Verwenden Sie zum Erstellen eines Clusters eine Terraform-Ressource.

Das folgende Code-Snippet zeigt, wie ein Cluster auf Grundlage des Beispiels AlloyDB-Cluster (vollständig) erstellt wird:

resource "google_alloydb_cluster" "cluster_abc" {
  cluster_id = "alloydb-cluster"
  location   = "us-central1"
  network_config {
    network = google_compute_network.default.id
  }
  database_version = "POSTGRES_16"

  initial_user {
    user     = "postgres"
    password = "postgres"
  }

  continuous_backup_config {
    enabled              = true
    recovery_window_days = 14
  }

  automated_backup_policy {
    location      = "us-central1"
    backup_window = "1800s"
    enabled       = true

    weekly_schedule {
      days_of_week = ["MONDAY"]

      start_times {
        hours   = 23
        minutes = 0
        seconds = 0
        nanos   = 0
      }
    }

    quantity_based_retention {
      count = 1
    }

    labels = {
      test = "alloydb-cluster-backup-policy-labels"
    }
  }

  labels = {
    test = "alloydb-cluster-labels"
  }
}

data "google_project" "project" {}

resource "google_compute_network" "default" {
  name = "alloydb-cluster-network"
}

Cloud Shell vorbereiten

So wenden Sie Ihre Terraform-Konfiguration in einem Google Cloud -Cloud Shell an:

1. Rufen Sie Cloud Shell auf.

2. Legen Sie das Standardprojekt Google Cloud fest, auf das Sie Ihre Terraform-Konfigurationen anwenden möchten.

   Sie müssen diesen Befehl nur einmal pro Projekt und in jedem beliebigen Verzeichnis ausführen.

   export GOOGLE_CLOUD_PROJECT=PROJECT_ID

   Umgebungsvariablen werden überschrieben, wenn Sie in der Terraform-Konfigurationsdatei explizite Werte festlegen.

Verzeichnis vorbereiten

Jede Terraform-Konfigurationsdatei muss ein eigenes Verzeichnis haben, auch als Stammmodul bezeichnet.

1. Erstellen Sie in Cloud Shell ein Verzeichnis und eine neue Datei in diesem Verzeichnis. Der Dateiname muss eine TF-Datei sein, z. B. main.tf. In diesem Dokument wird die Datei als main.tf bezeichnet.

   mkdir DIRECTORY && cd DIRECTORY && touch main.tf

2. Kopieren Sie den Beispielcode in das neu erstellte main.tf. Kopieren Sie optional den Code aus GitHub. Dies wird empfohlen, wenn das Terraform-Snippet Teil einer End-to-End-Lösung ist.
3. Prüfen Sie die Datei main.tf und ändern Sie die Beispielparameter, die auf Ihre Umgebung angewendet werden sollen.
4. Speichern Sie die Änderungen.
5. Initialisieren Sie Terraform. Dies ist nur einmal für jedes Verzeichnis erforderlich.

   terraform init

   Optional: Wenn Sie die neueste Google-Anbieterversion verwenden möchten, fügen Sie die Option -upgrade ein:

   terraform init -upgrade

Änderungen anwenden

1. Prüfen Sie die Konfiguration, um zu bestätigen, dass die Terraform-Aktualisierungen Ihren Erwartungen entsprechen:

   terraform plan

   Korrigieren Sie die Konfiguration nach Bedarf.
2. Wenden Sie die Terraform-Konfiguration an. Führen Sie dazu den folgenden Befehl aus und geben Sie yes an der Eingabeaufforderung ein:

   terraform apply

   Warten Sie, bis Terraform die Meldung Apply complete! anzeigt.
3. Öffnen Sie Ihr Google Cloud Projekt, um die Ergebnisse aufzurufen. Rufen Sie in der Google Cloud Console Ihre Ressourcen in der Benutzeroberfläche auf, um sicherzustellen, dass Terraform sie erstellt oder aktualisiert hat.

REST Version 1

Cluster erstellen

In diesem Beispiel wird ein Cluster erstellt. Eine vollständige Liste der Parameter für diesen Aufruf finden Sie unter Methode: projects.locations.clusters.create. Informationen zu Clustereinstellungen finden Sie unter Cluster- und Instanzeinstellungen aufrufen.

Die Cluster-ID sollte keine vertraulichen oder personenbezogenen Informationen enthalten, da sie extern sichtbar ist. Die Projekt-ID muss im Clusternamen nicht angegeben werden. Dies erfolgt automatisch, wo es erforderlich ist, beispielsweise in den Logdateien.

Speichern Sie den Anfragetext in einer Datei mit dem Namen cluster_request.json, um die Anfrage zu senden:

{
  "databaseVersion": "DATABASE_VERSION",
  "initialUser": {
    "user": "INITIAL_USERNAME",
    "password": "INITIAL_USER_PASSWORD"
  },
  "labels": {
    "test": "alloydb-cluster-full"
  }
}

Ersetzen Sie die folgenden Werte:

• DATABASE_VERSION: Enum-String der Datenbankversion, z. B. POSTGRES_16.
• INITIAL_USERNAME: Der Nutzername, den Sie für den Standard-Postgres-Nutzer verwenden.
• INITIAL_USER_PASSWORD: Das Passwort, das Sie für den Standard-Postgres-Nutzer verwenden.

Verwenden Sie die folgende HTTP-Methode und URL:

POST https://alloydb.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/clusters?cluster_id=CLUSTER_ID

Ersetzen Sie die folgenden Werte:

• PROJECT_ID: die ID des Projekts, in dem sich der Cluster befinden soll.
• LOCATION_ID: Die ID der Region des Clusters.
• CLUSTER_ID: die ID des Clusters, den Sie erstellen. Die Cluster-ID muss mit einem Kleinbuchstaben beginnen und darf Kleinbuchstaben, Ziffern und Bindestriche enthalten.

Sie können die vorherige Anfrage mit dem folgenden curl-Befehl ausführen:

curl -X POST   -H "Authorization: Bearer $(gcloud auth print-access-token)"   -H "Content-Type: application/json"   https://alloydb.googleapis.com/v1alpha/projects/PROJECT_ID/locations/LOCATION_ID/clusters?cluster_id=CLUSTER_ID   -d @cluster_request.json

Primäre Instanz erstellen

In diesem Beispiel wird eine primäre Instanz erstellt. Eine vollständige Liste der Parameter für diesen Aufruf finden Sie unter Methode: projects.locations.clusters.instances.create. Informationen zu Clustereinstellungen finden Sie unter Cluster- und Instanzeinstellungen aufrufen.

Die Cluster-ID sollte keine vertraulichen oder personenbezogenen Informationen enthalten, da sie extern sichtbar ist. Die Projekt-ID muss im Clusternamen nicht angegeben werden, da dies an gegebener Stelle automatisch erfolgt, z. B. in den Logdateien.

Speichern Sie zum Senden der Anfrage den folgenden Anfragetext in einer Datei mit dem Namen instance_request.json.

{
  "instance_type": "PRIMARY",
  "machine_config": {
    "cpu_count": "vCPU_COUNT"
  }
}

Ersetzen Sie Folgendes:

• VCPU_COUNT: die Anzahl der sichtbaren CPU-Kerne in der Instanz, die Sie erstellen möchten.

Im vorherigen Beispiel wird eine N2-Instanz mit den folgenden Spezifikationen erstellt:

• 2: 2 vCPUs, 16 GB RAM
• 4: 4 vCPUs, 32 GB RAM
• 8: 8 vCPUs, 64 GB RAM
• 16: 16 vCPUs, 128 GB RAM
• 32: 32 vCPUs, 256 GB RAM
• 64: 64 vCPUs, 512 GB RAM
• 96: 96 vCPUs, 768 GB RAM
• 128: 128 vCPUs, 864 GB RAM

Verwenden Sie zum Erstellen einer C4A-Instanz das Feld machine_type anstelle von cpu_count in der machine_config-Struktur, wie im folgenden Beispiel gezeigt:

machine_config: {
  machine_type : MACHINE_TYPE,
},

Verwenden Sie für die C4A-Maschinenserie auf Axion-Basis die folgenden gültigen Werte:

• c4a-highmem-1
• c4a-highmem-4-lssd
• c4a-highmem-8-lssd
• c4a-highmem-16-lssd
• c4a-highmem-32-lssd
• c4a-highmem-48-lssd
• c4a-highmem-64-lssd
• c4a-highmem-72-lssd

Für die N2-Maschinenserie sind die folgenden Werte zulässig:

• n2-highmem-2
• n2-highmem-4
• n2-highmem-8
• n2-highmem-16
• n2-highmem-32
• n2-highmem-64
• n2-highmem-96
• n2-highmem-128

Verwenden Sie die folgende HTTP-Methode und URL:

POST https://alloydb.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/clusters/CLUSTER_ID/instances?instance_id=INSTANCE_ID

Ersetzen Sie die folgenden Werte:

• PROJECT_ID: die ID des Projekts, in dem sich der Cluster befinden soll.
• LOCATION_ID: Die ID der Region des Clusters.
• CLUSTER_ID: die ID des Clusters, den Sie erstellen. Die ID muss mit einem Kleinbuchstaben beginnen und darf Kleinbuchstaben, Ziffern und Bindestriche enthalten.
• INSTANCE_ID: Der Name der primären Instanz, die Sie erstellen möchten.

Sie können die Anfrage mit curl ausführen, wie im folgenden Beispiel gezeigt:

curl -X POST   -H "Authorization: Bearer $(gcloud auth print-access-token)"   -H "Content-Type: application/json"   https://alloydb.googleapis.com/v1alpha/projects/PROJECT_ID/locations/LOCATION_ID/clusters/CLUSTER_ID/instances?instance_id=INSTANCE_ID   -d @instance_request.json