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 zu den Unterschieden zwischen hochverfügbaren und einfachen Konfigurationen finden Sie unter Knoten und Instanzen.

   Wenn Sie nicht sicher sind, ob für Ihren neuen Cluster Lesepoolinstanzen erforderlich sind, 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 Anfangspasswort für den neuen Cluster ein. AlloyDB weist dem postgres-Datenbanknutzer beim Erstellen des Clusters das angegebene Passwort zu.

7. Wählen Sie im Feld Database version (Datenbankversion) 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 empfehlen wir die Konfiguration mit einer vCPU (in der Vorabversion), die in ausgewählten Regionen verfügbar ist. Weitere Informationen finden Sie unter Hinweise zur Verwendung von 1 vCPU.

9. Wählen Sie einen Netzwerkpfad aus.

10. Optional: Wenn Sie auf diesen Cluster einen bestimmten IP-Adressbereich 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-Adressbereich 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 (CMEK) statt mit 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 Console ist diese Liste auf Schlüssel im Google Cloud gleichen Projekt und in 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 Sie können Ihren Schlüssel nicht finden? 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 einige zusätzliche Schritte. Weitere Informationen finden Sie unter CMEK mit AlloyDB verwenden.

    4. Klicken Sie auf Weiter.

12. Konfigurieren Sie die primäre Instanz:

    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) (Vorabversion)
       • 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-Axion-basierten Maschinenreihe, einschließlich des Maschinentyps mit 1 vCPU, finden Sie unter Hinweise zur Verwendung der C4A-Axion-basierten Maschinenreihe.

    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 Flag für neue Datenbank 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, für die Kompatibilität mit PostgreSQL 14

     • 15, für die Kompatibilität mit PostgreSQL 15, der unterstützten Standard-PostgreSQL-Version

     • 16, für die Kompatibilität mit PostgreSQL 16

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

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

   • --enable-private-service-connect (optional): Wenn Sie diese Option aktivieren, wird Private Service Connect als Verbindungsmethode für den Cluster und seine Instanzen verwendet.

   • REGION_ID: die Region, in der der Cluster platziert werden soll.

   • PROJECT_ID: die ID des Projekts, in dem der Cluster platziert werden soll.

   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 (CMEK) anstelle der standardmäßigen von Google verwalteten Verschlü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üsselrings, 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 \
        --allowed-psc-projects=ALLOWED_PROJECT_LIST

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 Axion-basierte C4A-Maschinenreihe (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-Axion-basierte Maschinenreihe 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-Axion-basierten Maschinenreihe, einschließlich des Maschinentyps mit 1 vCPU, finden Sie unter Hinweise zur Verwendung der C4A-Axion-basierten Maschinenreihe.

  Verwenden Sie für die x86-basierte Maschinenserie N2 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 der Cluster

• ALLOWED_PROJECT_LIST (optional): die durch Kommas getrennte Liste der Projekt-IDs oder Projektnummern, für die der Zugriff auf die Instanz zugelassen werden soll, wenn Private Service Connect verwendet wird.

Terraform

Verwenden Sie zum Erstellen eines Clusters eine Terraform-Ressource.

Im folgenden Code-Snippet wird ein Cluster anhand des Beispiels AlloyDB-Cluster vollständig erstellt:

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

  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 bereiten Sie Cloud Shell vor, um Ihre Terraform-Konfiguration in einem Google Cloud-Projekt anzuwenden:

1. Rufen Sie Cloud Shell auf.

2. Legen Sie das Google Cloud-Standardprojekt 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 sicherzustellen, dass die Terraform-Änderungen 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

In diesem Beispiel wird ein Cluster erstellt. Der Parameter network ist obligatorisch. 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 personenidentifizierbaren 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.

Ersetzen Sie diese Werte in den folgenden Anfragedaten:

• CLUSTER_ID: die ID des von Ihnen erstellten Clusters. Sie muss mit einem Kleinbuchstaben beginnen und darf Kleinbuchstaben, Ziffern und Bindestriche enthalten.
• PROJECT_ID: die ID des Projekts, in dem der Cluster platziert werden soll.

• LOCATION_ID: die ID der Region des Clusters.

• NETWORK: der Name des VPC-Netzwerks, das Sie für den Zugriff auf private Dienste auf AlloyDB konfiguriert haben.

• DATABASE_VERSION: Enum-String der Datenbankversion, z. B. POSTGRES_15.

• INITIAL_USERNAME: Der Nutzername, der für den Standardnutzer von postgres verwendet werden soll.

• INITIAL_USER_PASSWORD: Das Passwort für den Standardnutzer von postgres.

Der JSON-Anfragetext sieht so aus:

{
  clusterId = "CLUSTER_ID"
  network = "projects/PROJECT_ID/global/networks/NETWORK"
  databaseVersion = "DATABASE_VERSION"

  initialUser {
    user     = "INITIAL_USERNAME"
    password = "INITIAL_USER_PASSWORD"
  }

  continuousBackupConfig {
    enabled              = true
    recoveryWindowDays = 14
  }

  weeklySchedule {
    daysOfWeek = ["MONDAY"]

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

    quantityBasedRetention {
      count = 1
    }

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

Speichern Sie den Anfragetext in einer Datei mit dem Namen request.json und verwenden Sie die folgende POST-Anfrage, um sie zu senden:

  POST https://alloydb.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/clusters