Mengelola konfigurasi konektivitas pribadi

Di halaman 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 antarmuka Private Service Connect atau koneksi peering Virtual Private Cloud (VPC).

Membuat konfigurasi konektivitas pribadi menggunakan peering VPC

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 (dengan blok CIDR minimal /29) di jaringan VPC. Datastream menggunakan rentang IP ini untuk membuat peering VPC dengan VPC yang disediakan, sehingga rentang tidak dapat tumpang-tindih dengan subnet dalam VPC tersebut. Akibatnya, Datastream dapat berkomunikasi dengan sumber.

Ada dua parameter yang terkait dengan pembuatan konfigurasi konektivitas pribadi:

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

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

POST https://datastream.googleapis.com/v1/projects/PROJECT_ID/locations/
LOCATION/privateConnections?privateConnectionId=PRIVATE_CONNECTIVITY_CONFIGURATION_ID
{
  "displayName": "DISPLAY_NAME",
  "vpcPeeringConfig": {
      "vpcName": "VPC_NAME",
      "subnet": "SUBNET"
  }
}

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

{
  "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-connection",
  "state": "CREATED",
  "vpcPeeringConfig": {
    "vpcName": "projects/my-project/global/networks/my-vpc",
    "subnet": "10.11.12.13/29"
  }  
}

gcloud datastream private-connections create PRIVATE_CONNECTION_NAME --location=LOCATION --display-name=DISPLAY_NAME --vpc=VPC_NAME --subnet=SUBNET

gcloud datastream private-connections create my-privateConnection --location=us-central1 --display-name=my-private-connection --vpc=my-vpc --subnet=10.11.12.13/29

Membuat konfigurasi konektivitas pribadi menggunakan antarmuka Private Service Connect

Sebelum membuat konfigurasi konektivitas pribadi, pastikan Anda:

• Memiliki jaringan VPC untuk terhubung ke jaringan pribadi Datastream. Untuk informasi selengkapnya tentang cara membuat jaringan VPC, lihat Membuat dan mengelola jaringan VPC.

• Buat lampiran jaringan di project VPC Anda.

• Pastikan Google Cloud dan firewall lokal mengizinkan traffic dari rentang alamat IP lampiran jaringan ke database sumber tempat Anda ingin menstreaming data.

Kode berikut menunjukkan permintaan untuk membuat konfigurasi konektivitas pribadi menggunakan antarmuka Private Service Connect. Pertama-tama, Anda harus menjalankan perintah untuk membuat konfigurasi konektivitas pribadi dengan flag validateOnly (--validate-only untuk Google Cloud CLI):

POST "https://datastream.googleapis.com/v1/projects/PROJECT_ID/locations/
LOCATION/privateConnections?privateConnectionId=PRIVATE_CONNECTIVITY_CONFIGURATION_ID&validateOnly=true"

gcloud datastream private-connections create PRIVATE_CONNECTION_NAME --location=LOCATION --display-name=DISPLAY_NAME --network-attachment=NETWORK_ATTACHMENT_NAME --validate-only

Dalam respons, Anda akan mendapatkan nama project produser yang akan disetujui. Anda perlu menambahkannya ke daftar project yang diizinkan untuk lampiran jaringan. Setelah ditambahkan, jalankan perintah untuk membuat konfigurasi konektivitas pribadi lagi, kali ini tanpa flag validateOnly:

POST https://datastream.googleapis.com/v1/projects/PROJECT_ID/locations/
LOCATION/privateConnections?privateConnectionId=PRIVATE_CONNECTIVITY_CONFIGURATION_ID
{
  "displayName": "DISPLAY_NAME",
  "pscInterfaceConfig": {
      "networkAttachment": "NETWORK_ATTACHMENT_NAME"
  }
}

POST https://datastream.googleapis.com/v1/projects/myProjectId/locations/
us-central1/privateConnections?privateConnectionId=myPrivateConnection
{
  "displayName": "my-private-connection",
  "pscInterfaceConfig": {
    "networkAttachment": "projects/my-project/regions/us-central1/networkAttachments/my-na"
  }
}

gcloud datastream private-connections create PRIVATE_CONNECTION_NAME --location=LOCATION --display-name=DISPLAY_NAME --network-attachment=NETWORK_ATTACHMENT_NAME

gcloud datastream private-connections create my-private-connection --location=us-central1 --display-name=my-private-connection --network-attachment=my-network-attachment

Mendapatkan informasi tentang konfigurasi konektivitas pribadi

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

GET https://datastream.googleapis.com/v1/projects/PROJECT_ID/locations/
LOCATION/privateConnections/PRIVATE_CONNECTIVITY_CONFIGURATION_ID

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

Mencantumkan konfigurasi konektivitas pribadi

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

GET https://datastream.googleapis.com/v1/projects/PROJECT_ID/locations/
LOCATION/privateConnections

Menghapus konfigurasi konektivitas pribadi

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

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

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

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

Langkah berikutnya

• Pelajari konektivitas pribadi lebih lanjut.
• Pelajari opsi konektivitas jaringan lainnya yang dapat Anda gunakan dengan Datastream.
• Pelajari cara menggunakan Datastream API untuk mengelola profil koneksi.
• Pelajari cara menggunakan Datastream API untuk mengelola streaming.
• Untuk mengetahui informasi selengkapnya tentang penggunaan Datastream API, lihat dokumentasi referensi.