Dokumen ini memandu Anda dalam proses mengonfigurasi konektivitas VPC saat men-deploy Gateway Agen agar dapat berkomunikasi secara pribadi dengan jaringan VPC di organisasi Anda.
Dengan menyiapkan konektivitas VPC, Anda dapat melakukan hal berikut:
- Terapkan traffic keluar VPC untuk traffic: Rutekan traffic yang berasal dari agen Anda melalui lampiran jaringan Private Service Connect ke jaringan VPC Anda menggunakan mode
PRIVATE_RANGES_ONLYatauALL_TRAFFIC. - Rentang alamat IP sumber statis: Traffic egress menggunakan rentang alamat IP pribadi subnet lampiran jaringan Private Service Connect Anda sebagai alamat IP sumbernya. Rentang IP sumber statis ini memungkinkan Anda mengonfigurasi kebijakan firewall untuk jaringan VPC guna mengatur traffic yang berasal dari gateway.
- Resolusi DNS kustom: Selesaikan nama domain pribadi internal dan nama domain eksternal langsung dari agen Anda menggunakan peering Cloud DNS.
- Keamanan perimeter: Lindungi komunikasi agen menggunakan perimeter layanan Kontrol Layanan VPC.
- Validasi sertifikat pribadi atau yang ditandatangani sendiri: Hubungkan ke tujuan yang menggunakan CA pribadi atau sertifikat yang ditandatangani sendiri.
Untuk mengonfigurasi konektivitas VPC, Anda membuat
template konektivitas Agent Gateway
(AgentConnectivityTemplate) tempat Anda menentukan dan mengelola setelan jaringan egress
untuk instance Agent Gateway Anda.
Cara kerja konektivitas VPC
Saat Anda men-deploy Gateway Agen dengan template konektivitas, gateway akan menggunakan antarmuka Private Service Connect untuk merutekan traffic agen keluar ke jaringan VPC yang Anda tentukan.
Mode egress VPC
Anda mengonfigurasi cara gateway merutekan traffic melalui lampiran jaringan menggunakan setelan vpcEgress di template konektivitas.
Traffic ke rentang alamat IP pribadi (
PRIVATE_RANGES_ONLY): Merutekan traffic yang hanya ditujukan untuk rentang alamat IP pribadi ke jaringan VPC Anda. Traffic keluar dirutekan ke jaringan VPC Anda hanya jika alamat IP tujuan termasuk dalam salah satu rentang berikut:- RFC 1918:
10.0.0.0/8,172.16.0.0/12,192.168.0.0/16 - RFC 6598:
100.64.0.0/10 - Class E:
240.0.0.0/4 private.googleapis.com:199.36.153.8/30restricted.googleapis.com:199.36.153.4/30- Endpoint PSC untuk Google API: Jika Anda men-deploy endpoint Private Service Connect kustom untuk Google API menggunakan alamat IP pribadi internal di jaringan VPC Anda, traffic ke endpoint ini akan dirutekan melalui jaringan VPC Anda. Pastikan peering Cloud DNS dikonfigurasi di template konektivitas agar Agent Gateway me-resolve domain Google API dengan benar ke alamat IP endpoint PSC internal Anda.
Permintaan ke Google API publik standar ditangani secara otomatis menggunakan Akses Google Pribadi, dan traffic yang menuju internet dirutekan langsung melalui Agent Gateway, bukan melalui Jaringan VPC Anda.
- RFC 1918:
Traffic ke semua rentang alamat IP (
ALL_TRAFFIC): Merutekan semua traffic keluar yang berasal dari agen Anda melalui jaringan VPC Anda, termasuk internet publik, API SaaS eksternal, dan alamat non-RFC 1918.- Pemilihan rute dan keamanan: Karena setelan ini merutekan semua traffic keluar ke VPC, Anda bertanggung jawab untuk mengelola pemilihan rute dan keamanannya. Pastikan jaringan VPC Anda
memiliki rute default (
0.0.0.0/0) untuk meneruskan traffic ini ke gateway keluar atau peralatan keamanan Anda (seperti firewall next-hop atau antarmuka Cloud Interconnect). - Egress internet publik: Gateway Agen mengirimkan traffic keluar ke jaringan VPC Anda, tempat traffic tersebut keluar ke internet publik melalui gateway Cloud NAT di subnet lampiran jaringan Private Service Connect. Jika Anda menetapkan alamat IP eksternal statis ke gateway Cloud NAT, layanan jarak jauh dapat mengizinkan traffic egress agen Anda berdasarkan alamat IP sumber ini.
- Kontrol Layanan VPC: Mode egress harus ditetapkan ke
ALL_TRAFFICuntuk mendukung perimeter layanan Kontrol Layanan VPC.
- Pemilihan rute dan keamanan: Karena setelan ini merutekan semua traffic keluar ke VPC, Anda bertanggung jawab untuk mengelola pemilihan rute dan keamanannya. Pastikan jaringan VPC Anda
memiliki rute default (
Resolusi DNS dan pemilihan rute traffic
Secara default, Gateway Agen me-resolve nama domain menggunakan DNS rekursif publik. Jika agen Anda perlu mengakses workload internal, alat pribadi,
atau Google API yang dihosting di nama domain pribadi di jaringan VPC
Anda (seperti endpoint corp.internal. atau PSC), Anda dapat
mengonfigurasi peering Cloud DNS untuk meneruskan kueri DNS ke
zona terkelola Cloud DNS pribadi jaringan Anda.
Tabel berikut merangkum persyaratan peering DNS Cloud dan perilaku pemilihan rute traffic untuk berbagai tujuan saat konektivitas VPC dikonfigurasi dalam mode ALL_TRAFFIC:
| Tujuan traffic | Apakah peering Cloud DNS diperlukan? | Resolusi DNS | Jalur egress |
|---|---|---|---|
| Layanan IP pribadi (RFC 1918/internal) |
Ya (misalnya, corp.internal.) |
Menyelesaikan menggunakan peering Cloud DNS dengan zona terkelola Cloud DNS pribadi jaringan VPC target Anda. | Traffic memasuki jaringan VPC Anda melalui lampiran jaringan untuk terhubung ke workload internal. |
| Nama host publik dengan IP pribadi (DNS split-horizon) |
Tidak | Menyelesaikan menggunakan DNS rekursif publik standar di proxy gateway tanpa memerlukan peering Cloud DNS. | Traffic memasuki jaringan VPC Anda melalui lampiran jaringan untuk terhubung ke workload internal. |
| Internet publik & API SaaS (Domain eksternal) |
Tidak | Menyelesaikan menggunakan DNS rekursif publik standar di proxy gateway tanpa memerlukan peering Cloud DNS. | Traffic memasuki jaringan VPC Anda melalui lampiran jaringan dan keluar ke internet publik menggunakan Cloud NAT yang dikonfigurasi di subnet. |
| Google Cloud API (standar, tanpa Kontrol Layanan VPC) |
Tidak | Menyelesaikan menggunakan DNS rekursif publik standar di proxy gateway tanpa memerlukan peering Cloud DNS. | Traffic memasuki jaringan VPC Anda melalui lampiran jaringan dan dirutekan secara pribadi menggunakan Akses Google Pribadi yang diaktifkan di subnet, tanpa menggunakan Cloud NAT atau peering DNS. |
| Google Cloud API (dengan Kontrol Layanan VPC) |
Ya (untuk googleapis.com.) |
Me-resolve ke rentang Google API yang dibatasi (199.36.153.4/30) atau endpoint Private Service Connect internal menggunakan zona Cloud DNS pribadi. |
Traffic memasuki jaringan VPC Anda melalui lampiran jaringan untuk menerapkan aturan keamanan perimeter Kontrol Layanan VPC1. |
1 Jika permintaan gagal dengan pelanggaran Kontrol Layanan VPC seperti
NETWORK_NOT_IN_SAME_SERVICE_PERIMETER atau
SECURITY_POLICY_VIOLATED di compute.googleapis.com atau
dns.googleapis.com yang merujuk ke project host, pastikan
project host berada dalam perimeter yang sama dengan project gateway.
Persyaratan sertifikat TLS
Saat merutekan traffic egress melalui HTTPS, Agent Gateway memvalidasi rantai sertifikat TLS server tujuan selama TLS handshake. Persyaratan sertifikat untuk koneksi HTTPS bergantung pada apakah endpoint target Anda menggunakan Certificate Authority (CA) yang dipercaya secara publik atau CA pribadi/yang ditandatangani sendiri.
CA Publik: Secara default, Agent Gateway memercayai sertifikat yang dikeluarkan oleh Certificate Authority (CA) yang dipercaya secara publik yang memenuhi persyaratan sertifikat server standar (termasuk Subject Alternative Name (SAN) yang cocok dengan nama host target).
CA pribadi dan sertifikat yang ditandatangani sendiri: Jika tujuan target Anda (agen, alat, atau server MCP di jaringan VPC Anda) menggunakan CA pribadi atau PKI internal, Anda dapat mengonfigurasi trust anchor kustom menggunakan setelan
tlsConfigdi template konektivitas Anda.Dengan mereferensikan resource
TrustConfigCertificate Manager, Anda dapat mengonfigurasi Agent Gateway untuk hanya memercayai CA pribadi tertentu, atau menggabungkan CA root pribadi dengan CA tepercaya publik (PUBLICLY_TRUSTED_ROOTS). Tindakan ini akan membangun kepercayaan untuk endpoint publik dan pribadi.Jika agen Anda terhubung ke API Google Cloud (
*.googleapis.com) atau endpoint HTTPS publik lainnya, Anda harus menetapkanadditionalRootskePUBLICLY_TRUSTED_ROOTS; tanpa setelan ini, Agent Gateway tidak akan memercayai sertifikat yang ditandatangani Google untukgoogleapis.com.Perhatikan batasan berikut saat menggunakan
tlsConfig:- Saat menggunakan
trustConfiguntuk merutekan traffic ke tujuan yang menggunakan CA pribadi, Anda harus merotasi file PEM secara manual. Rotasi otomatis file PEM menggunakan pengelola secret, seperti Secret Manager Google Cloud, tidak didukung. - Kolom
trustConfigtidak dapat diubah setelah dikonfigurasi pada template konektivitas, dan Agent Gateway tidak otomatis mengambil perubahan yang dilakukan padatlsConfig(seperti mengupdateadditionalRoots) pada template konektivitas yang dilampirkan. Untuk mengetahui petunjuk cara memperbarui setelan TLS, lihat Memperbarui setelan traffic keluar VPC.
- Saat menggunakan
Jika Agent Gateway tidak dapat memvalidasi rantai sertifikat, koneksi akan gagal.
Peran dan izin yang diperlukan
Untuk mengonfigurasi konektivitas VPC untuk Gateway Agen, pastikan identitas yang digunakan untuk penyediaan dan agen layanan gateway memiliki peran yang diperlukan.
Deployment project mandiri
Dalam project mandiri tempat gateway, lampiran jaringan, dan jaringan VPC berada dalam project yang sama, izin Agent Gateway standar berlaku. Untuk mengetahui detailnya, lihat Izin yang diperlukan.
Jika Anda mengonfigurasi lampiran jaringan, identitas yang membuat atau memperbarui
template konektivitas gateway atau agen (akun pengguna atau akun layanan deployment Anda)
juga harus memiliki izin compute.networkAttachments.use
pada lampiran jaringan, misalnya melalui peran Compute Network
Admin (roles/compute.networkAdmin) pada project yang berisi
lampiran jaringan. Pengguna Jaringan Compute tidak memadai. Tanpa izin ini, permintaan akan gagal dengan error PERMISSION_DENIED yang menyebutkan lampiran jaringan.
Selain itu, jika Anda mengonfigurasi peering DNS, Agent Gateway
akan memvalidasi konfigurasi peering DNS (serta lampiran jaringan dan
subnetwork-nya) menggunakan agen layanan Agent Gateway
(service-AGENT_GATEWAY_PROJECT_NUMBER@gcp-sa-agentgateway.iam.gserviceaccount.com). Berikan peran berikut kepada agen layanan
pada project yang berisi jaringan VPC target, lampiran jaringan, dan zona DNS pribadi
(project Anda sendiri dalam deployment mandiri):
- Penampil Jaringan Compute (
roles/compute.networkViewer) - DNS Reader (
roles/dns.reader)
Peran ini tidak diberikan secara otomatis. Lampiran jaringan saja, tanpa peering DNS, tidak memerlukannya.
Tanpa peran ini, pembuatan atau pembaruan template konektivitas gateway atau agen yang mengonfigurasi peering DNS akan gagal divalidasi dengan error INVALID_ARGUMENT yang menyebutkan agen layanan dan peran yang tidak ada.
Deployment VPC bersama atau lintas project
Dalam deployment VPC Bersama, Anda dapat menyediakan Agent Gateway di project layanan atau project host. Jika Anda menyediakan gateway di project host (tempat jaringan VPC Bersama, subnet, dan lampiran jaringan juga berada), izin project mandiri akan berlaku.
Jika Anda menyediakan Agent Gateway di project layanan sementara jaringan VPC target, network attachment, atau zona DNS pribadi berada di project host (TARGET_VPC_PROJECT_ID), identitas di project layanan tidak otomatis memiliki izin untuk memvalidasi, melampirkan, atau melakukan peering dengan resource jaringan dan DNS di project host. Berikan peran berikut pada project host selain
izin Agent Gateway standar:
| Akun utama atau identitas | Pemberian izin di tingkat project | Peran IAM yang diperlukan | Tujuan |
|---|---|---|---|
| Identitas penyediaan1 (Akun pengguna atau akun layanan deployment) |
Project host (TARGET_VPC_PROJECT_ID) |
|
Memungkinkan identitas penyediaan melihat jaringan project host dan resource DNS pribadi, misalnya di konsol Google Cloud , mengelola endpoint regional, dan menggunakan lampiran jaringan. Agen layanan Agent Gateway, bukan identitas penyediaan, memvalidasi jaringan VPC target, subnet, lampiran jaringan, dan zona DNS pribadi selama pembuatan atau pembaruan gateway. |
| Pembuat lampiran jaringan (Administrator yang membuat lampiran PSC) |
Project host (TARGET_VPC_PROJECT_ID) |
|
Memungkinkan penggunaan subnet VPC Bersama di project host untuk membuat lampiran jaringan Private Service Connect. |
| Network attachment di project layanan (Direkomendasikan) | |||
| Agen Layanan Gateway Agen2 | Project host (TARGET_VPC_PROJECT_ID) |
|
Memungkinkan agen layanan Agent Gateway menggunakan subnet project host untuk lampiran jaringan, menghubungkan antarmuka Private Service Connect untuk merutekan traffic keluar, dan melakukan peering dengan zona Cloud DNS pribadi di project host, serta memungkinkan agen layanan memvalidasi jaringan VPC target, subnet, dan zona DNS pribadi selama pembuatan atau update gateway. |
| Agen Layanan Gateway Agen2 | Project layanan (AGENT_GATEWAY_PROJECT_ID) |
|
Memungkinkan agen layanan membaca lampiran jaringan, yang berada di project layanan, saat memvalidasi konfigurasi peering DNS selama pembuatan atau update gateway. Peran default agen layanan tidak menyertakan compute.. |
| Network attachment di project host | |||
| Agen Layanan Gateway Agen2 | Project host (TARGET_VPC_PROJECT_ID) |
|
Memungkinkan agen layanan Agent Gateway memperbarui lampiran jaringan project host untuk mengizinkan koneksi dari project tenant Agent Gateway, merutekan traffic keluar, dan melakukan peering dengan zona Cloud DNS pribadi di project host, serta memungkinkan agen layanan memvalidasi jaringan VPC target, subnet, lampiran jaringan, dan zona DNS pribadi selama pembuatan atau pembaruan gateway. |
1 Untuk identitas penyediaan, peran dasar level project seperti Viewer (roles/viewer) atau Editor (roles/editor) di project host juga sudah cukup.
2 Agen Layanan Agent Gateway diformat sebagai:
service-AGENT_GATEWAY_PROJECT_NUMBER@gcp-sa-agentgateway.iam.gserviceaccount.com, dengan
AGENT_GATEWAY_PROJECT_NUMBER adalah nomor project
dari project tempat Anda menyediakan Agent Gateway. Untuk deployment VPC Bersama, project ini dapat berupa project layanan atau project host.
Jika Anda menghubungkan beberapa project layanan Agent Runtime ke project host Agent Gateway, Anda juga harus memberikan akses lintas project pada project gateway ke setiap agen layanan Agent Runtime. Untuk deployment skala besar, lihat Menskalakan project layanan Agent Runtime dengan grup Google.
Mengonfigurasi konektivitas VPC
Untuk men-deploy Gateway Agen dengan template konektivitas, selesaikan langkah-langkah di bagian berikut.
Membuat lampiran jaringan Private Service Connect
Buat lampiran jaringan Private Service Connect di jaringan VPC target Anda.
Pastikan lampiran jaringan Anda memenuhi persyaratan berikut:
- Connection preference: Konfigurasikan lampiran jaringan untuk
menerima koneksi secara otomatis
(
--connection-preference=ACCEPT_AUTOMATIC). - Persyaratan jaringan VPC yang sama: Subnet lampiran jaringan dan jaringan target yang dikonfigurasi untuk peering DNS (
targetNetwork) harus berada di jaringan VPC yang sama persis. Jika subnet lampiran jaringan termasuk dalam jaringan yang berbeda dengan jaringan target peering DNS, validasi konfigurasi akan gagal. - Dukungan MTU jaringan VPC: Agent Gateway mendukung unit transmisi maksimum (MTU) hingga 1.500 byte untuk jaringan VPC yang berisi subnet lampiran jaringan. Jika jaringan VPC tersebut menggunakan MTU yang lebih besar, seperti jumbo frame, hubungi Cloud Customer Care untuk menyelaraskan layanan produsen Agent Gateway dengan MTU VPC kustom Anda.
- Persyaratan subnet: Perhatikan persyaratan berikut untuk subnet lampiran jaringan:
- Subnet range: Subnet lampiran jaringan mendukung semua rentang yang valid.
- Ukuran subnet: Agent Gateway memerlukan subnet minimum
/28untuk lampiran jaringan. Subnet/28menyediakan 12 alamat IP yang dapat digunakan, yang cukup untuk satu instance Agent Gateway. Jika Anda berencana menghubungkan beberapa gateway ke lampiran jaringan atau subnet yang sama, gunakan subnet yang lebih besar (seperti/26atau/24) untuk menghindari kehabisan alamat IP. - Persyaratan Akses Google Pribadi: Anda harus mengaktifkan
Akses Google Pribadi
(
private_ip_google_access = true) di subnet yang menghosting lampiran jaringan.
- Deployment VPC Bersama: Untuk deployment VPC Bersama, lihat Topologi deployment VPC Bersama.
Catat URI resource lengkap lampiran jaringan (misalnya,
projects/NETWORK_ATTACHMENT_PROJECT_NUMBER/regions/NETWORK_ATTACHMENT_REGION/networkAttachments/NETWORK_ATTACHMENT_NAME).
Anda akan memerlukannya saat membuat resource template konektivitas di langkah
selanjutnya.
Opsional: Menyiapkan peering DNS
Peering DNS memungkinkan Agent Gateway me-resolve nama DNS menggunakan data dari zona terkelola pribadi Cloud DNS di Jaringan VPC Anda.
Peering DNS hanya diperlukan jika agen Anda perlu me-resolve nama domain internal pribadi (seperti corp.internal.) atau menerapkan Kontrol Layanan VPC untuk Google API (googleapis.com.). Peering DNS tidak diperlukan untuk domain internet publik atau Google API standar tanpa Kontrol Layanan VPC.
Agent Gateway mendukung peering DNS transitif hanya hingga satu hop transitif, yang berarti maksimum tiga jaringan VPC. Misalnya, vpc-net-a (jaringan tenant Agent Gateway) dapat melakukan peering ke vpc-net-b (jaringan yang terpasang), yang kemudian melakukan peering ke vpc-net-c (jaringan jarak jauh) untuk menyelesaikan kueri DNS di seluruh rantai.
Untuk menyiapkan peering DNS, lakukan langkah-langkah berikut:
Siapkan zona DNS pribadi di jaringan VPC target Anda. Untuk menambahkan data DNS ke zona DNS pribadi Anda, lihat Menambahkan set data resource.
Kumpulkan informasi berikut untuk mengonfigurasi template konektivitas guna mengaktifkan peering:
URI jaringan target (
targetNetwork): Catat URI resource lengkap jaringan VPC target dalam format berikut:projects/TARGET_VPC_PROJECT_ID/global/networks/TARGET_VPC_NETWORK_NAME. Jaringan target selalu merupakan jaringan VPC yang berisi subnet yang direferensikan oleh lampiran jaringan. Jika jaringan target adalah jaringan VPC Bersama, pastikan untuk menggunakan ID project host VPC Bersama yang sesuai.Domain names: Satu atau beberapa akhiran domain untuk peering DNS. Setiap domain harus diakhiri dengan titik di akhir (
.) (misalnya,corp.internal.ataugoogleapis.com.).Untuk panduan tambahan tentang cara mengonfigurasi kolom
domains, lihat Pola domain peering DNS. Untuk deployment lintas project seperti VPC Bersama, lihat Persyaratan zona DNS dan peering lintas project.
Opsional: Menyiapkan konfigurasi kepercayaan TLS
Jika tujuan target Anda menggunakan CA pribadi atau sertifikat yang ditandatangani sendiri, Anda harus membuat resource TrustConfig di Certificate Manager.
Resource TrustConfig menentukan trust anchor dan sertifikat yang digunakan Agent Gateway untuk memvalidasi koneksi TLS.
Siapkan file sertifikat Anda dalam format PEM:
- Trust store: Sertifikat CA root atau perantara dalam format PEM. Agent Gateway memercayai sertifikat server apa pun yang rantai kepercayaannya mengarah ke salah satu sertifikat CA ini. Trust store harus berisi minimal satu sertifikat CA root atau perantara.
- Sertifikat yang diizinkan (Opsional): Sertifikat server dalam format PEM yang ingin Anda percayai secara eksplisit, seperti sertifikat yang ditandatangani sendiri.
Jalankan perintah berikut untuk membuat resource
TrustConfig.TrustConfigharus dibuat di project dan region yang sama dengan Gateway Agen dan template konektivitas.gcloud certificate-manager trust-configs create TRUST_CONFIG_NAME \ --location=LOCATION \ --trust-store="trust-anchors=ROOT_CERT_FILE" \ --allowlisted-certificates=ALLOWLISTED_CERT_FILEGanti kode berikut:
TRUST_CONFIG_NAME: Nama untuk resourceTrustConfig.LOCATION: Region untuk konfigurasi kepercayaan (misalnya,europe-west1). Region ini harus sama dengan Agent Gateway dan template konektivitas.ROOT_CERT_FILE: Jalur ke sertifikat CA root atau perantara yang dienkode PEM.ALLOWLISTED_CERT_FILE: (Opsional) Jalur ke sertifikat berenkode PEM yang ingin Anda percayai secara eksplisit. Jika Anda tidak menggunakan sertifikat yang diizinkan, hapus flag ini.
Untuk mengetahui informasi selengkapnya tentang cara mengelola konfigurasi kepercayaan, lihat Membuat dan mengelola konfigurasi kepercayaan.
Men-deploy Agent Gateway
Buat file konfigurasi template konektivitas:
Buat file YAML bernama
agw-connectivity-template.yaml:name: projects/AGENT_GATEWAY_PROJECT_NUMBER/locations/LOCATION/agentConnectivityTemplates/CONNECTIVITY_TEMPLATE_NAME accessPath: AGENT_TO_ANYWHERE deploymentModel: CENTRALIZED egressNetworkConfig: networkAttachment: projects/NETWORK_ATTACHMENT_PROJECT_NUMBER/regions/NETWORK_ATTACHMENT_REGION/networkAttachments/NETWORK_ATTACHMENT_NAME dnsPeeringConfig: domains: - DOMAIN_NAME targetNetwork: projects/TARGET_VPC_PROJECT_ID/global/networks/TARGET_VPC_NETWORK_NAME vpcEgress: VPC_EGRESS_MODE tlsConfig: trustConfig: projects/AGENT_GATEWAY_PROJECT_NUMBER/locations/LOCATION/trustConfigs/TRUST_CONFIG_NAME additionalRoots: ADDITIONAL_ROOTS_OPTIONGanti kode berikut:
AGENT_GATEWAY_PROJECT_NUMBER: Nomor project dari project Google Cloud tempat Anda menyediakan Agent Gateway. Untuk mengambil nomor project Anda, jalankan:gcloud projects describe PROJECT_ID --format="value(projectNumber)".LOCATION: Region untuk template konektivitas (misalnya,europe-west1).CONNECTIVITY_TEMPLATE_NAME: Nama resource template konektivitas.accessPath: Jalur akses yang diatur untuk template konektivitas. Tetapkan keAGENT_TO_ANYWHERE(template konektivitas hanya didukung untuk gateway egress).deploymentModel: Model deployment untuk gateway. Tetapkan keCENTRALIZED.networkAttachment: URI resource lengkap dari lampiran jaringan Private Service Connect:NETWORK_ATTACHMENT_PROJECT_NUMBER: Nomor project dari project tempat Anda membuat lampiran jaringan. Project ini mungkin sama dengan project Gateway Agen, atau project yang berbeda jika Anda menyediakan Gateway Agen di project layanan VPC Bersama dan membuat lampiran jaringan di project host VPC Bersama.NETWORK_ATTACHMENT_REGION: Region yang berisi lampiran jaringan.NETWORK_ATTACHMENT_NAME: Nama lampiran jaringan.
DOMAIN_NAME: (Opsional) Satu atau beberapa akhiran domain untuk peering DNS (misalnya,corp.internal.,googleapis.com., atau.). Tambahkan item daftar di bagiandomainsuntuk setiap akhiran domain yang ingin Anda peering. Setiap nilai harus diakhiri dengan titik di akhir (.) dan memiliki zona terkelola Cloud DNS pribadi yang sesuai dan diizinkan untuk jaringan target.Untuk panduan tambahan tentang cara mengonfigurasi kolom
domains, lihat Pola domain peering DNS.targetNetwork: (Opsional) URI resource lengkap jaringan VPC target untuk peering DNS. Jaringan target selalu merupakan jaringan VPC yang berisi subnet yang direferensikan oleh lampiran jaringan:TARGET_VPC_PROJECT_ID: Project ID dari project yang memiliki jaringan VPC target. Jika jaringan yang berisi subnet yang direferensikan oleh lampiran jaringan adalah jaringan VPC Bersama,TARGET_VPC_PROJECT_IDadalah ID project host VPC Bersama. Selalu tentukantargetNetworkmenggunakan project ID, bukan nomor project.TARGET_VPC_NETWORK_NAME: Nama jaringan VPC target.
VPC_EGRESS_MODE: Tetapkan mode pemilihan rute egress. Tetapkan kePRIVATE_RANGES_ONLYatauALL_TRAFFIC.tlsConfig: (Opsional) Konfigurasi TLS untuk validasi sertifikat server saat terhubung ke endpoint pribadi melalui HTTPS:TRUST_CONFIG_NAME: Nama resourceTrustConfigCertificate Manager yang berisi sertifikat CA pribadi atau trust anchor Anda.ADDITIONAL_ROOTS_OPTION: Menentukan apakah akan memercayai root CA yang dipercaya secara publik selain konfigurasi kepercayaan kustom Anda:- Tetapkan ke
PUBLICLY_TRUSTED_ROOTS(default) untuk memercayai sertifikat yang divalidasi oleh parametertrustConfigdan semua CA yang dipercaya publik. Anda harus menetapkanadditionalRootskePUBLICLY_TRUSTED_ROOTSjika agen Anda juga terhubung ke APIGoogle Cloud (*.googleapis.com) atau endpoint HTTPS publik lainnya; tanpa setelan ini, Agent Gateway tidak akan memercayai sertifikat yang ditandatangani Google untukgoogleapis.com. - Tetapkan ke
NO_ADDITIONAL_ROOTSuntuk hanya memercayai sertifikat yang divalidasi oleh parametertrustConfig.
Buat template konektivitas:
Jalankan perintah berikut untuk membuat template konektivitas:
gcloud network-services agent-connectivity-templates import CONNECTIVITY_TEMPLATE_NAME \ --source="agw-connectivity-template.yaml" \ --location=LOCATIONGanti kode berikut:
CONNECTIVITY_TEMPLATE_NAME: Nama resource template konektivitas.LOCATION: Lokasi tempat Anda ingin membuat resource template konektivitas. Contoh,europe-west1.
Tentukan resource Agent Gateway:
Tentukan resource Agent Gateway baru dalam mode
AGENT_TO_ANYWHEREdengan membuat file konfigurasi YAML gateway (misalnya,my-agent-gateway-vpc-egress.yaml) yang mereferensikan template konektivitas:name: AGENT_GATEWAY_NAME protocols: - MCP googleManaged: governedAccessPath: AGENT_TO_ANYWHERE agentConnectivityTemplate: projects/AGENT_GATEWAY_PROJECT_NUMBER/locations/LOCATION/agentConnectivityTemplates/CONNECTIVITY_TEMPLATE_NAME registries: - AGENT_REGISTRY_PATHGanti kode berikut:
AGENT_GATEWAY_NAME: Nama resource Agent Gateway.AGENT_GATEWAY_PROJECT_NUMBER: Nomor project dari project Google Cloud tempat Anda menyediakan Agent Gateway dan template konektivitas. Untuk deployment VPC Bersama, project ini dapat berupa project layanan atau project host. Untuk mengambil nomor project Anda, jalankan:gcloud projects describe PROJECT_ID --format="value(projectNumber)".LOCATION: Lokasi template konektivitas (misalnya,europe-west1).CONNECTIVITY_TEMPLATE_NAME: Nama resource template konektivitas.AGENT_REGISTRY_PATH: Jalur ke instance Agent Registry regional di project dan region yang sama dengan gateway, yang diformat sebagai//agentregistry.googleapis.com/projects/PROJECT_ID/locations/LOCATION. Untuk panduan, lihat Merencanakan deployment Gateway Agen.
Mengimpor dan men-deploy Agent Gateway:
Jalankan perintah berikut untuk membuat resource Agent Gateway berdasarkan spesifikasi YAML:
gcloud network-services agent-gateways import AGENT_GATEWAY_NAME \ --source="my-agent-gateway-vpc-egress.yaml" \ --location=LOCATIONGanti
LOCATIONdengan lokasi tempat Anda ingin membuat resource Gateway Agen. Contoh,europe-west1.
Pertimbangan arsitektur dan jaringan
Bagian ini memberikan panduan arsitektur dan pola jaringan lanjutan untuk men-deploy Gateway Agen dengan konektivitas VPC.
Memperbarui setelan egress VPC
Template konektivitas tidak dapat diubah di tempat saat direferensikan oleh Gateway Agen, dan Gateway Agen tidak secara otomatis mengambil perubahan yang dilakukan pada template konektivitas yang dilampirkan:
Memperbarui peering DNS, mode egress VPC, atau setelan TLS (
tlsConfig): Pada template konektivitas, kolomtlsConfig.trustConfigtidak dapat diubah setelah dikonfigurasi, dan update langsung padatlsConfig(seperti menambahkan atau mengubahadditionalRoots) tidak akan diambil oleh Agent Gateway yang terpasang. Untuk memperbarui konfigurasi peering DNS, mode egress VPC, atau setelantlsConfigdi gateway yang ada, buat template konektivitas baru yang menggunakannetworkAttachmentyang sama dengan setelan yang diperbarui, dan perbarui Agent Gateway untuk merujuk ke template baru (atau batalkan binding dan ikat kembali template konektivitas).Mengubah lampiran jaringan:
networkAttachmentitu sendiri tidak dapat diubah setelah dikonfigurasi pada template konektivitas dan Gateway Agen. Untuk beralih ke lampiran jaringan yang berbeda (atau jaringan VPC target), Anda harus membuat template konektivitas baru dan Gateway Agen baru.
Topologi deployment VPC Bersama
Dalam arsitektur VPC Bersama, Anda dapat menyediakan Agent Gateway di project layanan atau project host. Saat menyediakan Agent Gateway di project layanan, Anda dapat membuat network attachment di project layanan (direkomendasikan) atau project host:
- Direkomendasikan: Network attachment di project layanan:
- Buat subnet di project host.
- Buat lampiran jaringan di project layanan, dengan merujuk ke subnet project host.
- Network attachment di project host:
- Buat subnet di project host.
- Buat lampiran jaringan di project host.
Kepatuhan Kontrol Layanan VPC
Untuk menerapkan perimeter Kontrol Layanan VPC untuk komunikasi agen, pastikan hal berikut:
Tetapkan
vpcEgresskeALL_TRAFFICdi template konektivitas Anda.Arahkan permintaan API Google ke rentang IP
restricted.googleapis.com(199.36.153.4/30) atau ke endpoint Private Service Connect internal untuk Google API.Konfigurasikan resolusi DNS untuk
googleapis.com. Buat zona Cloud DNS pribadi di jaringan VPC Anda yang memetakan*.googleapis.comkerestricted.googleapis.com, dan sertakangoogleapis.com.di kolomdomainspada template konektivitas Anda.Untuk mengetahui detail selengkapnya tentang konfigurasi DNS, lihat Mengonfigurasi DNS untuk googleapis.com dalam dokumentasi Akses Google Pribadi.
Untuk deployment VPC Bersama, project host yang memiliki subnet lampiran jaringan dan
dnsPeeringConfig.targetNetworkharus berada dalam perimeter layanan yang sama dengan project tempat Anda men-deploy Gateway Agen. Hal ini berlaku bahkan saat Anda membuat lampiran jaringan di project layanan, karena subnet dan jaringan VPC masih menjadi milik project host. Jika zona DNS pribadi Anda dihosting di project DNS terpisah, sertakan juga project tersebut dalam perimeter.
Pola domain peering DNS
Bagian ini menjelaskan pola dan opsi resolusi domain untuk mengonfigurasi kolom domains dalam template konektivitas.
Konfigurasi nama domain: Konfigurasikan kolom domains di template konektivitas berdasarkan pertimbangan berikut:
Domain internal pribadi: Untuk me-resolve layanan internal pribadi yang dihosting di jaringan VPC Anda (misalnya,
service.corp.internal), tentukan akhiran domain internal Anda (seperticorp.internal.). Zona terkelola Cloud DNS pribadi yang cocok persis untuk domain ini harus diizinkan untuk jaringan VPC target.DNS split-horizon (Domain publik dengan IP RFC 1918): Jika Anda menggunakan zona DNS publik untuk menghosting data yang mengarah ke IP pribadi internal (seperti
mcp.example.comyang me-resolve ke alamat RFC 1918 untuk sertifikat publik Certificate Manager), gateway akan me-resolve data ini secara otomatis menggunakan DNS rekursif publik tanpa memerlukan peering DNS.Google Cloud API dengan Kontrol Layanan VPC: Jika
ALL_TRAFFICdikonfigurasi untuk menerapkan Kontrol Layanan VPC, permintaan Google API harus di-resolve ke rentang IPrestricted.googleapis.com(199.36.153.4/30) atau ke endpoint PSC internal. Buat zona Cloud DNS pribadi di jaringan VPC Anda yang memetakan*.googleapis.comkerestricted.googleapis.com, dan sertakangoogleapis.com.di kolomdomainspada template konektivitas Anda.Pola resolusi multi-domain: Jika deployment Anda memerlukan penyelesaian beberapa akhiran domain pribadi, pilih salah satu pola berikut:
- Melakukan peering beberapa domain individual: Tentukan daftar akhiran domain
di kolom
domainsdaridnsPeeringConfig(misalnya,corp.internal.,prod.internal., dangoogleapis.com.). Setiap domain dalam daftar harus diakhiri dengan titik di bagian akhir (.) dan memiliki zona terkelola Cloud DNS pribadi yang sesuai dan diizinkan untuk jaringan VPC target. - Akhiran induk gabungan (Direkomendasikan): Gabungkan layanan internal di bawah akhiran domain induk bersama (seperti
*.internal.atau*.corp.internal.) dan sertakan domain induk tersebut dalam daftardomains. Peering root menyeluruh dengan Zona Penerusan Pribadi: Sertakan
"."di kolomdomainstemplate konektivitas, dan konfigurasikan Zona Penerusan Pribadi Cloud DNS untuk domain root (.) di jaringan VPC Anda yang mengarah ke resolver rekursif upstream (seperti8.8.8.8atau resolver perusahaan internal). Zona pribadi yang lebih spesifik di VPC Anda dicocokkan terlebih dahulu berdasarkan pencocokan akhiran terpanjang, sedangkan kueri publik yang tidak cocok di-resolve melalui forwarder upstream.
- Melakukan peering beberapa domain individual: Tentukan daftar akhiran domain
di kolom
Persyaratan peering dan zona DNS lintas project
Setelan dnsPeeringConfig template konektivitas tidak mendukung peering DNS Cloud lintas project langsung. Saat Anda mengimpor template konektivitas,
validasi akan gagal jika subnet yang direferensikan oleh networkAttachment termasuk dalam
jaringan VPC yang berbeda dengan targetNetwork, atau jika Anda mengandalkan
binding zona DNS lintas project dari layanan atau project eksternal.
Zona terkelola untuk domain harus dibuat di project host yang memiliki targetNetwork. Zona terkelola dapat berupa salah satu jenis zona berikut:
- Zona pribadi yang kredibel
- Zona penerusan
- Zona peering Cloud DNS: Harus dikaitkan dengan jaringan VPC project host dan menargetkan jaringan VPC tujuan. VPC tujuan harus me-resolve kueri secara langsung menggunakan zona pribadi yang kredibel. Meneruskan kueri ke zona peering DNS lain (perantaian) tidak didukung dan akan menghasilkan error
NXDOMAIN.
Menskalakan project layanan Agent Runtime dengan grup Google
Jika Anda menghubungkan beberapa project layanan Agent Runtime ke project host Agent Gateway dan memberikan akses lintas project ke setiap agen layanan satu per satu, Anda harus memperbarui kebijakan IAM project host setiap kali menambahkan project. Dalam deployment berskala besar, Anda mungkin juga mencapai batas kebijakan IAM saat menambahkan binding peran.
Agar tidak perlu memperbarui kebijakan IAM project host untuk setiap project layanan baru, Anda dapat mengelola akses melalui satu grup keamanan Google:
Buat grup keamanan: Buat grup keamanan di konsol Google Admin atau dengan menjalankan perintah
gcloud identity groups create.Beri grup akses ke project host Agent Gateway: Ikat grup ke peran Network Services Viewer (
roles/networkservices.viewer) diAGENT_GATEWAY_PROJECT_ID:gcloud projects add-iam-policy-binding AGENT_GATEWAY_PROJECT_ID \ --member="group:GROUP_EMAIL" \ --role="roles/networkservices.viewer"Ganti kode berikut:
AGENT_GATEWAY_PROJECT_ID: Project ID dari project host Agent Gateway.GROUP_EMAIL: Alamat email grup keamanan Anda (misalnya,agw-cross-project-runtime@example.com).
Tambahkan agen layanan Agent Runtime setiap project layanan ke grup: Untuk setiap project layanan Agent Runtime, tambahkan agen layanannya ke grup keamanan dengan menjalankan perintah
gcloud identity groups memberships addsebagai berikut:gcloud identity groups memberships add \ --group-email="GROUP_EMAIL" \ --member-email="service-AGENT_RUNTIME_PROJECT_NUMBER@gcp-sa-aiplatform.iam.gserviceaccount.com"Ganti
AGENT_RUNTIME_PROJECT_NUMBERdengan nomor project dari project layanan Agent Runtime.
Langkah berikutnya
Merutekan traffic Agent Runtime melalui Agent Gateway
Pelajari cara merutekan traffic Agent Runtime melalui Agent Gateway untuk konektivitas yang aman dan diatur.
Codelab: Mengelola workload agentic dengan Agent Platform
Pelajari cara mengelola workload agentic dengan Agent Gateway di Gemini Enterprise Agent Platform.
Codelab: Egress Agent Gateway dari Agent Runtime ke jaringan VPC
Pelajari tata kelola egress Agent Gateway untuk agen AI yang mengakses tujuan di jaringan VPC.
Mendelegasikan otorisasi untuk Agent Gateway
Pelajari cara mendelegasikan otorisasi untuk Agent Gateway ke IAP, Model Armor, atau layanan otorisasi kustom Anda sendiri.
Mengelola Agent Gateway
Pelajari cara melihat, memperbarui, membatalkan pengaitan, dan menghapus resource Agent Gateway.
Merutekan traffic Gemini Enterprise melalui Agent Gateway
Pelajari cara merutekan traffic Gemini Enterprise melalui Agent Gateway.