Halaman ini diterjemahkan oleh Cloud Translation API.

Membuat instance utama

Halaman ini menjelaskan cara membuat instance utama di cluster AlloyDB.

Sebelum memulai

Project Google Cloud yang Anda gunakan harus sudah diaktifkan untuk mengakses AlloyDB.
Anda harus memiliki salah satu peran IAM ini di Google Cloud project yang Anda gunakan:
- roles/alloydb.admin (peran IAM bawaan Admin AlloyDB)
- roles/owner (peran IAM dasar Pemilik)
- roles/editor (peran IAM dasar Editor)
Jika Anda tidak memiliki salah satu peran ini, hubungi Administrator Organisasi Anda untuk meminta akses.

Buat instance utama AlloyDB

Konsol

Buka halaman Cluster.

Buka Cluster
Klik cluster di kolom Nama Resource.
Di halaman Overview, buka Instances in your cluster, lalu klik Create primary instance.
Konfigurasi instance utama Anda:
1. Di kolom Instance ID, masukkan ID untuk instance utama Anda.
2. Di bagian Zonal availability, pilih salah satu opsi berikut:
  1. Untuk membuat instance produksi dengan ketersediaan tinggi dan failover otomatis, pilih Beberapa zona (Ketersediaan tinggi).
  2. Untuk membuat instance dasar yang tidak perlu memiliki ketersediaan tinggi, pilih Single zone.
3. Pilih salah satu seri mesin berikut:
  - C4A (seri mesin berbasis Google Axion)
  - N2 (seri mesin berbasis x86). Ini adalah seri mesin default.
4. 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.
5. Opsional: Untuk menghubungkan aplikasi dan klien Anda melalui internet publik, centang kotak Aktifkan IP Publik di bagian Konektivitas IP Publik. Mengaktifkan IP publik mungkin memerlukan konfigurasi tambahan untuk memastikan Anda memiliki koneksi yang aman. Untuk mengetahui informasi selengkapnya, lihat Menghubungkan menggunakan IP publik.
  
  Secara default, IP pribadi selalu diaktifkan. Untuk mengetahui informasi selengkapnya, lihat Mengaktifkan akses layanan pribadi.
6. Opsional: Untuk mengaktifkan dan menggunakan penggabungan koneksi terkelola, centang kotak Aktifkan kumpulan koneksi terkelola di bagian Kumpulan koneksi terkelola. Untuk mengetahui informasi selengkapnya, lihat Mengonfigurasi penggabungan koneksi terkelola.
7. Opsional: Untuk menetapkan tanda kustom untuk instance Anda, luaskan Opsi konfigurasi lanjutan, lalu lakukan tindakan berikut untuk setiap tanda:
  1. Klik Tambahkan tanda.
  2. Pilih tanda dari daftar Tanda database baru.
  3. Berikan nilai untuk tanda.
  4. Klik Selesai.
8. Opsional: Untuk mengonfigurasi persyaratan SSL atau konektor pada instance, luaskan Opsi konfigurasi lanjutan, lalu lakukan hal berikut:
  1. Secara default, instance AlloyDB mewajibkan semua koneksi untuk menggunakan enkripsi SSL. Untuk mengizinkan koneksi non-SSL, hapus centang pada kotak Hanya izinkan koneksi SSL.
  2. Untuk mewajibkan semua koneksi database ke instance menggunakan Proxy Auth AlloyDB atau library konektor aman yang disediakan oleh Google, pilih Wajibkan konektor.
Klik Create instance.

gcloud

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

Gunakan perintah gcloud alloydb instances create untuk membuat instance utama.

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: ID instance yang Anda buat. Nama harus diawali dengan huruf kecil dan dapat berisi huruf kecil, angka, dan tanda hubung.
AVAILABILITY: Apakah instance ini harus memiliki ketersediaan tinggi (HA), dengan node di beberapa zona. Nilai yang valid mencakup:
- REGIONAL: Membuat instance HA dengan node aktif dan standby terpisah, serta failover otomatis di antara keduanya. Ini adalah nilai default, yang cocok untuk lingkungan produksi.
- ZONAL: Membuat instance dasar, yang hanya berisi satu node, dan tidak ada failover otomatis.
REGION_ID: Region tempat Anda ingin menempatkan instance. Contoh, us-central1.
CLUSTER_ID: ID cluster tempat Anda ingin menempatkan instance.
CPU_COUNT: jumlah vCPU yang Anda inginkan untuk instance.
- Anda harus menentukan cpu_count atau machine_type.
- Jika hanya cpu_count yang diberikan, instance N2 akan dibuat 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
- Jika machine_type dan cpu_count diberikan, nilai cpu_count harus sesuai dengan jumlah vCPU yang ditentukan dalam machine_type. Misalnya, jika machine_type adalah n2-highmem-4, Anda harus menyetel cpu_count ke 4.
MACHINE_TYPE: jenis mesin instance.
- Untuk seri mesin berbasis Axion C4A, berikut adalah nilai yang valid:
  - 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
  Catatan: Deploy hanya mesin c4a-highmem-1 untuk beban kerja pengembangan dan sandbox.
- Untuk seri mesin N2, berikut adalah nilai yang valid:
  - n2-highmem-2
  - n2-highmem-4
  - n2-highmem-8
  - n2-highmem-16
  - n2-highmem-32
  - n2-highmem-64
  - n2-highmem-96
  - n2-highmem-128
  Saat Anda menggunakan machine_type dan cpu_count secara bersamaan, nilai dalam cpu_count dan machine_type harus cocok. Misalnya, jika machine_type adalah n2-highmem-4, Anda harus menyetel cpu_count ke 4.
PROJECT_ID: ID project tempat cluster ditempatkan.

Secara default, instance baru mengharuskan semua koneksi menggunakan enkripsi SSL. Untuk mengizinkan koneksi non-SSL ke instance, tambahkan flag --ssl-mode=ALLOW_UNENCRYPTED_AND_ENCRYPTED ke perintah:

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

Untuk menerapkan koneksi yang aman antara klien dan instance AlloyDB melalui Proxy Auth atau aplikasi lain yang menggunakan library konektor yang disediakan Google, tambahkan tanda --require-connectors ke perintah:

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

Untuk mengaktifkan penggabungan koneksi terkelola di instance AlloyDB, tambahkan flag --enable-connection-pooling ke perintah gcloud alloydb instances create:

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

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

Membuat instance

Untuk membuat instance dalam cluster database, gunakan resource Terraform.

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

Instance N2 dibuat dalam contoh sebelumnya. Untuk membuat instance C4A, gunakan kolom machine_type dalam struktur machine_config, seperti yang ditunjukkan dalam contoh berikut:

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

Menyiapkan Cloud Shell

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

Luncurkan Cloud Shell.
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.

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
```
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.
```
git clone https://github.com/terraform-google-modules/terraform-docs-samples
```
Di direktori terraform-docs-samples, buka direktori alloydb.
```
cd terraform-docs-samples/alloydb
```
Salin kode contoh ke dalam main.tf yang baru dibuat.
```
cp SAMPLE_FILE
```
Ganti <var>SAMPLE_FILE</var> dengan nama file contoh yang akan disalin—misalnya, main.tf.
Tinjau dan ubah contoh parameter untuk diterapkan pada lingkungan Anda.
Simpan perubahan Anda.
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

Tinjau konfigurasi untuk mengonfirmasi bahwa pembaruan Terraform sesuai dengan yang Anda inginkan:
```
terraform plan
```
Koreksi konfigurasi jika diperlukan.
Terapkan konfigurasi Terraform dengan menjalankan perintah berikut dan memasukkan yes pada prompt:
```
terraform apply
```
Tunggu hingga Terraform menampilkan pesan Apply complete!.

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 instance

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 dalam file bernama instance_request.json.

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

Lakukan penggantian berikut:

CPU_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, berikut adalah nilai yang valid:

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

Membuat instance utama Tetap teratur dengan koleksi Simpan dan kategorikan konten berdasarkan preferensi Anda.

Sebelum memulai

Buat instance utama AlloyDB

Konsol

gcloud

Terraform

Membuat instance

Menyiapkan Cloud Shell

Menyiapkan direktori

Menerapkan perubahan

REST v1

Membuat instance

Langkah berikutnya

Membuat instance utama