Mengelola konfigurasi konektivitas pribadi

Ringkasan

Di bagian ini, Anda akan mempelajari cara menggunakan Datastream API untuk membuat, mengambil informasi tentang, dan menghapus konfigurasi konektivitas pribadi.

Konfigurasi konektivitas pribadi berisi informasi yang digunakan Datastream untuk berkomunikasi dengan sumber data melalui jaringan pribadi (secara internal dalam Google Cloud, atau dengan sumber eksternal yang terhubung melalui VPN atau Interconnect). Komunikasi ini terjadi melalui koneksi peering Virtual Private Cloud (VPC).

Ada dua cara untuk menggunakan Datastream API. Anda dapat melakukan panggilan REST API atau menggunakan Google Cloud CLI (CLI).

Untuk melihat informasi tingkat tinggi tentang penggunaan gcloud untuk mengelola konfigurasi konektivitas pribadi Datastream, klik di sini.

Untuk menggunakan koneksi pribadi, setiap streaming dan profil koneksi yang menggunakan konfigurasi konektivitas pribadi harus berada di region yang sama.

Sebaiknya database sumber dijalankan di subnet di region yang sama dengan konfigurasi konektivitas pribadi. Jika tidak, Anda harus menambahkan aturan firewall secara manual yang memungkinkan komunikasi antar-region.

Membuat konfigurasi konektivitas pribadi

Sebelum membuat konfigurasi konektivitas pribadi, pastikan Anda:

• Memiliki jaringan VPC untuk melakukan peering ke jaringan pribadi Datastream. Untuk mengetahui informasi selengkapnya tentang cara membuat jaringan VPC, lihat Menggunakan Peering Jaringan VPC.
• Memiliki rentang IP yang tersedia di jaringan VPC. Datastream menggunakan rentang IP ini untuk membuat peering VPC dengan VPC yang disediakan, sehingga rentang tersebut tidak dapat tumpang tindih dengan subnet dalam VPC tersebut. Akibatnya, Datastream dapat berkomunikasi dengan sumbernya.

Ada dua parameter yang terkait dengan pembuatan konfigurasi konektivitas pribadi:

• vpcName: Tentukan nama dan jalur jaringan VPC.
• subnet: Memberikan rentang IP yang tersedia di jaringan VPC.

Kode berikut menunjukkan permintaan untuk membuat konfigurasi konektivitas pribadi, dan menentukan metode konektivitas menggunakan peering VPC (vpcPeeringConfig).

REST

POST https://datastream.googleapis.com/v1/projects/[project-id]/locations/
[location]/privateConnections?privateConnectionId=[private-connectivity configuration-id]
{
  "displayName": "[private-connectivity-configuration-display-name]",
  "vpcPeeringConfig": {
      "vpcName": "[name-and-path-of-VPC-network]",
      "subnet": "[subnet]"
  }
}

Contoh:

POST https://datastream.googleapis.com/v1/projects/myProjectId/locations/
us-central1/privateConnections?privateConnectionId=myPrivateConnection
{
  "displayName": "my private connectivity configuration",
  "vpcPeeringConfig": {
    "vpcName": "projects/my-project/global/networks/my-vpc",
    "subnet": "10.11.12.13/29"
  }
}

Sebagai bagian dari pembuatan konfigurasi konektivitas pribadi, beberapa resource Google Cloud juga sedang dibuat untuk mencapai konektivitas tersebut. Oleh karena itu, mungkin perlu waktu beberapa menit untuk membuat konfigurasi konektivitas pribadi.

Setelah konfigurasi konektivitas pribadi dibuat, Anda dapat melihat informasi tentang konfigurasi tersebut dengan memanggil metode privateConnections/get. Output Anda akan muncul, mirip dengan berikut ini:

{
  "name": "projects/projectId/location/us-central1/privateConnections/myPrivateConnection",
  "createTime": "2019-12-22T16:17:37.159786963Z",
  "updateTime": "2019-12-22T16:17:37.159786963Z",
  "displayName": "my private connectivity configuration",
  "state": "CREATED",
  "vpcPeeringConfig": {
    "vpcName": "projects/my-project/global/networks/my-vpc",
    "subnet": "10.11.12.13/29"
  }
}

Ada tiga status konfigurasi konektivitas pribadi:

• CREATING: Konfigurasi konektivitas pribadi sedang dalam proses pembuatan.
• CREATED: Konfigurasi konektivitas pribadi siap digunakan oleh profil koneksi.
• FAILED: Terjadi masalah saat konfigurasi konektivitas pribadi sedang dalam proses pembuatan. Jika ini terjadi, pesan kesalahan yang mudah dipahami akan muncul, menjelaskan mengapa kesalahan terjadi dan apa yang harus dilakukan untuk memperbaiki masalah tersebut.

gcloud

Untuk mengetahui informasi selengkapnya tentang penggunaan gcloud guna membuat konfigurasi konektivitas pribadi, klik di sini.

Mendapatkan informasi tentang konfigurasi konektivitas pribadi

Kode berikut menampilkan permintaan untuk mengambil informasi tentang konfigurasi konektivitas pribadi yang telah dibuat.

REST

GET https://datastream.googleapis.com/v1/projects/[project-id]/locations/
[location]/privateConnections/[private-connectivity-configuration-id]

Contoh:

GET https://datastream.googleapis.com/v1/projects/myProjectId/locations/
us-central1/privateConnections/myPrivateConnection
     

gcloud

Untuk mengetahui informasi selengkapnya tentang penggunaan gcloud dalam mengambil informasi tentang konfigurasi konektivitas pribadi, klik di sini.

Mencantumkan konfigurasi konektivitas pribadi

Kode berikut menampilkan permintaan untuk mengambil informasi tentang semua konfigurasi konektivitas pribadi Anda.

REST

GET https://datastream.googleapis.com/v1/projects/[project-id]/locations/
[location]/privateConnections

gcloud

Untuk informasi selengkapnya tentang penggunaan gcloud dalam mengambil informasi tentang semua konfigurasi konektivitas pribadi, klik di sini.

Menghapus konfigurasi konektivitas pribadi

Kode berikut menampilkan permintaan untuk menghapus konfigurasi konektivitas pribadi. Setelah konfigurasi dihapus, profil koneksi apa pun yang menggunakan konfigurasi tersebut tidak akan berfungsi. Selain itu, streaming apa pun yang menggunakan profil koneksi ini tidak akan dapat dioperasikan.

Untuk mengatasi masalah ini, tetapkan konfigurasi konektivitas pribadi yang berbeda untuk setiap profil koneksi. Untuk mengetahui informasi selengkapnya, lihat Memperbarui profil koneksi.

REST

DELETE https://datastream.googleapis.com/v1/projects/[project-id]/locations/
[location]/privateConnections/[private-connectivity-configuration-id] {"force": true}

Contoh:

DELETE https://datastream.googleapis.com/v1/projects/myProjectId/locations/
us-central1/privateConnections/myPrivateConnection {"force": true}

Anda harus menambahkan kode {"force": true} untuk memastikan konfigurasi konektivitas pribadi dihapus dengan benar.

gcloud

Untuk mengetahui informasi selengkapnya tentang penggunaan gcloud guna menghapus konfigurasi konektivitas pribadi, klik di sini.