Melihat informasi instance

Konsol

1. Di konsol Google Cloud, buka halaman Instance Cloud SQL.

   Buka Instance Cloud SQL

   Informasi berikut muncul tentang instance Cloud SQL yang telah mengaktifkan Private Service Connect:

   • Metode koneksi internal: apakah Private Service Connect atau akses layanan pribadi digunakan untuk terhubung ke instance
   • Alamat IP pribadi: Alamat IP endpoint Private Service Connect di jaringan VPC yang terhubung ke lampiran layanan instance
   • Nama DNS: nama DNS instance

2. Untuk melihat status instance saat ini, arahkan kursor ke ikon status di samping nama instance.

   Jika instance berada dalam status FAILED atau MAINTENANCE, Anda dapat membuat clone instance dengan memilih waktu dari masa lalu dan memulihkan instance ke waktu tersebut.

3. Untuk membuka halaman Ringkasan instance, klik nama instance.

   Di kartu Hubungkan ke instance ini, informasi tambahan berikut akan muncul tentang instance Cloud SQL dengan Private Service Connect yang diaktifkan:

   • Konektivitas IP pribadi: statusnya adalah Enabled karena instance harus memiliki alamat IP internal
   • Project yang diizinkan: project ini mengizinkan koneksi dari endpoint Private Service Connect ke instance
   • Lampiran layanan: lampiran layanan instance
   • Konektivitas IP Publik: statusnya Dinonaktifkan karena koneksi IP eksternal tidak didukung

4. Untuk melihat informasi konektivitas tentang instance, termasuk apakah alamat IP internal atau eksternal ditambahkan ke instance, semua jaringan berizin yang terkait dengan instance tersebut, dan apakah layanan Google Cloud lainnya, seperti BigQuery, dapat mengakses data di Cloud SQL dan membuat kueri terhadap data ini melalui koneksi internal, klik tab Connections.

   Untuk mengetahui informasi selengkapnya tentang tab ini, lihat Tentang opsi koneksi.

5. Klik tab Networking. Informasi berikut akan muncul tentang instance yang telah mengaktifkan Private Service Connect:

   • Kotak centang Private IP sudah dicentang, tetapi dinonaktifkan. Instance harus memiliki alamat IP internal, dan setelan ini tidak dapat diubah.
   • Project yang diizinkan untuk instance.
   • Kotak centang Public IP dicentang, tetapi dinonaktifkan.
   • Kolom Jaringan yang diizinkan dinonaktifkan karena instance menggunakan Private Service Connect, yang tidak mendukung fitur ini.

gcloud

Untuk mengetahui informasi tentang menginstal dan memulai gcloud CLI, lihat Menginstal gcloud CLI. Untuk mengetahui informasi tentang cara memulai Cloud Shell, lihat Menggunakan Cloud Shell.

1. Untuk melihat informasi ringkasan tentang suatu instance, gunakan perintah gcloud sql instances describe:

   gcloud sql instances describe INSTANCE_NAME \
   --project=PROJECT_ID

   Lakukan penggantian berikut:

   • INSTANCE_NAME: nama instance Cloud SQL. Jika instance ini telah mengaktifkan Private Service Connect, endpoint Private Service Connect di jaringan VPC dapat terhubung ke instance tersebut.
   • PROJECT_ID: ID atau nomor project project Google Cloud yang berisi instance.

   Berikut adalah contoh output untuk menjalankan perintah ini:

   gcloud sql instances describe myinstance \
   --project=12345
   
   ...
   dnsName: mydnsname
   ...
   pscServiceAttachmentLink: projects/myproject/regions/myregion/serviceAttachments/myserviceattachment
   ...
    settings:
     ...
     ipConfiguration:
     ipv4Enabled: false
     pscConfig:
       allowedConsumerProjects:
         - projects/23456
         - projects/34567
       pscEnabled: true

2. Untuk melihat informasi lebih mendetail tentang instance yang mengaktifkan Private Service Connect, tambahkan parameter berikut:

Setelan	Parameter	Notes
Nama DNS	dnsName	Nama DNS untuk instance. Sebaiknya buat data DNS dengan nama ini dan arahkan ke alamat IP endpoint Private Service Connect. Kami juga merekomendasikan agar Anda menggunakan nama ini untuk terhubung ke instance.
Lampiran layanan	pscServiceAttachmentLink	URI yang mengarah ke lampiran layanan instance. Gunakan URI ini untuk membuat endpoint Private Service Connect.
Project konsumen yang diizinkan	allowedConsumerProjects	Daftar project yang diizinkan untuk instance. Anda dapat membuat endpoint Private Service Connect dari jaringan VPC mana pun dalam project ini ke lampiran layanan instance.
Mengaktifkan Private Service Connect	pscEnabled	Apakah instance telah mengaktifkan Private Service Connect.

Terraform

Untuk membuat instance, gunakan resource Terraform.

resource "google_sql_database_instance" "postgres_pvp_instance_name" {
  name             = "postgres-pvp-instance-name"
  region           = "asia-northeast1"
  database_version = "POSTGRES_14"
  root_password    = "abcABC123!"
  settings {
    tier = "db-custom-2-7680"
    password_validation_policy {
      min_length                  = 6
      reuse_interval              = 2
      complexity                  = "COMPLEXITY_DEFAULT"
      disallow_username_substring = true
      password_change_interval    = "30s"
      enable_password_policy      = true
    }
  }
  # set `deletion_protection` to true, will ensure that one cannot accidentally delete this instance by
  # use of Terraform whereas `deletion_protection_enabled` flag protects this instance at the GCP level.
  deletion_protection = false
}

Menerapkan perubahan

Untuk menerapkan konfigurasi Terraform di project Google Cloud, selesaikan langkah-langkah di bagian berikut.

Menyiapkan Cloud Shell

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 (juga disebut modul root).

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

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

2. Jika mengikuti tutorial, Anda dapat menyalin kode contoh di setiap bagian atau langkah.

   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 dan ubah contoh parameter untuk diterapkan pada lingkungan Anda.
4. Simpan perubahan Anda.
5. Lakukan inisialisasi Terraform. Anda hanya perlu melakukan ini sekali per direktori.

   terraform init

   Secara opsional, untuk menggunakan versi penyedia Google terbaru, sertakan opsi -upgrade:

   terraform init -upgrade

Menerapkan perubahan

1. Tinjau konfigurasi dan pastikan resource yang akan dibuat atau diupdate oleh Terraform sesuai 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.

Menghapus perubahan

Untuk menghapus perubahan Anda, lakukan langkah-langkah berikut:

1. Untuk menonaktifkan perlindungan penghapusan, di file konfigurasi Terraform Anda, tetapkan argumen deletion_protection ke false.

   deletion_protection =  "false"

2. Terapkan konfigurasi Terraform terbaru dengan menjalankan perintah berikut dan memasukkan yes pada perintah:

   terraform apply

3. Hapus resource yang sebelumnya diterapkan dengan konfigurasi Terraform Anda dengan menjalankan perintah berikut dan memasukkan yes pada prompt:

   terraform destroy

REST v1

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

• PROJECT_ID: ID atau nomor project project Google Cloud yang berisi instance.
• INSTANCE_NAME: nama instance Cloud SQL. Jika instance ini telah mengaktifkan Private Service Connect, endpoint Private Service Connect di jaringan VPC dapat terhubung ke instance tersebut.

Metode HTTP dan URL:

GET https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_NAME

Untuk mengirim permintaan, perluas salah satu opsi berikut:

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_NAME"

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_NAME" | Select-Object -Expand Content

Anda akan melihat respons JSON seperti berikut:

{
  "kind": "sql#instance",
  "state": "RUNNABLE",
  "databaseVersion": "POSTGRES_13",
  "settings": {
    "authorizedGaeApplications": [],
    "tier": "db-custom-2-7680",
    "kind": "sql#settings",
    "availabilityType": "REGIONAL",
    "pricingPlan": "PER_USE",
    "replicationType": "SYNCHRONOUS",
    "activationPolicy": "ALWAYS",
    "ipConfiguration": {
      "authorizedNetworks": [],
      "pscConfig": {
        "allowedConsumerProjects": [
          "ALLOWED_PROJECTS"
        ],
        "pscEnabled": true
      },
      "ipv4Enabled": false
    },
  ...
  "createTime": "2023-06-14T18:48:34.975Z",
  "sqlNetworkArchitecture": "NEW_NETWORK_ARCHITECTURE",
  "pscServiceAttachmentLink": "projects/PROJECT_ID/regions/REGION_NAME/serviceAttachments/SERVICE_ATTACHMENT_ID",
  "dnsName": "DNS_NAME"
}

Kolom berikut tersedia untuk instance yang telah mengaktifkan Private Service Connect:

• allowedConsumerProjects: daftar project yang diizinkan untuk instance. Anda dapat membuat endpoint Private Service Connect dari jaringan VPC mana pun dalam project ini ke lampiran layanan instance.
• pscEnabled: apakah instance memiliki Private Service Connect yang diaktifkan untuknya.
• pscServiceAttachmentLink: URI yang mengarah ke lampiran layanan instance. Gunakan URI ini untuk membuat endpoint Private Service Connect.
• dnsName: nama DNS untuk instance. Sebaiknya buat data DNS dengan nama ini dan arahkan ke alamat IP endpoint Private Service Connect. Kami juga merekomendasikan agar Anda menggunakan nama ini untuk terhubung ke instance.

Untuk melihat cara membuat permintaan REST API yang mendasarinya untuk tugas ini, lihat halaman instances:get.

REST v1beta4

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

• PROJECT_ID: ID atau nomor project project Google Cloud yang berisi instance.
• INSTANCE_NAME: nama instance Cloud SQL. Jika instance ini telah mengaktifkan Private Service Connect, endpoint Private Service Connect di jaringan VPC dapat terhubung ke instance tersebut.

Metode HTTP dan URL:

GET https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_NAME

Untuk mengirim permintaan, perluas salah satu opsi berikut:

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_NAME"

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_NAME" | Select-Object -Expand Content

Anda akan melihat respons JSON seperti berikut:

{
  "kind": "sql#instance",
  "state": "RUNNABLE",
  "databaseVersion": "POSTGRES_13",
  "settings": {
    "authorizedGaeApplications": [],
    "tier": "db-custom-2-7680",
    "kind": "sql#settings",
    "availabilityType": "REGIONAL",
    "pricingPlan": "PER_USE",
    "replicationType": "SYNCHRONOUS",
    "activationPolicy": "ALWAYS",
    "ipConfiguration": {
      "authorizedNetworks": [],
      "pscConfig": {
        "allowedConsumerProjects": [
          "ALLOWED_PROJECTS"
        ],
        "pscEnabled": true
      },
      "ipv4Enabled": false
    },
  ...
  "createTime": "2023-06-14T18:48:34.975Z",
  "sqlNetworkArchitecture": "NEW_NETWORK_ARCHITECTURE",
  "pscServiceAttachmentLink": "projects/PROJECT_ID/regions/REGION_NAME/serviceAttachments/SERVICE_ATTACHMENT_ID",
  "dnsName": "DNS_NAME"
}

Kolom berikut tersedia untuk instance yang telah mengaktifkan Private Service Connect:

• allowedConsumerProjects: daftar project yang diizinkan untuk instance. Anda dapat membuat endpoint Private Service Connect dari jaringan VPC mana pun dalam project ini ke lampiran layanan instance.
• pscEnabled: apakah instance memiliki Private Service Connect yang diaktifkan untuknya.
• pscServiceAttachmentLink: URI yang mengarah ke lampiran layanan instance. Gunakan URI ini untuk membuat endpoint Private Service Connect.
• dnsName: nama DNS untuk instance. Sebaiknya buat data DNS dengan nama ini dan arahkan ke alamat IP endpoint Private Service Connect. Kami juga merekomendasikan agar Anda menggunakan nama ini untuk terhubung ke instance.

Untuk melihat cara membuat permintaan REST API yang mendasarinya untuk tugas ini, lihat halaman instances:get.