Mulai menggunakan API Gateway dan hub API

Tutorial ini menunjukkan cara menghubungkan Gateway API dengan hub API untuk memungkinkan publikasi metadata API yang lancar dari project Gateway API Anda ke hub API.

Dalam tutorial ini, Anda akan menggunakan konsol Google Cloud .

Daftar Tugas

Gunakan daftar tugas berikut saat Anda mengerjakan tutorial. Semua tugas diperlukan untuk menghubungkan Gateway API dengan hub API.

1. Lakukan langkah-langkah prasyarat yang dijelaskan dalam Sebelum Anda memulai.

2. Men-deploy API ke Gateway API.

3. Hubungkan project Gateway API Anda ke hub API.

4. Melihat API Gateway API Anda di hub API.

5. Melihat Gateway MCP Anda di hub API.

6. Hindari menimbulkan biaya pada akun Google Cloud Anda. Lihat Pembersihan.

Sebelum memulai

Sebelum memulai, pastikan Anda telah menyelesaikan langkah-langkah prasyarat berikut:

1. Siapkan Gateway API di project Anda.

2. Siapkan hub API di project host Anda.

Menyiapkan Gateway API di project Anda

Untuk menyiapkan Gateway API di project Anda, lakukan hal berikut:

1. Di konsol Google Cloud , buka halaman Gateway API.

   Buka Gateway API

   Catatan: Jika Anda tidak berencana untuk menyimpan resource yang Anda buat dalam tutorial ini, buat project baru, bukan memilih project yang ada. Setelah menyelesaikan langkah-langkah ini, Anda dapat menghapus project, yang menghapus semua resource yang terkait dengan project tersebut.

2. Gateway API mengharuskan Anda mengaktifkan layanan Google berikut:

   Nama	Judul
   apigateway.googleapis.com	API Gateway API
   servicemanagement.googleapis.com	Service Management API
   servicecontrol.googleapis.com	Service Control API

   Jika Anda belum pernah mengaktifkan layanan ini untuk project yang Anda pilih, Anda akan diminta untuk melakukannya.

3. Konfirmasi bahwa penagihan diaktifkan untuk project Anda.

   Pelajari cara mengaktifkan penagihan

Menyiapkan hub API di project host

1. Buat atau pilih project Google Cloud untuk digunakan sebagai project host Anda.

   Project host adalah project Google Cloud di organisasi Google Cloud Anda yang Anda tetapkan sebagai project konsumen untuk semua resource hub API. Satu instance hub API dapat disediakan per project host.

   Untuk menyediakan penemuan API terpusat di semua API Gateway, sebaiknya gunakan satu project host khusus untuk instance hub API dan lampirkan beberapa project API Gateway, yang disebut sebagai project runtime, ke instance hub API.

   Jika instance hub API sudah disediakan di organisasi atau folder Google Cloud Anda, sebaiknya lewati langkah ini dan lampirkan project API Gateway ke instance hub API yang ada.

2. Berikan peran Identity and Access Management (IAM) yang diperlukan untuk menghubungkan Gateway API dengan hub API.

3. Sediakan hub API di project host Anda.

Men-deploy API ke Gateway API

Selesaikan panduan memulai Gateway API untuk men-deploy layanan Cloud Run "hello world" dan membuat gateway yang mengarah ke layanan tersebut.

Misalnya, API helloworld di-deploy ke API Gateway helloworld-gateway, seperti yang ditunjukkan di halaman Gateways di konsol Google Cloud .

Lampirkan project API Gateway Anda ke hub API

Untuk melampirkan project Gateway API ke hub API, lakukan hal berikut:

1. Di konsol Google Cloud , buka halaman API hub.

   Buka hub API

2. Pilih project host hub API Anda di menu drop-down.
3. Klik Setelan dari menu navigasi kiri untuk membuka halaman Setelan.
4. Buka tab Pengaitan project.
5. Klik Attach runtime project.
   Tindakan ini akan menampilkan panel Select a resource.
6. Klik project Google Cloud tempat Gateway API disediakan.
7. Di panel Project association settings, pilih Gateway API dan aset API lainnya yang ingin Anda impor secara otomatis.
8. Klik Simpan.

Project runtime Anda dilampirkan dan ditampilkan dalam daftar project runtime yang dilampirkan di konsol Google Cloud .

Contoh:

Untuk mengaktifkan penyerapan data real-time, hub API membuat instance plugin Gateway API untuk project runtime terlampir saat Anda memilih untuk mengimpor aset Gateway API. Anda dapat melihat instance plugin ini di kolom Plugin terkait pada halaman Pengaitan project.

Melihat API Gateway API Anda di hub API

Untuk melihat API Gateway API Anda di hub API, lakukan hal berikut:

1. Di konsol Google Cloud , buka halaman APIs di API hub.

   Buka hub API

2. Temukan API "hello world" yang Anda deploy ke Gateway API.

   Jika perlu, pilih Gateway: API Gateway di drop-down Filter untuk menampilkan hanya API Gateway API.

   Contoh:

   

3. Klik API untuk melihat detail selengkapnya, termasuk metadata API.

Melihat Gateway MCP Anda di hub API

Jika API Gateway API Anda dikonfigurasi sebagai server Model Context Protocol (MCP), hub API akan menambahkan entri kedua untuknya, yang diberi nama <your-api> (MCP). Lihat Penemuan melalui hub API dan Agent Registry di ringkasan MCP.

Hanya gateway yang mengaktifkan MCP yang akan menampilkan entri tambahan ini di hub API.

Untuk melihat detail Gateway MCP di hub API:

1. Di konsol Google Cloud , buka halaman APIs di API hub.
2. Temukan entri bernama <your-api> (MCP).
3. Klik API untuk melihat detailnya, termasuk metadata dan alat khusus MCP.

Misalnya, API helloworld (MCP) ditampilkan bersama API helloworld standar di hub API:

Anda juga dapat melihat server MCP ini di Agent Registry. Agen dapat menemukan server dan alatnya melalui katalog secara otomatis.

Misalnya, server MCP ditampilkan di tab MCP Servers di Agent Registry:

Pembersihan

Agar akun Google Cloud Anda tidak dikenai biaya untuk resource yang digunakan dalam tutorial ini, Anda dapat:

• Menghapus gateway Anda
• Menghapus API Anda

Atau, Anda juga dapat menghapus Google Cloud project yang digunakan untuk tutorial ini.

Langkah berikutnya

• Pelajari lebih lanjut Gateway API
• Pelajari lebih lanjut cara memusatkan API menggunakan hub API