Membuat cluster dan instance utamanya

Konsol

1. Buka halaman Cluster.

   Buka Cluster

2. Klik Buat kluster.

3. Pilih konfigurasi cluster. Untuk mengetahui informasi selengkapnya tentang perbedaan antara konfigurasi ketersediaan tinggi dan dasar, lihat Node dan instance.

   Jika Anda tidak yakin apakah cluster baru Anda memerlukan instance kumpulan baca, pilih salah satu konfigurasi tanpa kumpulan baca. Anda dapat menambahkan instance kumpulan baca ke cluster nanti, kapan pun diperlukan.

4. Klik Lanjutkan.

5. Di bagian Configure your cluster, di kolom Cluster ID, masukkan ID untuk cluster Anda.

6. Di kolom Password, masukkan sandi awal untuk cluster baru. AlloyDB menetapkan sandi yang diberikan ke pengguna database postgres saat membuat cluster.

7. Di kolom Database version, pilih versi utama PostgreSQL yang ingin Anda gunakan agar server database cluster kompatibel dengannya.

8. Pilih wilayah. Untuk workload pengembangan dan sandbox, pertimbangkan bentuk 1 vCPU (dalam Pratinjau), yang tersedia di wilayah tertentu. Untuk mengetahui informasi selengkapnya, lihat Pertimbangan saat menggunakan 1 vCPU.

9. Pilih jalur jaringan.

10. Opsional: Untuk menerapkan rentang alamat IP tertentu ke cluster ini, bukan mengizinkan AlloyDB memilih rentang alamat IP, ikuti langkah-langkah berikut:

    1. Klik Tampilkan opsi rentang IP yang dialokasikan.

    2. Dari daftar Allocated IP range, pilih rentang alamat IP.

    Untuk mengetahui informasi selengkapnya tentang opsi ini, lihat Membuat cluster dengan rentang alamat IP tertentu.

11. Opsional: Untuk mengenkripsi cluster ini menggunakan kunci enkripsi yang dikelola pelanggan (CMEK), bukan enkripsi yang dikelola Google, ikuti langkah-langkah tambahan berikut:

    1. Klik Opsi enkripsi lanjutan.

    2. Pilih Kunci enkripsi yang dikelola pelanggan (CMEK).

    3. Di menu yang muncul, pilih kunci yang dikelola pelanggan.

       Konsol Google Cloud membatasi daftar ini ke kunci dalam project dan region Google Cloud yang sama dengan cluster baru. Untuk menggunakan kunci yang tidak ada dalam daftar ini, klik Tidak melihat kunci Anda? Masukkan nama resource kunci, lalu ketik nama resource kunci ke dalam dialog yang muncul.

       Perhatikan bahwa penggunaan CMEK dengan AlloyDB memerlukan penyiapan tambahan. Untuk mengetahui informasi selengkapnya, lihat Menggunakan CMEK dengan AlloyDB.

    4. Klik Lanjutkan.

12. Konfigurasi instance utama Anda:

    1. Di kolom Instance ID, masukkan ID untuk instance utama Anda.

    2. Pilih salah satu seri mesin berikut:

       • C4A (seri mesin berbasis Axion Google) (Pratinjau)
       • N2 (seri mesin berbasis x86). Ini adalah seri mesin default.

    3. Pilih jenis mesin.

       • C4A mendukung 1, 4, 8, 16, 32, 48, 64, dan 72 jenis atau bentuk mesin.
       • N2 mendukung jenis atau bentuk mesin 2,4,8,16,32,64,96, dan 128.

       Untuk mengetahui informasi selengkapnya tentang penggunaan seri mesin berbasis Axion C4A, termasuk jenis mesin 1 vCPU, lihat Pertimbangan saat menggunakan seri mesin berbasis Axion C4A.

    4. Opsional: Tetapkan flag kustom untuk instance Anda. Untuk setiap bendera, ikuti langkah-langkah berikut:

       1. Klik Tambahkan tanda.
       2. Di daftar New database flag, pilih tanda.
       3. Berikan nilai untuk tanda.
       4. Klik Selesai.

13. Jika Anda memilih jenis cluster tanpa kumpulan baca, klik Buat cluster.

gcloud

Untuk menggunakan gcloud CLI, Anda dapat menginstal dan melakukan inisialisasi Google Cloud CLI, atau Anda dapat menggunakan Cloud Shell.

1. Untuk membuat cluster dengan akses layanan pribadi atau Private Service Connect yang diaktifkan, gunakan perintah gcloud alloydb clusters create.

   Akses layanan pribadi

   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 

   Ganti kode berikut:

   • CLUSTER_ID: ID cluster yang Anda buat. Nama harus diawali dengan huruf kecil dan dapat berisi huruf kecil, angka, dan tanda hubung.

   • VERSION: versi utama PostgreSQL yang Anda inginkan agar server database cluster kompatibel dengannya. Pilih salah satu opsi berikut:

     • 14, untuk kompatibilitas dengan PostgreSQL 14

     • 15, untuk kompatibilitas dengan PostgreSQL 15

     • 16, untuk kompatibilitas dengan PostgreSQL 16, yang merupakan versi PostgreSQL default yang didukung oleh AlloyDB.

     • 17, untuk kompatibilitas dengan PostgreSQL 17 (Pratinjau)

       Untuk mengetahui informasi selengkapnya tentang batasan yang berlaku untuk penggunaan PostgreSQL 17 dalam Pratinjau, lihat Kompatibilitas PostgreSQL 17 dalam Pratinjau.

   • PASSWORD: sandi yang akan digunakan untuk pengguna postgres default.

   • NETWORK (Opsional): nama jaringan VPC yang Anda konfigurasi untuk akses layanan pribadi ke AlloyDB. Jika Anda menghilangkan flag --network, AlloyDB akan menggunakan jaringan default.

   Jika menggunakan jaringan VPC Bersama, setel ke jalur yang memenuhi syarat sepenuhnya dari jaringan VPC—misalnya, projects/cymbal-project/global/networks/shared-vpc-network.

   • --enable-private-service-connect (Opsional): ditetapkan untuk mengaktifkan Private Service Connect sebagai metode konektivitas untuk cluster dan instance-nya.

   • REGION_ID: region tempat Anda ingin menempatkan cluster.

   • PROJECT_ID: ID project tempat Anda ingin menempatkan cluster.

   Perintah ini memulai operasi yang berjalan lama, dan menampilkan ID operasi.

2. Opsional: Untuk menerapkan rentang alamat IP tertentu ke cluster ini, alih-alih mengizinkan AlloyDB memilih rentang alamat IP, berikan argumen berikut:

   --allocated-ip-range-name=RANGE
   

   Ganti RANGE dengan nama rentang alamat IP yang ingin Anda gunakan oleh cluster ini untuk akses layanan pribadi.

   Untuk mengetahui informasi selengkapnya tentang opsi ini, lihat Membuat cluster dengan rentang alamat IP tertentu.

3. Opsional: Untuk mengenkripsi cluster ini menggunakan kunci enkripsi yang dikelola pelanggan (CMEK), bukan enkripsi yang dikelola Google default, berikan argumen berikut:

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

   Ganti kode berikut:

   • KEY_ID: ID kunci CMEK yang akan digunakan.

   • KEYRING_ID: ID key ring kunci.

   • LOCATION_ID: ID region key ring, yang harus sama dengan region cluster.

   • PROJECT_ID: ID project key ring.

4. Pastikan bahwa operasi berhasil.

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

   Ganti OPERATION_ID dengan ID operasi yang ditampilkan dari langkah sebelumnya.

Setelah membuat cluster utama, Anda harus membuat instance utama.

Membuat instance utama

Untuk membuat instance utama, gunakan perintah gcloud alloydb instances create.

    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 \

Ganti kode berikut:

• INSTANCE_ID: ID instance yang Anda buat. Nama harus diawali dengan huruf kecil dan dapat berisi huruf kecil, angka, dan tanda hubung.

• CPU_COUNT: Jumlah vCPU N2 yang Anda inginkan untuk instance. N2 adalah defaultnya. Nilai yang valid mencakup berikut ini:

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

• MACHINE_TYPE: Parameter ini bersifat opsional saat Anda men-deploy mesin N2. Untuk men-deploy seri mesin berbasis Axion C4A (Pratinjau), atau untuk melakukan migrasi antara mesin C4A dan N2, pilih parameter ini dengan nilai berikut.

  Saat Anda menggunakan MACHINE_TYPE dan CPU_COUNT secara bersamaan, nilai dalam CPU_COUNT dan MACHINE_TYPE harus cocok, jika tidak, Anda akan mendapatkan error.

  Untuk seri mesin berbasis Axion C4A, pilih jenis mesin dengan nilai berikut:

  • 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

  Untuk men-deploy C4A dengan 4vCPU dan yang lebih tinggi, gunakan akhiran lssd, untuk mengaktifkan cache ultra cepat.

  Untuk mengetahui informasi selengkapnya tentang penggunaan seri mesin berbasis Axion C4A, termasuk jenis mesin 1 vCPU, lihat Pertimbangan saat menggunakan seri mesin berbasis Axion C4A.

  Untuk seri mesin berbasis x86 N2, gunakan jenis mesin dengan nilai berikut:

  • 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: region tempat Anda ingin menempatkan instance.

• CLUSTER_ID: ID cluster yang Anda buat sebelumnya.

• PROJECT_ID: ID project tempat cluster Anda dibuat.

Opsional: Untuk menerapkan rentang alamat IP tertentu ke instance ini dan mengganti alokasi rentang alamat IP yang dikonfigurasi di tingkat cluster, berikan argumen berikut:

    --allocated-ip-range-override=OVERRIDE_RANGE_NAME

Ganti OVERRIDE_RANGE_NAME dengan nama rentang alamat IP yang ingin digunakan instance ini untuk akses layanan pribadi—misalnya: google-managed-services-default. Nama rentang harus sesuai dengan RFC 1035. Secara khusus, nama harus terdiri dari 1-63 karakter dan cocok dengan ekspresi reguler [a-z]([-a-z0-9]*[a-z0-9])?.

Untuk mengetahui informasi selengkapnya tentang opsi ini, lihat Membuat instance dengan rentang alamat IP tertentu.

Anda juga dapat membuat instance AlloyDB dengan Private Service Connect yang diaktifkan. Untuk mengetahui informasi tentang cara membuat instance utama untuk cluster yang mendukung Private Service Connect, lihat Membuat instance AlloyDB.

Terraform

Untuk membuat cluster, gunakan resource Terraform.

Berikut adalah cuplikan kode untuk membuat cluster berdasarkan contoh AlloyDB cluster full:

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

Menyiapkan Cloud Shell

Untuk menerapkan konfigurasi Terraform di project Google Cloud , siapkan Cloud Shell sebagai berikut:

1. Luncurkan Cloud Shell.

2. Tetapkan project Google Cloud default tempat Anda ingin menerapkan konfigurasi Terraform.

   Anda hanya perlu menjalankan perintah ini sekali per project, dan dapat dijalankan di direktori mana pun.

   export GOOGLE_CLOUD_PROJECT=PROJECT_ID

   Variabel lingkungan akan diganti jika Anda menetapkan nilai eksplisit dalam file konfigurasi Terraform.

Menyiapkan direktori

Setiap file konfigurasi Terraform harus memiliki direktorinya sendiri, yang juga disebut modul root.

1. Di Cloud Shell, buat direktori dan file baru di dalam direktori tersebut. Nama file harus berupa file TF—misalnya, main.tf. Dalam dokumen ini, file tersebut disebut sebagai main.tf.

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

2. Salin kode contoh ke dalam main.tf yang baru dibuat. Atau, salin kode dari GitHub. Tindakan ini direkomendasikan jika cuplikan Terraform adalah bagian dari solusi menyeluruh.
3. Tinjau file main.tf dan ubah contoh parameter untuk diterapkan pada lingkungan Anda.
4. Simpan perubahan.
5. Lakukan inisialisasi Terraform. Anda hanya perlu melakukan ini sekali per direktori.

   terraform init

   Opsional: Untuk menggunakan versi penyedia Google terbaru, sertakan opsi -upgrade:

   terraform init -upgrade

Menerapkan perubahan

1. Tinjau konfigurasi untuk mengonfirmasi bahwa pembaruan Terraform sesuai dengan yang Anda inginkan:

   terraform plan

   Koreksi konfigurasi jika diperlukan.
2. Terapkan konfigurasi Terraform dengan menjalankan perintah berikut dan memasukkan yes pada prompt:

   terraform apply

   Tunggu hingga Terraform menampilkan pesan Apply complete!.
3. Buka project Google Cloud Anda untuk melihat hasilnya. Di konsol Google Cloud , buka resource Anda di UI untuk memastikan bahwa Terraform telah membuat atau mengupdatenya.

REST v1

Membuat cluster

Contoh ini akan membuat cluster. Untuk mengetahui daftar lengkap parameter panggilan ini, lihat Metode: projects.locations.clusters.create. Untuk mengetahui informasi tentang setelan cluster, lihat Melihat setelan cluster dan instance.

Jangan menyertakan informasi sensitif atau informasi identitas pribadi di ID cluster Anda karena dapat terlihat secara eksternal. Anda tidak perlu menyertakan ID project dalam nama cluster. Hal ini dilakukan secara otomatis jika sesuai, misalnya, di file log.

Untuk mengirim permintaan, simpan isi permintaan dalam file bernama cluster_request.json:

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

Lakukan penggantian berikut:

• DATABASE_VERSION: string enum versi database—misalnya, POSTGRES_16.
• INITIAL_USERNAME: nama pengguna yang Anda gunakan untuk pengguna postgres default.
• INITIAL_USER_PASSWORD: sandi yang Anda gunakan untuk pengguna postgres default.

Gunakan metode HTTP dan URL berikut:

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

Lakukan penggantian berikut:

• PROJECT_ID: ID project tempat Anda ingin menempatkan cluster.
• LOCATION_ID: ID region cluster.
• CLUSTER_ID: ID cluster yang Anda buat. ID cluster harus dimulai dengan huruf kecil dan dapat berisi huruf kecil, angka, dan tanda hubung.

Anda dapat menggunakan curl berikut untuk menjalankan permintaan sebelumnya:

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

Membuat instance utama

Contoh ini membuat instance utama. Untuk mengetahui daftar lengkap parameter panggilan ini, lihat Method: projects.locations.clusters.instances.create. Untuk mengetahui informasi tentang setelan cluster, lihat Melihat setelan cluster dan instance.

Jangan menyertakan informasi sensitif atau informasi identitas pribadi di ID cluster Anda, karena ID tersebut terlihat secara eksternal. Anda tidak perlu menyertakan ID project dalam nama cluster karena hal ini dilakukan secara otomatis jika sesuai —misalnya, dalam file log.

Untuk mengirim permintaan, simpan isi permintaan berikut dalam file bernama instance_request.json.

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

Lakukan penggantian berikut:

• VCPU_COUNT: jumlah core CPU yang terlihat pada instance yang ingin Anda buat.

Contoh sebelumnya membuat instance N2 dengan spesifikasi berikut:

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

Untuk membuat instance C4A, gunakan kolom machine_type, bukan cpu_count dalam struktur machine_config, seperti yang ditunjukkan dalam contoh berikut:

machine_config: {
  machine_type : MACHINE_TYPE,
},

Untuk seri mesin berbasis Axion C4A, gunakan nilai valid berikut:

• 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

Untuk seri mesin N2, gunakan nilai valid berikut:

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

Gunakan metode HTTP dan URL berikut:

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

Lakukan penggantian berikut:

• PROJECT_ID: ID project tempat Anda ingin menempatkan cluster.
• LOCATION_ID: ID region cluster.
• CLUSTER_ID: ID cluster yang Anda buat. ID harus diawali dengan huruf kecil dan dapat berisi huruf kecil, angka, dan tanda hubung.
• INSTANCE_ID: nama instance utama yang ingin Anda buat.

Anda dapat menggunakan curl untuk mengeksekusi permintaan, seperti yang ditunjukkan dalam contoh berikut:

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