Google verwendet KI-Technologie, um Inhalte in Ihre bevorzugte Sprache zu übersetzen. KI-Übersetzungen können Fehler enthalten.

Cluster und primäre Instanz erstellen

Wenn Sie eine Datenbankumgebung für Ihre Anwendungen in AlloyDB for PostgreSQL bereitstellen möchten, erstellen Sie einen Cluster und die zugehörige primäre Instanz. Der Cluster verwaltet Ihre regionalen Speicher- und Konfigurationseinstellungen, während die primäre Instanz die Rechenressourcen für Lese- und Schreibvorgänge bereitstellt. Sie können einen Cluster und seine primäre Instanz mit der Google Cloud Console, der Google Cloud CLI, der REST API oder Terraform erstellen.

Hinweis

Das Projekt von Google Cloud , das Sie verwenden, muss für den Zugriff auf AlloyDB aktiviert sein.
Ein VPC-Netzwerk (Virtual Private Cloud) im von Ihnen verwendeten Google Cloud -Projekt muss bereits für den Zugriff auf private Dienste auf AlloyDB konfiguriert sein.
Berücksichtigen Sie bei Entwicklungs- und Sandbox-Arbeitslasten Ihre Region und Ihren Maschinentyp. Wenn Sie die Form mit 1 vCPU verwenden möchten, müssen Sie eine Region auswählen, die diese Form unterstützt. Weitere Informationen finden Sie unter Überlegungen zur Verwendung von 1 vCPU.

Erforderliche Rollen

Bevor Sie Ihren ersten AlloyDB-Cluster erstellen können, müssen Sie die richtigen IAM-Rollen (Identity and Access Management) haben.

Sie benötigen eine der folgenden IAM-Rollen im Projekt von Google Cloud , das Sie verwenden:
- roles/alloydb.admin (die vordefinierte IAM-Rolle „AlloyDB Admin“)
- roles/owner (einfache IAM-Rolle „Inhaber“)
- roles/editor (einfache IAM-Rolle „Bearbeiter“)
Wenn Sie keine dieser Rollen haben, wenden Sie sich an den Organization Administrator, um Zugriff anzufordern.
Außerdem benötigen Sie die Berechtigung compute.networks.list für das Projekt Google Cloud , das Sie verwenden. Berechtigungen nach dem Prinzip der geringsten Berechtigung erhalten Sie, wenn der Administrator Ihnen die Rolle „Compute-Netzwerknutzer“ (roles/compute.networkUser) zuweist.

Neuen Cluster und neue primäre Instanz erstellen

Console

Zur Clusterseite.

Zu den Clustern
Klicken Sie auf Cluster erstellen.
Wählen Sie eine Clusterkonfiguration aus. Weitere Informationen zum Unterschied zwischen hochverfügbaren und einfachen Konfigurationen finden Sie unter Was ist eine AlloyDB-Instanz?.

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.
Klicken Sie auf Weiter.
Geben Sie im Bereich Cluster konfigurieren im Feld Cluster-ID eine ID für den Cluster ein.
Geben Sie im Feld Passwort ein erstes Passwort für den neuen Cluster ein. AlloyDB weist dem Datenbanknutzer postgres beim Erstellen des Clusters das angegebene Passwort zu.
Optional: Wenn Sie das Flag alloydb.iam_authentication manuell festlegen möchten, heben Sie die Auswahl von IAM-Datenbanknutzer erstellen auf. Weitere Informationen finden Sie unter Datenbank-Flags konfigurieren.

Standardmäßig ist IAM-Datenbanknutzer erstellen ausgewählt. Dadurch wird Folgendes ausgeführt:
- Aktiviert das Flag alloydb.iam_authentication auf der primären Instanz.
- Erstellt einen IAM-Datenbanknutzer für Sie.
Wählen Sie im Feld Datenbankversion die Hauptversion von PostgreSQL für Ihren neuen AlloyDB-Cluster aus.
Wählen Sie eine Region aus. Für Entwicklungs- und Sandbox-Arbeitslasten sollten Sie die 1-vCPU-Form in Betracht ziehen, die in ausgewählten Regionen verfügbar ist. Weitere Informationen finden Sie unter Überlegungen zur Verwendung von 1 vCPU.
Wählen Sie einen Netzwerkpfad aus.
Optional: Wenn Sie einen bestimmten IP-Adressbereich auf diesen Cluster anwenden möchten, anstatt AlloyDB die Auswahl eines IP-Adressbereichs zu überlassen, 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.
Optional: Wenn Sie diesen Cluster mit einem vom Kunden verwalteten Verschlüsselungsschlüssel (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 kundenverwalteter 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 selben Google Cloud -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.
  
  Beachten Sie, dass für die Verwendung von CMEK mit AlloyDB zusätzliche Einrichtungsschritte erforderlich sind. Weitere Informationen finden Sie unter CMEK mit AlloyDB verwenden.
4. Klicken Sie auf Weiter.
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 Maschinenreihen aus:
  - C4A (Google Axion-basierte Maschinenreihe).
  - N2 (x86-basierte Maschinenreihe) Dies ist die Standard-Maschinenreihe.
  - C4 (x86-basierte Maschinenreihe)
  - Z3 (Intel Xeon-basierte Maschinenreihe)
3. Wählen Sie einen Maschinentyp aus. Weitere Informationen finden Sie unter Maschinentyp auswählen.
  - C4A unterstützt 1, 2, 4, 8, 16, 32, 48, 64 und 72 vCPUs.
  - N2 unterstützt 2, 4, 8, 16, 32, 64, 96 und 128 vCPUs.
  - C4 unterstützt 4, 8, 16, 24, 32, 48, 96, 144, 192 und 288 vCPUs.
  - Z3 unterstützt 8, 14, 16, 22, 32, 44 und 88 vCPUs.
  Weitere Informationen zur Verwendung von C4A-Axion-basierten Maschinenserien, einschließlich des Maschinentyps mit 1 vCPU, finden Sie unter Überlegungen bei der Verwendung von C4A-Axion-basierten Maschinenserien.
4. Optional: Legen Sie benutzerdefinierte Flags für Ihre Instanz fest. Gehen Sie für jedes Flag 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.
Klicken Sie auf Cluster erstellen.

Hinweis: Nachdem Sie den Cluster erstellt haben, können Sie den Cluster- und Instanzzustand anhand priorisierter Zustandsprobleme in der Google Cloud Console überwachen. Weitere Informationen finden Sie unter Zustand von AlloyDB-Clustern und -Instanzen überwachen.

gcloud

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

Sie müssen sowohl einen AlloyDB-Cluster als auch eine primäre Instanz erstellen, bevor Sie AlloyDB verwenden können.

Cluster erstellen

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
  - 16, für die Kompatibilität mit PostgreSQL 16
  - 17, für die Kompatibilität mit PostgreSQL 17, der standardmäßig unterstützten PostgreSQL-Version
  - 18, für die Kompatibilität mit PostgreSQL 18
- PASSWORD: das Passwort für den Standardnutzer postgres.
- NETWORK (optional): der Name des VPC-Netzwerk, das Sie für den Zugriff auf private Dienste auf AlloyDB konfiguriert haben. Wenn Sie das Flag --network weglassen, verwendet AlloyDB das Netzwerk default.
  
  Wenn Sie ein freigegebene VPC-Netzwerk verwenden, legen Sie den vollständig qualifizierten Pfad des VPC-Netzwerks fest, z. B. projects/cymbal-project/global/networks/shared-vpc-network.
- --enable-private-service-connect (optional): Legen Sie diese Option 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.
Hinweis: Für Entwicklungs- und Sandbox-Arbeitslasten sollten Sie die Form mit 1 vCPU in Betracht ziehen, die in ausgewählten Regionen verfügbar ist. Weitere Informationen finden Sie unter Überlegungen bei der Verwendung von 1 vCPU.
- 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.
Optional: Wenn Sie einen bestimmten IP-Adressbereich auf diesen Cluster anwenden möchten, anstatt AlloyDB die Auswahl eines IP-Adressbereichs zu überlassen, 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.
Optional: Wenn Sie diesen Cluster mit einem kundenverwalteten 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üsselbunds, die mit der Region des Clusters übereinstimmen muss.
- PROJECT_ID: die ID des Projekts des Schlüsselbunds.
Hinweis: Für die Verwendung von CMEK ist eine zusätzliche Einrichtung erforderlich. Weitere Informationen finden Sie unter CMEK mit AlloyDB verwenden.
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 \
        --region=REGION_ID \
        --cluster=CLUSTER_ID \
        --project=PROJECT_ID \
        --cpu-count=CPU_COUNT \
        --machine-type=MACHINE_TYPE \
        --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.
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 erstellt wurde.
CPU_COUNT: die Anzahl der vCPUs, die Sie für die Instanz benötigen.
- Sie müssen entweder cpu_count oder machine_type angeben.
- Wenn nur cpu_count angegeben ist, 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
- Wenn sowohl machine_type als auch cpu_count angegeben sind, muss der Wert für cpu_count mit der Anzahl der vCPUs übereinstimmen, die in machine_type angegeben ist. Wenn machine_type beispielsweise n2-highmem-4 ist, müssen Sie cpu_count auf 4 setzen.
MACHINE_TYPE: Wählen Sie einen der unterstützten Maschinentypen aus, z. B. n2-highmem-4, c4-highmem-4-lssd oder c4a-highmem-4-lssd. Weitere Informationen finden Sie unter AlloyDB-Maschinentyp auswählen.

Wenn Sie machine_type und cpu_count zusammen verwenden, müssen die Werte in cpu_count und machine_type übereinstimmen. Wenn machine_type beispielsweise n2-highmem-4 ist, müssen Sie cpu_count auf 4 setzen.
ALLOWED_PROJECT_LIST: (Optional) Wenn Sie Private Service Connect verwenden, ist ALLOWED_PROJECT_LIST die durch Kommas getrennte Liste der Projekt-IDs oder die Projektnummer, für die Sie den Zugriff auf die Instanz zulassen möchten.

Terraform

Cluster und primäre Instanz erstellen

Verwenden Sie zum Erstellen eines Clusters und seiner primären Instanz eine Terraform-Ressource.

Im Folgenden finden Sie ein Code-Snippet zum Erstellen eines Clusters und einer primären Instanz basierend auf dem Beispiel AlloyDB-Instanz vollständig:

resource "google_alloydb_instance" "default" {
  cluster       = google_alloydb_cluster.default.name
  instance_id   = "alloydb-instance"
  instance_type = "PRIMARY"
  machine_config {
    cpu_count = 2
  }
  depends_on = [google_service_networking_connection.vpc_connection]
}

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

data "google_project" "project" {}

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

resource "google_compute_global_address" "private_ip_alloc" {
  name          = "alloydb-cluster"
  address_type  = "INTERNAL"
  purpose       = "VPC_PEERING"
  prefix_length = 16
  network       = google_compute_network.default.id
}

resource "google_service_networking_connection" "vpc_connection" {
  network                 = google_compute_network.default.id
  service                 = "servicenetworking.googleapis.com"
  reserved_peering_ranges = [google_compute_global_address.private_ip_alloc.name]
}

In diesem Beispiel wird eine N2-Instanz erstellt. Eine Liste anderer unterstützter Maschinentypen wie n2-highmem-4, c4-highmem-4-lssd oder c4a-highmem-4-lssd finden Sie unter AlloyDB-Maschinentyp auswählen.

Cloud Shell vorbereiten

So wenden Sie Ihre Terraform-Konfiguration in einem Google Cloud -Projekt an und bereiten Cloud Shell vor:

Rufen Sie Cloud Shell auf.
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).

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
```
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.
Prüfen Sie die Datei main.tf und ändern Sie die Beispielparameter, die auf Ihre Umgebung angewendet werden sollen.
Speichern Sie die Änderungen.
Initialisieren Sie Terraform. Dies ist nur einmal für jedes Verzeichnis erforderlich.
```
terraform init
```
Optional: Fügen Sie die Option -upgrade ein, um die neueste Google-Anbieterversion zu verwenden:
```
terraform init -upgrade
```

Änderungen anwenden

Prüfen Sie die Konfiguration, um sicherzustellen, dass die Terraform-Updates Ihren Erwartungen entsprechen:
```
terraform plan
```
Korrigieren Sie die Konfiguration nach Bedarf.
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.
Ö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 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.

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

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

Ersetzen Sie die folgenden Werte:

DATABASE_VERSION: Enum-String der Datenbankversion, z. B. POSTGRES_17.
INITIAL_USERNAME: Der Nutzername, den Sie für den Postgres-Standardnutzer 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 den folgenden curl-Befehl verwenden, um die vorherige Anfrage auszuführen:

curl -X POST   -H "Authorization: Bearer $(gcloud auth print-access-token)"   -H "Content-Type: application/json"   https://alloydb.googleapis.com/v1/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 personenidentifizierbaren 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 den folgenden Anfragetext in einer Datei mit dem Namen instance_request.json, um Ihre Anfrage zu senden.

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

Ersetzen Sie Folgendes:

VCPU_COUNT: die Anzahl der sichtbaren CPU-Kerne auf 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

Im folgenden Beispiel wird gezeigt, wie Sie eine Instanz für einen Maschinentyp erstellen:

"machine_config": {
  "machine_type": "MACHINE_TYPE"
}

Ersetzen Sie MACHINE_TYPE durch einen unterstützten Maschinentyp wie n2-highmem-4, c4-highmem-4-lssd oder c4a-highmem-4-lssd. Weitere Informationen zu unterstützten Maschinentypen finden Sie unter AlloyDB-Maschinentyp auswählen.

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/v1/projects/PROJECT_ID/locations/LOCATION_ID/clusters/CLUSTER_ID/instances?instance_id=INSTANCE_ID   -d @instance_request.json

Aktiven Cluster klonen

Wenn Sie einen Klon eines aktiven Clusters erstellen möchten, der eine Kopie aller Daten des Quellclusters enthält und in derselben Region ausgeführt wird, führen Sie eine Wiederherstellung zu einem bestimmten Zeitpunkt für diesen Cluster durch. Sie können dabei einen sehr aktuellen Zeitpunkt angeben, z. B. die erste Sekunde der aktuellen Minute.

Bei diesem Vorgang werden nur die Daten des Quellclusters in den Klon kopiert, nicht die Konfiguration des Quellclusters. Wenn Sie die Daten des Klons mit CMEK verschlüsseln möchten, müssen Sie im Rahmen des Befehls zur Wiederherstellung zu einem bestimmten Zeitpunkt CMEK-Details angeben, auch wenn die Daten des Quellclusters bereits CMEK-verschlüsselt sind. Nachdem der neue Cluster erstellt wurde, müssen Sie Instanzen, Datenbank-Flags, Sicherungszeitpläne und alle anderen erforderlichen Konfigurationen hinzufügen, die Ihren Anforderungen entsprechen.

Ein auf diese Weise erstellter Cluster existiert unabhängig von seiner Quelle. Seine Daten haben nach Abschluss der ersten Duplizierung keine Beziehung zu den Daten des Quellclusters. Wenn Sie sekundäre Cluster erstellen möchten, die Datenänderungen in ihren Quellclustern automatisch verfolgen und replizieren, finden Sie weitere Informationen unter Regionenübergreifende Replikation.

Cluster mit einem bestimmten IP-Adressbereich erstellen

AlloyDB verwendet den Zugriff auf private Dienste, damit die internen Ressourcen eines Clusters miteinander kommunizieren können. Bevor Sie einen Cluster erstellen können, muss Ihr VPC-Netzwerk mindestens einen IP-Adressbereich enthalten, der mit einer Zugriffsverbindung für private Dienste konfiguriert ist.

Überlegungen bei der Verwendung der Axion-basierten C4A-Maschinenserie

AlloyDB bietet eine C4A-Maschinenserie, die auf Google Axion, dem benutzerdefinierten Arm-basierten Prozessor von Google, basiert. C4A-VMs sind als vordefinierte Konfigurationen für 1, 2, 4, 8, 16, 32, 48, 64 und 72 vCPUs mit bis zu 576 GB DDR5-Arbeitsspeicher (Double Data Rate 5) verfügbar.

Beachten Sie bei der Auswahl von C4A Folgendes:

Wenn Sie eine vorhandene N2-Instanz auf eine C4A-Instanz umstellen möchten, ändern Sie den machine_type der aktuellen Instanz über die Google Cloud Console, die gcloud CLI, Terraform oder die API.
Löschen Sie die N2-Instanz nicht und erstellen Sie keine neue C4A-Instanz im selben Cluster.

C4A wird in den folgenden Regionen unterstützt:

asia-east1
asia-southeast1
europe-west1
europe-west2
europe-west3
europe-west4
us-central1
us-east1
us-east4

Überlegungen bei Verwendung des Maschinentyps mit 1 vCPU

AlloyDB bietet eine 1-vCPU-Form mit C4A, die nur für Entwicklungs- und Testzwecke vorgesehen ist. Wählen Sie für Produktionsarbeitslasten mindestens zwei vCPUs aus.

Wenn Sie 1 vCPU auswählen, beachten Sie die folgenden Einschränkungen:

1 vCPU wird mit 8 GB Arbeitsspeicher ohne Unterstützung für ultraschnellen Cache angeboten.
Die Konfiguration mit 1 vCPU wird für Entwicklungs- und Sandbox-Umgebungen mit kleineren Datenbanken im zweistelligen Gigabyte-Bereich empfohlen. Für größere Datenbanken und Produktionsarbeitslasten sollten Sie mindestens 2 vCPUs verwenden.
Sie können die Hochverfügbarkeit konfigurieren, es werden jedoch keine Verfügbarkeits-SLAs angeboten.
Informationen dazu, wo Sie 1 vCPU bereitstellen können, finden Sie unter Unterstützte Regionen für C4A.

Cluster und primäre Instanz erstellen Mit Sammlungen den Überblick behalten Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.

Hinweis

Erforderliche Rollen

Neuen Cluster und neue primäre Instanz erstellen

Console

gcloud

Cluster erstellen

Zugriff auf private Dienste

Private Service Connect

Primäre Instanz erstellen

Terraform

Cluster und primäre Instanz erstellen

Cloud Shell vorbereiten

Verzeichnis vorbereiten

Änderungen anwenden

REST Version 1

Cluster erstellen

Primäre Instanz erstellen

Aktiven Cluster klonen

Cluster mit einem bestimmten IP-Adressbereich erstellen

Überlegungen bei der Verwendung der Axion-basierten C4A-Maschinenserie

C4A wird in den folgenden Regionen unterstützt:

Überlegungen bei Verwendung des Maschinentyps mit 1 vCPU

Nächste Schritte

Cluster und primäre Instanz erstellen