Primäre Instanz erstellen

Console

1. Rufen Sie die Seite Cluster auf.

   Zu den Clustern

2. Klicken Sie in der Spalte Ressourcenname auf einen Cluster.

3. Rufen Sie auf der Seite Übersicht den Bereich Instanzen in Ihrem Cluster auf und klicken Sie auf Primäre Instanz erstellen.

4. Primäre Instanz konfigurieren:

   1. Geben Sie im Feld Instanz-ID eine ID für Ihre primäre Instanz ein.
   2. Wählen Sie unter Zonale Verfügbarkeit eine der folgenden Optionen aus:
      1. Wenn Sie eine hochverfügbare Produktionsinstanz mit automatischem Failover erstellen möchten, wählen Sie Mehrere Zonen (Hochverfügbar) aus.
      2. Wenn Sie eine einfache Instanz erstellen möchten, die nicht hochverfügbar sein muss, wählen Sie Einzelne Zone aus.

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

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

   4. 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.

   5. Optional: Wenn Sie Ihre Anwendungen und Clients über das öffentliche Internet verbinden möchten, setzen Sie unter Öffentliche IP-Verbindung ein Häkchen bei Öffentliche IP-Adresse aktivieren. Wenn Sie eine öffentliche IP-Adresse aktivieren, ist möglicherweise eine zusätzliche Konfiguration erforderlich, damit eine sichere Verbindung hergestellt werden kann. Weitere Informationen finden Sie unter Über öffentliche IP-Adresse verbinden.

      Die private IP-Adresse ist standardmäßig immer aktiviert. Weitere Informationen finden Sie unter Zugriff auf private Dienste aktivieren.

   6. Optional: Wenn Sie den verwalteten Verbindungspool aktivieren und verwenden möchten, klicken Sie unter Verwalteter Verbindungspool das Kästchen Verwalteten Verbindungspool aktivieren an. Weitere Informationen finden Sie unter Verwaltung von Verbindungspools konfigurieren.

   7. Optional: Wenn Sie benutzerdefinierte Flags für Ihre Instanz festlegen möchten, maximieren Sie Erweiterte Konfigurationsoptionen und gehen Sie für jedes Flag so vor:

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

   8. Optional: Wenn Sie SSL- oder Connector-Anforderungen für die Instanz konfigurieren möchten, maximieren Sie Erweiterte Konfigurationsoptionen und gehen Sie dann so vor:

      1. Standardmäßig ist für alle Verbindungen zu AlloyDB-Instanzen eine SSL-Verschlüsselung erforderlich. Wenn Sie Verbindungen ohne SSL zulassen möchten, deaktivieren Sie das Kästchen Nur SSL-Verbindungen zulassen.
      2. Wenn Sie erzwingen möchten, dass für alle Datenbankverbindungen zur Instanz der AlloyDB-Auth-Proxy oder die von Google bereitgestellten sicheren Connector-Bibliotheken verwendet werden, wählen Sie Connectors erforderlich aus.

5. Klicken Sie auf Instanz erstellen.

gcloud

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

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

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

• INSTANCE_ID: Die ID der Instanz, die Sie erstellen. Er muss mit einem Kleinbuchstaben beginnen und darf Kleinbuchstaben, Ziffern und Bindestriche enthalten.
• AVAILABILITY: Gibt an, ob diese Instanz hochverfügbar sein soll, mit Knoten in mehreren Zonen. Gültige Werte sind:
  • REGIONAL: Erstellt eine HA-Instanz mit separaten aktiven und Standby-Knoten und automatischem Failover zwischen ihnen. Dies ist der Standardwert, der für Produktionsumgebungen geeignet ist.
  • ZONAL: Erstellt eine einfache Instanz mit nur einem Knoten und ohne automatisches Failover.
• REGION_ID: Die Region, in der sich die Instanz befinden soll. Beispiel: us-central1.
• CLUSTER_ID: Die ID des Clusters, in dem die Instanz platziert werden soll.

• 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 werden, muss der cpu_count-Wert mit der Anzahl der in machine_type angegebenen vCPUs übereinstimmen. Wenn machine_type beispielsweise n2-highmem-4 ist, müssen Sie cpu_count auf 4 setzen.

• MACHINE_TYPE: der Maschinentyp der Instanz.

  • Für die C4A-Maschinenserie auf Axion-Basis sind die folgenden Werte gültig:

    • 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 gültig:

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

    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.

• PROJECT_ID: Die ID des Projekts, in dem sich der Cluster befindet.

Standardmäßig ist für alle Verbindungen zu neuen Instanzen eine SSL-Verschlüsselung erforderlich. Wenn Sie Nicht-SSL-Verbindungen zur Instanz zulassen möchten, fügen Sie dem Befehl das Flag --ssl-mode=ALLOW_UNENCRYPTED_AND_ENCRYPTED hinzu:

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 \
  --ssl-mode=ALLOW_UNENCRYPTED_AND_ENCRYPTED

Wenn Sie eine sichere Verbindung zwischen dem Client und einer AlloyDB-Instanz über den Auth-Proxy oder andere Anwendungen erzwingen möchten, die von Google bereitgestellte Connector-Bibliotheken verwenden, fügen Sie dem Befehl das Flag --require-connectors hinzu:

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

Wenn Sie das verwaltete Verbindungs-Pooling in Ihrer AlloyDB-Instanz aktivieren möchten, fügen Sie dem Befehl gcloud alloydb instances create das Flag --enable-connection-pooling hinzu:

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

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

Instanz erstellen

Verwenden Sie eine Terraform-Ressource, um eine Instanz in Ihrem Datenbankcluster zu erstellen.

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
  }

  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]
}

Im vorherigen Beispiel wird eine N2-Instanz erstellt. Verwenden Sie zum Erstellen einer C4A-Instanz das Feld machine_type in der Struktur machine_config, wie im folgenden Beispiel gezeigt:

machine_config { 
  machine_type = "c4a-highmem-4-lssd" 
} 

Cloud Shell vorbereiten

Wenn Sie Ihre Terraform-Konfiguration in einem Google Cloud -Projekt anwenden möchten, bereiten Sie Cloud Shell so vor:

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 einem 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.

   git clone https://github.com/terraform-google-modules/terraform-docs-samples

3. Wechseln Sie im Verzeichnis terraform-docs-samples zum Verzeichnis alloydb.

   cd terraform-docs-samples/alloydb

4. Kopieren Sie den Beispielcode in das neu erstellte main.tf.

   cp SAMPLE_FILE

   Ersetzen Sie <var>SAMPLE_FILE</var> durch den Namen der zu kopierenden Beispieldatei, z. B. main.tf.
5. Prüfen und ändern Sie die Beispielparameter, die auf Ihre Umgebung angewendet werden sollen.
6. Speichern Sie die Änderungen.
7. 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

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.

Ö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

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.

Wenn Sie Ihre Anfrage senden möchten, speichern Sie den Anfragetext in einer Datei mit dem Namen instance_request.json.

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

Ersetzen Sie Folgendes:

• CPU_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,
},

Für die C4A-Maschinenserie auf Axion-Basis sind die folgenden Werte gültig:

• 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