Menghubungkan ke instance menggunakan Private Service Connect

Konsol

1. Di konsol Google Cloud , buka halaman Private Service Connect.

   Buka Private Service Connect

2. Klik tab Connection Policies.

3. Klik Create connection policy.

4. Masukkan Name untuk kebijakan koneksi.

5. Tentukan class layanan dengan melakukan hal berikut:

   1. Untuk Source service class, pilih Google services.
   2. Dari menu Service class, pilih google-cloud-alloydb karena AlloyDB adalah layanan terkelola untuk kebijakan koneksi.

6. Di bagian Target endpoint scope, pilih Network dan Region tempat kebijakan ini diterapkan.

7. Di bagian Policy, pilih satu atau beberapa subnet dari menu Subnetworks. Subnet digunakan untuk mengalokasikan alamat IP untuk endpoint.

8. Opsional: Tentukan Connection limit untuk kebijakan. Batas ini menentukan jumlah endpoint yang dapat dibuat AlloyDB untuk kebijakan koneksi ini. Jika Anda tidak menentukan batas koneksi, tidak ada batas.

9. Klik Create policy.

gcloud

Untuk membuat kebijakan koneksi layanan, gunakan perintah service-connection-policies create.

gcloud network-connectivity service-connection-policies create POLICY_NAME \
    --network=NETWORK \
    --project=PROJECT_ID \
    --region=REGION \
    --service-class=SERVICE_CLASS \
    --subnets=https://www.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/subnetworks/SUBNETS \
    --psc-connection-limit=LIMIT \
    --description="DESCRIPTION" \
    --producer-instance-location=PRODUCER_INSTANCE_LOCATION \
    --allowed-google-producers-resource-hierarchy-level=LIST_OF_NODES

Ganti kode berikut:

• POLICY_NAME: nama kebijakan koneksi layanan Anda.
• NETWORK: jaringan tempat kebijakan ini diterapkan.
• PROJECT_ID: project ID atau nomor project jaringan VPC. Untuk jaringan VPC Bersama, Anda harus men-deploy kebijakan koneksi layanan di project host karena kebijakan ini tidak didukung di project layanan.
• REGION: region tempat kebijakan ini berlaku. Kebijakan yang sama harus ada untuk setiap region tempat Anda ingin mengotomatiskan konektivitas layanan.
• SERVICE_CLASS: ID resource yang disediakan produsen dari class layanan. Untuk AlloyDB, class layanan adalah google-cloud-alloydb.
• SUBNETS: satu atau beberapa subnet konsumen reguler yang digunakan untuk mengalokasikan alamat IP untuk endpoint Private Service Connect. Alamat IP ini dialokasikan secara otomatis dan dikembalikan ke kumpulan subnet saat instance layanan terkelola dibuat dan dihapus. Subnet harus berada di region yang sama dengan kebijakan koneksi layanan. Jika beberapa kebijakan koneksi memiliki region yang sama, Anda dapat menggunakan kembali subnetwork yang sama dalam kebijakan tersebut. Anda dapat memasukkan beberapa subnet dalam daftar yang dipisahkan koma.
• LIMIT: jumlah maksimum endpoint yang dapat Anda buat dengan kebijakan ini. Jika Anda tidak menentukan batas, maka tidak ada batas.
• DESCRIPTION: deskripsi opsional untuk kebijakan koneksi layanan.

• PRODUCER_INSTANCE_LOCATION: menentukan apakah kebijakan mengotomatiskan koneksi ke instance AlloyDB. Anda dapat menetapkan nilai ini ke salah satu dari berikut ini:

  • none (default): instance AlloyDB berada dalam project yang sama dengan kebijakan koneksi layanan (atau dalam kasus VPC Bersama, di project yang terhubung).
  • custom-resource-hierarchy-levels: mengharuskan Anda menetapkan jalur lokasi Resource Manager untuk project yang ingin Anda otomatiskan konektivitasnya melalui parameter allowed-google-producers-resource-hierarchy-level.

• LIST_OF_NODES: tetapkan parameter ini jika lokasi instance produser Anda ditetapkan ke custom-resource-hierarchy-levels. Parameter ini adalah daftar project, folder, dan organisasi tempat instance yang konektivitasnya ingin Anda otomatiskan berada. Daftar ini dalam bentuk projects/PROJECT_ID, folders/FOLDER_ID, atau organizations/ORGANIZATION_ID.

Misalnya, perintah berikut akan membuat kebijakan koneksi layanan untuk class layanan
google-cloud-alloydb yang mengalokasikan alamat IP dari subnet managed-services. Maksimal 10 endpoint Private Service Connect dapat dibuat dengan kebijakan ini. Endpoint harus dibuat dalam project yang berada di organisasi yang sama dengan instance layanan terkelola. Instance AlloyDB berada di project myproject.

gcloud network-connectivity service-connection-policies create alloydb-policy \
    --network=default \
    --project=my-project \
    --region=us-central1 \
    --service-class=google-cloud-alloydb \
    --subnets=managed-service-subnet \
    --psc-connection-limit=10 \
    --producer-instance-location=custom-resource-hierarchy-levels \
    --allowed-google-producers-resource-hierarchy-level=projects/myproject

Konsol

1. Di konsol Google Cloud , buka halaman Clusters.

   Buka Cluster

2. Klik Buat kluster.

3. Di Cluster ID, masukkan my-cluster.

4. Masukkan sandi. Catat sandi ini karena Anda akan menggunakannya dalam panduan memulai ini.

5. Pertahankan versi database default.

6. Pilih wilayah us-central1 (Iowa).

7. Pertahankan ID instance default, my-cluster-primary.

8. Di Zonal availability, pertahankan Single zone sebagai opsi yang dipilih. Meskipun kami tidak merekomendasikan instance zona tunggal untuk produksi, Anda dapat menggunakan zona tunggal dalam panduan memulai ini untuk meminimalkan biaya. Untuk mengetahui informasi selengkapnya, lihat Mengurangi biaya menggunakan instance dasar.

9. Pilih jenis mesin 2 vCPU, 16 GB.

10. Mempertahankan konektivitas IP pribadi.

    1. Pilih Private Service Connect (PSC).
    2. Klik Tambahkan endpoint.
    3. Pilih project tempat Anda ingin membuat endpoint.
    4. Pilih jaringan.
    5. Klik Periksa kebijakan untuk melihat informasi kebijakan koneksi layanan.

11. Pertahankan setelan default di bagian Network security.

12. Jangan membuat perubahan di Tampilkan opsi lanjutan.

13. Klik Buat kluster. Mungkin perlu waktu beberapa menit agar AlloyDB membuat cluster dan menampilkannya di halaman Ringkasan cluster utama.

gcloud

Untuk membuat cluster, gunakan perintah gcloud alloydb clusters create.

gcloud alloydb clusters create CLUSTER_ID \
  --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.

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

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

Untuk membuat instance AlloyDB, baik instance utama maupun kumpulan baca untuk menggunakan Private Service Connect, gunakan perintah gcloud alloydb instances create. Pastikan Anda menyertakan parameter --allowed-psc-projects untuk menentukan project konsumen mana yang dapat membuat endpoint untuk terhubung ke instance ini.

gcloud alloydb instances create INSTANCE_ID \
    --instance-type=PRIMARY \
    --cpu-count=CPU_COUNT \
    --availability-type=AVAILABILITY \
    --region=REGION_ID \
    --cluster=CLUSTER_ID \
    --project=PROJECT_ID \
    --allowed-psc-projects=ALLOWED_PROJECT_LIST \
    --psc-network-attachment-uri=NETWORK_ATTACHMENT_URI \
    --psc-auto-connections=network=CONSUMER_NETWORK,project=CONSUMER_PROJECT

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 yang Anda inginkan untuk instance. 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
• AVAILABILITY: menunjukkan 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.
• CLUSTER_ID: ID cluster yang Anda buat sebelumnya.
• ALLOWED_PROJECT_LIST: daftar project ID atau nomor project yang dipisahkan koma yang ingin Anda izinkan mengakses instance—misalnya, my-project-1, 12345,my-project-n.
• NETWORK_ATTACHMENT_URI (Opsional): nama resource lengkap URI lampiran jaringan yang Anda buat untuk konektivitas keluar. Misalnya: projects/PROJECT_ID/regions/REGION_ID/networkAttachments/NETWORK_ATTACHMENT_ID
• CONSUMER_NETWORK: jalur ke jaringan VPC tempat endpoint Private Service Connect perlu dibuat. Contoh: projects/my-host-project/global/networks/default. Opsi ini berlaku saat Anda membuat endpoint secara otomatis. Pastikan kebijakan koneksi layanan dibuat. Anda dapat membuat kebijakan sebelum atau setelah membuat instance.
• CONSUMER_PROJECT: project tempat endpoint Private Service Connect dibuat. Jika Anda menggunakan jaringan VPC Bersama, maka ini bisa berupa project host atau project layanan. Setiap project yang Anda tentukan dalam parameter koneksi otomatis akan otomatis ditambahkan ke project yang diizinkan. Secara opsional, untuk project tempat Anda ingin membuat endpoint Private Service Connect secara manual, Anda dapat menambahkan project ini ke daftar project yang diizinkan.

Cluster sekunder yang dibuat untuk cluster utama yang mendukung Private Service Connect akan otomatis mewarisi konfigurasi Private Service Connect. Untuk mengetahui informasi selengkapnya, lihat Membuat cluster sekunder.

Terraform

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
  }
  psc_instance_config {
  allowed_consumer_projects = ["123456789"]
  psc_interface_configs {
    network_attachment_resource = google_compute_network_attachment.default.id
  }
  }
}

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

resource "google_compute_subnetwork" "default" {
    name = "alloydb-subnetwork"
    region = "us-central1"
    network = google_compute_network.default.id
    ip_cidr_range = "10.0.0.0/16"
}

resource "google_compute_network_attachment" "default" {
  name                  = "alloydb-network-attachment"
  region                = "us-central1"
  connection_preference = "ACCEPT_AUTOMATIC"
  subnetworks = [
    google_compute_subnetwork.default.self_link
  ]
}

data "google_project" "project" {}

Untuk mempelajari cara menerapkan atau menghapus konfigurasi Terraform, lihat Perintah dasar Terraform.

Konsol

1. Di konsol Google Cloud , buka halaman Clusters.

   Buka Cluster

2. Klik Buat kluster.

3. Di Cluster ID, masukkan my-cluster.

4. Masukkan sandi. Catat sandi ini karena Anda akan menggunakannya dalam panduan memulai ini.

5. Pertahankan versi database default.

6. Pilih wilayah us-central1 (Iowa).

7. Pertahankan ID instance default, my-cluster-primary.

8. Di Zonal availability, pertahankan Single zone sebagai opsi yang dipilih. Meskipun kami tidak merekomendasikan instance zona tunggal untuk produksi, Anda dapat menggunakan zona tunggal dalam panduan memulai ini untuk meminimalkan biaya. Untuk mengetahui informasi selengkapnya, lihat Mengurangi biaya menggunakan instance dasar.

9. Pilih jenis mesin 2 vCPU, 16 GB.

10. Mempertahankan konektivitas IP pribadi.

    1. Pilih Private Service Connect(PSC).
    2. Klik Tambahkan endpoint.
    3. Pilih project tempat Anda ingin membuat endpoint.
    4. Pilih jaringan.
    5. Klik Periksa kebijakan untuk melihat informasi kebijakan koneksi layanan.

11. Pertahankan setelan default di bagian Network security.

12. Jangan membuat perubahan di Tampilkan opsi lanjutan.

13. Klik Buat kluster. Mungkin perlu waktu beberapa menit agar AlloyDB membuat cluster dan menampilkannya di halaman Ringkasan cluster utama.

gcloud

Untuk membuat cluster, gunakan perintah gcloud alloydb clusters create.

gcloud alloydb clusters create CLUSTER_ID \
  --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.

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

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

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

gcloud alloydb instances create INSTANCE_ID \
    --instance-type=PRIMARY \
    --cpu-count=CPU_COUNT \
    --availability-type=AVAILABILITY \
    --region=REGION_ID \
    --cluster=CLUSTER_ID \
    --project=PROJECT_ID \
    --allowed-psc-projects=ALLOWED_PROJECT_LIST \
    --psc-network-attachment-uri=NETWORK_ATTACHMENT_URI \

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 yang Anda inginkan untuk instance. 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
• AVAILABILITY: menunjukkan 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.
• CLUSTER_ID: ID cluster yang Anda buat sebelumnya.
• ALLOWED_PROJECT_LIST: daftar project ID atau nomor project yang dipisahkan koma yang ingin Anda izinkan mengakses instance—misalnya, my-project-1, 12345,my-project-n.
• NETWORK_ATTACHMENT_URI (Opsional): nama resource lengkap URI lampiran jaringan yang Anda buat untuk konektivitas keluar. Misalnya: projects/PROJECT_ID/regions/REGION_ID/networkAttachments/NETWORK_ATTACHMENT_ID
• CONSUMER_NETWORK: jalur ke jaringan VPC tempat endpoint Private Service Connect perlu dibuat. Contoh: projects/my-host-project/global/networks/default. Opsi ini berlaku saat Anda membuat endpoint secara otomatis. Pastikan kebijakan koneksi layanan dibuat. Anda dapat membuat kebijakan sebelum atau setelah membuat instance.
• CONSUMER_PROJECT: project tempat endpoint Private Service Connect dibuat. Jika Anda menggunakan jaringan VPC Bersama, maka ini bisa berupa project host atau project layanan. Setiap project yang Anda tentukan dalam parameter koneksi otomatis akan otomatis ditambahkan ke project yang diizinkan. Secara opsional, untuk project tempat Anda ingin membuat endpoint Private Service Connect secara manual, Anda dapat menambahkan project ini ke daftar project yang diizinkan.

Cluster sekunder yang dibuat untuk cluster utama yang mendukung Private Service Connect akan otomatis mewarisi konfigurasi Private Service Connect. Untuk mengetahui informasi selengkapnya, lihat Membuat cluster sekunder.

Terraform

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
  }
  psc_instance_config {
  allowed_consumer_projects = ["123456789"]
  psc_interface_configs {
    network_attachment_resource = google_compute_network_attachment.default.id
  }
  }
}

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

resource "google_compute_subnetwork" "default" {
    name = "alloydb-subnetwork"
    region = "us-central1"
    network = google_compute_network.default.id
    ip_cidr_range = "10.0.0.0/16"
}

resource "google_compute_network_attachment" "default" {
  name                  = "alloydb-network-attachment"
  region                = "us-central1"
  connection_preference = "ACCEPT_AUTOMATIC"
  subnetworks = [
    google_compute_subnetwork.default.self_link
  ]
}

data "google_project" "project" {}

Untuk mempelajari cara menerapkan atau menghapus konfigurasi Terraform, lihat Perintah dasar Terraform.

Java

Jika Anda menggunakan Private Service Connect untuk terhubung ke instance AlloyDB, sertakan hal berikut:

config.addDataSourceProperty("alloydbIpType", "PSC");

Untuk mengetahui informasi selengkapnya tentang cara menggunakan endpoint Private Service Connect di Java Language Connectors, lihat repositori GitHub.

Python (pg8000)

Jika Anda menggunakan Private Service Connect untuk terhubung ke instance AlloyDB, sertakan hal berikut:

  def getconn() -> pg8000.dbapi.Connection:
      conn: pg8000.dbapi.Connection = connector.connect(
          inst_uri,
          "pg8000",
          user=user,
          password=password,
          db=db,
          # use ip_type to specify PSC
          ip_type=IPTypes.PSC,
      )
      return conn

Untuk mengetahui informasi selengkapnya tentang penggunaan endpoint Private Service Connect di Python Language Connectors, lihat repositori GitHub.

Python (asyncpg)

Jika Anda menggunakan Private Service Connect untuk terhubung ke instance AlloyDB, sertakan hal berikut:

  async def getconn() -> asyncpg.Connection:
    conn: asyncpg.Connection = await connector.connect(
        inst_uri,
        "asyncpg",
        user=user,
        password=password,
        db=db,
        # use ip_type to specify PSC
        ip_type=IPTypes.PSC,
    )
    return conn

Untuk mengetahui informasi selengkapnya tentang penggunaan endpoint Private Service Connect di Python Language Connectors, lihat repositori GitHub.

Go (pgx)

Jika Anda menggunakan Private Service Connect untuk terhubung ke instance AlloyDB, sertakan hal berikut:

d.Dial(ctx, instURI, alloydbconn.WithPSC())

Untuk mengetahui informasi selengkapnya tentang cara menggunakan endpoint Private Service Connect di Go Language Connectors, lihat repositori GitHub.

Go (database/sql)

Jika Anda menggunakan Private Service Connect untuk terhubung ke instance AlloyDB, sertakan hal berikut:

  cleanup, err := pgxv5.RegisterDriver(
    "alloydb",
    alloydbconn.WithDefaultDialOptions(alloydbconn.WithPSC())
)

Untuk mengetahui informasi selengkapnya tentang cara menggunakan endpoint Private Service Connect di Go Language Connectors, lihat repositori GitHub.