Menyiapkan jaringan
Halaman ini menjelaskan opsi jaringan untuk instance notebook terkelola Vertex AI Workbench dan menunjukkan cara menyiapkan jaringan.
Panduan ini direkomendasikan bagi administrator jaringan yang sudah terbiasa dengan konsep jaringan Google Cloud.
Ringkasan
Panduan ini menjelaskan cara mengonfigurasi setiap opsi jaringan berikut:
- Jaringan yang dikelola Google
- Jaringan VPC dalam project yang sama dengan instance notebook terkelola Anda
- Jaringan VPC yang dibagikan
Secara default, instance notebook terkelola Anda menggunakan jaringan yang dikelola Google. Jika mau, Anda dapat menentukan jaringan Virtual Private Cloud yang terletak dalam project Anda atau jaringan VPC Bersama yang dapat Anda akses. Jika Anda menentukan Jaringan VPC atau VPC Bersama, jaringan tersebut memerlukan koneksi akses layanan pribadi.
Perbandingan fitur yang didukung
Tabel berikut menjelaskan fitur-fitur umum yang didukung untuk setiap opsi jaringan.
Fitur | Jaringan yang dikelola Google | Jaringan VPC di project instance Anda | Jaringan VPC yang dibagikan |
---|---|---|---|
External IP | Didukung | Didukung | Didukung |
IP internal | Didukung | Didukung | Didukung |
Akses Google Pribadi | Tidak didukung | Didukung | Didukung |
VPC | Didukung | Didukung | Didukung |
Peering Jaringan VPC (memerlukan Jaringan Layanan) | Tidak didukung | Didukung | Didukung |
Gunakan jaringan default yang dikelola Google
Jaringan default dikelola Google dan tidak memerlukan penyiapan tambahan untuk dikonfigurasi.
Saat Anda membuat instance notebook terkelola dengan jaringan default yang dikelola Google, instance tersebut di-deploy dalam project tenant dan menggunakan VPC serta subnet default.
Untuk mendownload resource tambahan seperti paket Python atau Conda, instance notebook terkelola yang menggunakan jaringan default yang dikelola Google memerlukan alamat IP eksternal.
Menghubungkan instance ke jaringan VPC dalam project yang sama
Untuk menghubungkan instance notebook terkelola ke jaringan VPC dalam project yang sama dengan instance notebook terkelola Anda, lakukan langkah-langkah berikut.
Opsi ini mengharuskan Anda mengonfigurasi akses layanan pribadi.
Sebelum memulai
Pilih atau buat project Google Cloud tempat instance notebook terkelola Anda berada.
-
Make sure that billing is enabled for your Google Cloud project.
-
Enable the Compute Engine, Notebooks, and Service Networking APIs.
Instal gcloud CLI untuk menjalankan contoh command line
gcloud
dalam panduan ini.
Menyiapkan akses layanan pribadi untuk VPC Anda
Saat menyiapkan akses layanan pribadi, Anda membuat koneksi pribadi antara jaringan Anda dan jaringan milik Google atau layanan pihak ketiga (produsen layanan). Dalam hal ini, instance notebook terkelola Anda adalah produsen layanan. Untuk menyiapkan akses layanan pribadi, Anda mencadangkan rentang IP untuk produsen layanan, lalu membuat koneksi peering dengan instance notebook terkelola.
Mengonfigurasi project ID Anda
Untuk mengonfigurasi project ID Anda, gunakan perintah berikut.
gcloud config set project PROJECT_ID
Aktifkan API
Pastikan Anda mengaktifkan API yang diperlukan.Membuat atau memilih VPC
Buat atau pilih VPC yang ada di region notebook terkelola yang didukung untuk digunakan dengan instance notebook terkelola Anda.
Jika Anda sudah memiliki VPC dengan akses layanan pribadi yang dikonfigurasi, dan ingin menggunakan VPC tersebut untuk melakukan peering dengan instance notebook terkelola Anda, langsung keMembuat instance notebook terkelola.
Jika Anda perlu membuat VPC baru, jalankan perintah gcloud CLI berikut:
gcloud compute networks create VPC_NAME \ --project=PROJECT_ID --subnet-mode=auto \ --mtu=1460 --bgp-routing-mode=regional gcloud compute firewall-rules create VPC_NAME-allow-icmp \ --project=PROJECT_ID \ --network=projects/PROJECT_ID/global/networks/VPC_NAME \ --description=Allows\ ICMP\ connections\ from\ any\ source\ to\ any\ instance\ on\ the\ network. \ --direction=INGRESS --priority=65534 --source-ranges=0.0.0.0/0 \ --action=ALLOW --rules=icmp gcloud compute firewall-rules create VPC_NAME-allow-internal \ --project=PROJECT_ID \ --network=projects/PROJECT_ID/global/networks/VPC_NAME \ --description=Allows\ connections\ from\ any\ source\ in\ the\ network\ IP\ range\ to\ any\ instance\ on\ the\ network\ using\ all\ protocols. \ --direction=INGRESS --priority=65534 --source-ranges=10.128.0.0/9 \ --action=ALLOW --rules=all gcloud compute firewall-rules create VPC_NAME-allow-rdp \ --project=PROJECT_ID \ --network=projects/PROJECT_ID/global/networks/VPC_NAME \ --description=Allows\ RDP\ connections\ from\ any\ source\ to\ any\ instance\ on\ the\ network\ using\ port\ 3389. \ --direction=INGRESS --priority=65534 --source-ranges=0.0.0.0/0 \ --action=ALLOW --rules=tcp:3389 gcloud compute firewall-rules create VPC_NAME-allow-ssh \ --project=PROJECT_ID \ --network=projects/PROJECT_ID/global/networks/VPC_NAME \ --description=Allows\ TCP\ connections\ from\ any\ source\ to\ any\ instance\ on\ the\ network\ using\ port\ 22. \ --direction=INGRESS --priority=65534 --source-ranges=0.0.0.0/0 \ --action=ALLOW --rules=tcp:22
Ganti
VPC_NAME
dengan nama untuk VPC Anda.
Membuat dan mengonfigurasi entri DNS
Instance notebook terkelola Vertex AI Workbench menggunakan beberapa domain yang tidak ditangani oleh jaringan Virtual Private Cloud secara default. Untuk memastikan bahwa jaringan VPC Anda menangani permintaan yang dikirim ke domain tersebut dengan benar, gunakan Cloud DNS untuk menambahkan data DNS. Untuk mengetahui informasi selengkapnya tentang rute VPC, lihat Rute.
Guna membuat zona terkelola untuk
sebuah domain, tambahkan entri DNS yang akan mengarahkan permintaan, lalu menjalankan
transaksi, selesaikan langkah-langkah berikut.
Ulangi langkah-langkah berikut untuk masing-masing kelompok
domain yang permintaannya perlu Anda tangani, dimulai
dengan *.notebooks.googleapis.com
.
Di Cloud Shell atau lingkungan mana pun tempat Google Cloud CLI diinstal, masukkan perintah Google Cloud CLI berikut.
-
Untuk membuat zona terkelola pribadi bagi salah satu domain yang perlu ditangani oleh jaringan VPC Anda:
gcloud dns managed-zones create ZONE_NAME \ --visibility=private \ --networks=https://www.googleapis.com/compute/v1/projects/PROJECT_ID/global/networks/NETWORK_NAME \ --dns-name=DNS_NAME \ --description="Description of your managed zone"
Ganti kode berikut:
-
ZONE_NAME
: nama untuk zona yang akan dibuat. Anda harus menggunakan zona terpisah untuk setiap domain. Nama zona ini digunakan di setiap langkah berikut. -
PROJECT_ID
: ID project yang menghosting jaringan VPC Anda -
NETWORK_NAME
: nama jaringan VPC yang Anda buat sebelumnya -
DNS_NAME
: bagian dari nama domain yang muncul setelah*.
, dengan titik di akhir. Misalnya,*.notebooks.googleapis.com
memilikiDNS_NAME
darinotebooks.googleapis.com.
-
-
Mulai transaksi.
gcloud dns record-sets transaction start --zone=ZONE_NAME
-
Tambahkan data A DNS berikut. Tindakan ini akan mengalihkan traffic ke alamat IP yang dibatasi Google.
gcloud dns record-sets transaction add \ --name=DNS_NAME. \ --type=A 199.36.153.4 199.36.153.5 199.36.153.6 199.36.153.7 \ --zone=ZONE_NAME \ --ttl=300
-
Tambahkan data DNS CNAME berikut untuk mengarah ke data A yang baru saja Anda tambahkan. Tindakan ini akan mengalihkan semua traffic yang cocok dengan domain tersebut ke alamat IP yang tercantum dalam langkah sebelumnya.
gcloud dns record-sets transaction add \ --name=\*.DNS_NAME. \ --type=CNAME DNS_NAME. \ --zone=ZONE_NAME \ --ttl=300
-
Jalankan transaksi.
gcloud dns record-sets transaction execute --zone=ZONE_NAME
-
Ulangi langkah ini untuk setiap domain berikut. Untuk setiap pengulangan, ubah ZONE_NAME dan DNS_NAME ke nilai yang sesuai untuk domain tersebut. Buat PROJECT_ID dan NETWORK_NAME tetap sama setiap saat. Anda telah menyelesaikan langkah-langkah tersebut untuk
*.notebooks.googleapis.com
.*.notebooks.googleapis.com
*.notebooks.cloud.google.com
*.notebooks.googleusercontent.com
*.googleapis.com
untuk menjalankan kode yang berinteraksi dengan API dan layanan Google lainnya
Reservasi rentang IP untuk instance notebook terkelola Anda
Saat Anda mencadangkan rentang IP untuk produsen layanan, rentang tersebut dapat digunakan oleh instance notebook terkelola Anda dan layanan lainnya. Jika ingin terhubung dengan produsen layanan lain menggunakan rentang yang sama, Anda dapat mengalokasikan rentang yang lebih besar untuk mengakomodasinya, untuk menghindari kehabisan IP.
Gunakan perintah berikut untuk menetapkan rentang yang dicadangkan menggunakan
gcloud compute addresses create
.
gcloud compute addresses create PEERING_RANGE_NAME \ --global \ --prefix-length=16 \ --description="Managed notebooks range" \ --network=NETWORK_NAME \ --purpose=VPC_PEERING
Ganti kode berikut:
PEERING_RANGE_NAME
: nama rentang AndaNETWORK_NAME
: nama jaringan Anda
Nilai prefix-length
16
berarti blok CIDR
dengan subnet mask /16
akan
disediakan untuk digunakan oleh layanan Google Cloud
seperti notebook terkelola Vertex AI Workbench.
Untuk menghindari konfigurasi jaringan layanan yang tidak valid, gunakan subnet mask
/24
atau yang lebih rendah.
Gunakan perintah berikut untuk memverifikasi alamat.
gcloud compute addresses list
Membuat koneksi peering
Buat koneksi peering antara project host VPC Anda dan Jaringan Layanan Google, menggunakan gcloud services vpc-peerings connect
.
gcloud services vpc-peerings connect \ --service=servicenetworking.googleapis.com \ --network=NETWORK_NAME \ --ranges=PEERING_RANGE_NAME \ --project=PROJECT_ID
Untuk menampilkan daftar peering
gcloud services vpc-peerings list --network=NETWORK_NAME
Membuat instance notebook terkelola
Sebelum menggunakan data permintaan mana pun, lakukan penggantian berikut:
- USER_ACCOUNT: Akun pengguna dalam bentuk alamat email.
- MACHINE_TYPE: Jenis mesin,
misalnya
n1-standard-1
. - PROJECT_ID: Project ID instance notebook terkelola Anda.
- NETWORK_NAME: Nama jaringan VPC.
- LOCATION: Region jaringan VPC Anda.
- NOTEBOOK_NAME: Nama instance notebook terkelola Anda.
- SUBNET_NAME: Nama subnet untuk jaringan VPC Anda.
- PEERING_RANGE_NAME: Opsional. Nama rentang peering jika Anda ingin menentukannya.
Metode HTTP dan URL:
POST https://notebooks.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/runtimes?runtimeId=NOTEBOOK_NAME
Isi JSON permintaan:
{ "access_config": { "access_type": "SINGLE_USER", "runtime_owner": "USER_ACCOUNT" }, "virtual_machine": { "virtual_machine_config": { "machine_type": "MACHINE_TYPE", "network": "projects/PROJECT_ID/global/networks/NETWORK_NAME", "subnet": "projects/PROJECT_ID/regions/LOCATION/subnetworks/SUBNET_NAME", "internal_ip_only": true, "reserved_ip_range": "PEERING_RANGE_NAME" # Optional } } }
Untuk mengirim permintaan Anda, pilih salah satu opsi berikut:
curl
Simpan isi permintaan dalam file bernama request.json
,
dan jalankan perintah berikut:
curl -X POST \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
-d @request.json \
"https://notebooks.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/runtimes?runtimeId=NOTEBOOK_NAME"
PowerShell
Simpan isi permintaan dalam file bernama request.json
,
dan jalankan perintah berikut:
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method POST `
-Headers $headers `
-ContentType: "application/json; charset=utf-8" `
-InFile request.json `
-Uri "https://notebooks.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/runtimes?runtimeId=NOTEBOOK_NAME" | Select-Object -Expand Content
Memverifikasi konektivitas
Untuk memverifikasi bahwa instance notebook terkelola Anda terhubung ke jaringan VPC, selesaikan langkah-langkah berikut.
Di konsol Google Cloud, buka halaman VPC network peering.
Di halaman VPC network peering, cari koneksi Anda.
Ekspor rute kustom
Jika menggunakan rute kustom, Anda harus mengekspornya agar notebook terkelola Vertex AI Workbench dapat mengimpornya.
Untuk mengekspor rute kustom, Anda memperbarui koneksi peering di VPC. Mengekspor rute kustom akan mengirimkan semua rute statis dan dinamis yang memenuhi syarat yang berada di jaringan VPC Anda, seperti rute ke jaringan lokal, ke jaringan produsen layanan (di notebook terkelola). Tindakan ini akan membuat koneksi yang diperlukan dan memungkinkan instance notebook terkelola mengirimkan traffic kembali ke jaringan lokal Anda.
Untuk menampilkan nama koneksi peering yang akan diperbarui,
gunakan perintah berikut.
Jika Anda memiliki beberapa koneksi peering, hapus flag --format
.
gcloud services vpc-peerings list \ --network=NETWORK_NAME \ --service=servicenetworking.googleapis.com \ --project=PROJECT_ID \ --format "value(peering)"
Untuk memperbarui koneksi peering guna mengekspor rute kustom, gunakan perintah berikut.
gcloud compute networks peerings update PEERING_NAME \ --network=NETWORK_NAME \ --export-custom-routes \ --project=PROJECT_ID
Ganti PEERING_NAME dengan nama koneksi peering Anda.
Memeriksa status koneksi peering Anda
Untuk memeriksa apakah koneksi peering Anda aktif, Anda dapat mencantumkannya menggunakan perintah berikut.
gcloud compute networks peerings list --network NETWORK_NAME
Verifikasi bahwa status koneksi peering yang
baru saja Anda buat adalah ACTIVE
.
Pelajari lebih lanjut koneksi peering aktif.
Menghubungkan instance ke jaringan VPC Bersama
Untuk menghubungkan instance notebook terkelola ke jaringan VPC Bersama yang dapat Anda akses, selesaikan langkah-langkah berikut.
Opsi ini mengharuskan Anda mengonfigurasi akses layanan pribadi.
Sebelum memulai
Pilih atau buat project Google Cloud tempat instance notebook terkelola Anda berada.
-
Make sure that billing is enabled for your Google Cloud project.
-
Enable the Compute Engine, Notebooks, and Service Networking APIs.
Saat menggunakan VPC Bersama, Anda menjalankan instance notebook terkelola di project Google Cloud yang terpisah dari project host VPC Anda. Ulangi langkah-langkah sebelumnya untuk mengaktifkan Compute Engine, Notebooks, dan Service Networking API di project host VPC Anda. Pelajari lebih lanjut cara menyediakan VPC Bersama.
Instal gcloud CLI untuk menjalankan contoh command line
gcloud
dalam panduan ini.
Menyiapkan akses layanan pribadi untuk VPC Anda
Saat menyiapkan akses layanan pribadi, Anda membuat koneksi pribadi antara jaringan Anda dan jaringan milik Google atau layanan pihak ketiga (produsen layanan). Dalam hal ini, instance notebook terkelola Anda adalah produsen layanan. Untuk menyiapkan akses layanan pribadi, Anda mencadangkan rentang IP untuk produsen layanan, lalu membuat koneksi peering dengan instance notebook terkelola.
Mengonfigurasi project ID Anda
Untuk mengonfigurasi project ID Anda, gunakan perintah berikut.
gcloud config set project PROJECT_ID
Aktifkan API
Pastikan Anda telah mengaktifkan API yang diperlukan di project host VPC Anda dan project Google Cloud tempat instance notebook terkelola Anda berada.Membuat atau memilih VPC
Buat atau pilih VPC yang ada di region notebook terkelola yang didukung untuk digunakan dengan instance notebook terkelola Anda.
Jika Anda sudah memiliki VPC dengan akses layanan pribadi yang dikonfigurasi, dan ingin menggunakan VPC tersebut untuk melakukan peering dengan instance notebook terkelola Anda, langsung keMembuat instance notebook terkelola.
Jika Anda perlu membuat VPC baru, jalankan perintah gcloud CLI berikut:
gcloud compute networks create VPC_NAME \ --project=PROJECT_ID --subnet-mode=auto \ --mtu=1460 --bgp-routing-mode=regional gcloud compute firewall-rules create VPC_NAME-allow-icmp \ --project=PROJECT_ID \ --network=projects/PROJECT_ID/global/networks/VPC_NAME \ --description=Allows\ ICMP\ connections\ from\ any\ source\ to\ any\ instance\ on\ the\ network. \ --direction=INGRESS --priority=65534 --source-ranges=0.0.0.0/0 \ --action=ALLOW --rules=icmp gcloud compute firewall-rules create VPC_NAME-allow-internal \ --project=PROJECT_ID \ --network=projects/PROJECT_ID/global/networks/VPC_NAME \ --description=Allows\ connections\ from\ any\ source\ in\ the\ network\ IP\ range\ to\ any\ instance\ on\ the\ network\ using\ all\ protocols. \ --direction=INGRESS --priority=65534 --source-ranges=10.128.0.0/9 \ --action=ALLOW --rules=all gcloud compute firewall-rules create VPC_NAME-allow-rdp \ --project=PROJECT_ID \ --network=projects/PROJECT_ID/global/networks/VPC_NAME \ --description=Allows\ RDP\ connections\ from\ any\ source\ to\ any\ instance\ on\ the\ network\ using\ port\ 3389. \ --direction=INGRESS --priority=65534 --source-ranges=0.0.0.0/0 \ --action=ALLOW --rules=tcp:3389 gcloud compute firewall-rules create VPC_NAME-allow-ssh \ --project=PROJECT_ID \ --network=projects/PROJECT_ID/global/networks/VPC_NAME \ --description=Allows\ TCP\ connections\ from\ any\ source\ to\ any\ instance\ on\ the\ network\ using\ port\ 22. \ --direction=INGRESS --priority=65534 --source-ranges=0.0.0.0/0 \ --action=ALLOW --rules=tcp:22
Ganti
VPC_NAME
dengan nama untuk VPC Anda.
Membuat dan mengonfigurasi entri DNS
Instance notebook terkelola Vertex AI Workbench menggunakan beberapa domain yang tidak ditangani oleh jaringan Virtual Private Cloud secara default. Untuk memastikan bahwa jaringan VPC Anda menangani permintaan yang dikirim ke domain tersebut dengan benar, gunakan Cloud DNS untuk menambahkan data DNS. Untuk mengetahui informasi selengkapnya tentang rute VPC, lihat Rute.
Guna membuat zona terkelola untuk
sebuah domain, tambahkan entri DNS yang akan mengarahkan permintaan, lalu menjalankan
transaksi, selesaikan langkah-langkah berikut.
Ulangi langkah-langkah berikut untuk masing-masing kelompok
domain yang permintaannya perlu Anda tangani, dimulai
dengan *.notebooks.googleapis.com
.
Di Cloud Shell atau lingkungan mana pun tempat Google Cloud CLI diinstal, masukkan perintah Google Cloud CLI berikut.
-
Untuk membuat zona terkelola pribadi bagi salah satu domain yang perlu ditangani oleh jaringan VPC Anda:
gcloud dns managed-zones create ZONE_NAME \ --visibility=private \ --networks=https://www.googleapis.com/compute/v1/projects/PROJECT_ID/global/networks/NETWORK_NAME \ --dns-name=DNS_NAME \ --description="Description of your managed zone"
Ganti kode berikut:
-
ZONE_NAME
: nama untuk zona yang akan dibuat. Anda harus menggunakan zona terpisah untuk setiap domain. Nama zona ini digunakan di setiap langkah berikut. -
PROJECT_ID
: ID project yang menghosting jaringan VPC Anda -
NETWORK_NAME
: nama jaringan VPC yang Anda buat sebelumnya -
DNS_NAME
: bagian dari nama domain yang muncul setelah*.
, dengan titik di akhir. Misalnya,*.notebooks.googleapis.com
memilikiDNS_NAME
darinotebooks.googleapis.com.
-
-
Mulai transaksi.
gcloud dns record-sets transaction start --zone=ZONE_NAME
-
Tambahkan data A DNS berikut. Tindakan ini akan mengalihkan traffic ke alamat IP yang dibatasi Google.
gcloud dns record-sets transaction add \ --name=DNS_NAME. \ --type=A 199.36.153.4 199.36.153.5 199.36.153.6 199.36.153.7 \ --zone=ZONE_NAME \ --ttl=300
-
Tambahkan data DNS CNAME berikut untuk mengarah ke data A yang baru saja Anda tambahkan. Tindakan ini akan mengalihkan semua traffic yang cocok dengan domain tersebut ke alamat IP yang tercantum dalam langkah sebelumnya.
gcloud dns record-sets transaction add \ --name=\*.DNS_NAME. \ --type=CNAME DNS_NAME. \ --zone=ZONE_NAME \ --ttl=300
-
Jalankan transaksi.
gcloud dns record-sets transaction execute --zone=ZONE_NAME
-
Ulangi langkah ini untuk setiap domain berikut. Untuk setiap pengulangan, ubah ZONE_NAME dan DNS_NAME ke nilai yang sesuai untuk domain tersebut. Buat PROJECT_ID dan NETWORK_NAME tetap sama setiap saat. Anda telah menyelesaikan langkah-langkah tersebut untuk
*.notebooks.googleapis.com
.*.notebooks.googleapis.com
*.notebooks.cloud.google.com
*.notebooks.googleusercontent.com
*.googleapis.com
untuk menjalankan kode yang berinteraksi dengan API dan layanan Google lainnya
Reservasi rentang IP untuk instance notebook terkelola Anda
Saat Anda mencadangkan rentang IP untuk produsen layanan, rentang tersebut dapat digunakan oleh instance notebook terkelola Anda dan layanan lainnya. Jika ingin terhubung dengan produsen layanan lain menggunakan rentang yang sama, Anda dapat mengalokasikan rentang yang lebih besar untuk mengakomodasinya, untuk menghindari kehabisan IP.
Gunakan perintah berikut untuk menetapkan rentang yang dicadangkan menggunakan
gcloud compute addresses create
.
gcloud compute addresses create PEERING_RANGE_NAME \ --global \ --prefix-length=16 \ --description="Managed notebooks range" \ --network=NETWORK_NAME \ --purpose=VPC_PEERING
Ganti kode berikut:
PEERING_RANGE_NAME
: nama rentang AndaNETWORK_NAME
: nama jaringan Anda
Nilai prefix-length
16
berarti blok CIDR
dengan subnet mask /16
akan
disediakan untuk digunakan oleh layanan Google Cloud
seperti notebook terkelola Vertex AI Workbench.
Untuk menghindari konfigurasi jaringan layanan yang tidak valid, gunakan subnet mask
/24
atau yang lebih rendah.
Gunakan perintah berikut untuk memverifikasi alamat.
gcloud compute addresses list
Membuat koneksi peering
Buat koneksi peering antara project host VPC Anda dan Jaringan Layanan Google, menggunakan gcloud services vpc-peerings connect
.
gcloud services vpc-peerings connect \ --service=servicenetworking.googleapis.com \ --network=NETWORK_NAME \ --ranges=PEERING_RANGE_NAME \ --project=PROJECT_ID
Untuk menampilkan daftar peering
gcloud services vpc-peerings list --network=NETWORK_NAME
Membuat instance notebook terkelola
Sebelum menggunakan data permintaan mana pun, lakukan penggantian berikut:
- USER_ACCOUNT: Akun pengguna dalam bentuk alamat email.
- MACHINE_TYPE: Jenis mesin,
misalnya
n1-standard-1
. - PROJECT_ID: Project ID instance notebook terkelola Anda.
- NETWORK_NAME: Nama jaringan VPC.
- LOCATION: Region jaringan VPC Anda.
- NOTEBOOK_NAME: Nama instance notebook terkelola Anda.
- SUBNET_NAME: Nama subnet untuk jaringan VPC Anda.
- PEERING_RANGE_NAME: Opsional. Nama rentang peering jika Anda ingin menentukannya.
Metode HTTP dan URL:
POST https://notebooks.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/runtimes?runtimeId=NOTEBOOK_NAME
Isi JSON permintaan:
{ "access_config": { "access_type": "SINGLE_USER", "runtime_owner": "USER_ACCOUNT" }, "virtual_machine": { "virtual_machine_config": { "machine_type": "MACHINE_TYPE", "network": "projects/PROJECT_ID/global/networks/NETWORK_NAME", "subnet": "projects/PROJECT_ID/regions/LOCATION/subnetworks/SUBNET_NAME", "internal_ip_only": true, "reserved_ip_range": "PEERING_RANGE_NAME" # Optional } } }
Untuk mengirim permintaan Anda, pilih salah satu opsi berikut:
curl
Simpan isi permintaan dalam file bernama request.json
,
dan jalankan perintah berikut:
curl -X POST \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
-d @request.json \
"https://notebooks.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/runtimes?runtimeId=NOTEBOOK_NAME"
PowerShell
Simpan isi permintaan dalam file bernama request.json
,
dan jalankan perintah berikut:
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method POST `
-Headers $headers `
-ContentType: "application/json; charset=utf-8" `
-InFile request.json `
-Uri "https://notebooks.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/runtimes?runtimeId=NOTEBOOK_NAME" | Select-Object -Expand Content
Memverifikasi konektivitas
Untuk memverifikasi bahwa instance notebook terkelola Anda terhubung ke jaringan VPC Bersama, selesaikan langkah-langkah berikut.
Di konsol Google Cloud, buka halaman VPC network peering.
Di halaman VPC network peering, cari koneksi Anda.
Ekspor rute kustom
Jika menggunakan rute kustom, Anda harus mengekspornya agar notebook terkelola Vertex AI Workbench dapat mengimpornya.
Untuk mengekspor rute kustom, Anda memperbarui koneksi peering di VPC. Mengekspor rute kustom akan mengirimkan semua rute statis dan dinamis yang memenuhi syarat yang berada di jaringan VPC Anda, seperti rute ke jaringan lokal, ke jaringan produsen layanan (di notebook terkelola). Tindakan ini akan membuat koneksi yang diperlukan dan memungkinkan instance notebook terkelola mengirimkan traffic kembali ke jaringan lokal Anda.
Untuk menampilkan nama koneksi peering yang akan diperbarui,
gunakan perintah berikut.
Jika Anda memiliki beberapa koneksi peering, hapus flag --format
.
gcloud services vpc-peerings list \ --network=NETWORK_NAME \ --service=servicenetworking.googleapis.com \ --project=PROJECT_ID \ --format "value(peering)"
Untuk memperbarui koneksi peering guna mengekspor rute kustom, gunakan perintah berikut.
gcloud compute networks peerings update PEERING_NAME \ --network=NETWORK_NAME \ --export-custom-routes \ --project=PROJECT_ID
Ganti PEERING_NAME dengan nama koneksi peering Anda.
Memeriksa status koneksi peering Anda
Untuk memeriksa apakah koneksi peering Anda aktif, Anda dapat mencantumkannya menggunakan perintah berikut.
gcloud compute networks peerings list --network NETWORK_NAME
Verifikasi bahwa status koneksi peering yang
baru saja Anda buat adalah ACTIVE
.
Pelajari lebih lanjut koneksi peering aktif.
Langkah berikutnya
Pelajari lebih lanjut tentang Peering Jaringan VPC.
Lihat arsitektur referensi dan praktik terbaik untuk desain VPC.