Mulai menggunakan API Gateway dan hub API

Tutorial ini menunjukkan cara menghubungkan API Gateway dengan hub API untuk memungkinkan publikasi metadata API yang lancar dari project API Gateway 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. Lampirkan project API Gateway Anda ke hub API.

4. Melihat API Gateway API Anda di hub API.

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

Sebelum memulai

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

1. Siapkan API Gateway di project Anda.

2. Siapkan hub API di project host Anda.

Menyiapkan API Gateway di project Anda

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

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

   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 akan menghapus semua resource yang terkait dengan project tersebut.

2. API Gateway 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 Anda

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 ditetapkan 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 API Gateway dengan hub API.

3. Sediakan hub API di project host Anda.

Men-deploy API ke API Gateway

Selesaikan panduan memulai API Gateway 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 .

Melampirkan project API Gateway ke hub API

Untuk melampirkan project API Gateway 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 API Gateway disediakan.
7. Di panel Project association settings, pilih API Gateway 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 API Gateway untuk project runtime terlampir saat Anda memilih untuk mengimpor aset API Gateway. Anda dapat melihat instance plugin ini di kolom Plugin terkait di halaman Kaitan 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 API Gateway.

   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.

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 API Gateway
• Pelajari lebih lanjut cara memusatkan API menggunakan hub API