Panduan memulai API Gateway dan Cloud Run
Halaman ini menunjukkan cara menyiapkan API Gateway untuk mengelola dan mengamankan layanan backend Cloud Run.
Daftar Tugas
Gunakan daftar tugas berikut saat Anda mengerjakan tutorial ini. Semua tugas diperlukan untuk men-deploy API Gateway untuk layanan backend Cloud Run Anda.
- Buat atau pilih project Google Cloud .
- Jika Anda belum men-deploy Cloud Run sendiri, deploy layanan contoh. Lihat langkah 7 di Sebelum memulai.
- Aktifkan layanan API Gateway yang diperlukan.
- Buat spesifikasi OpenAPI yang menjelaskan API Anda, dan konfigurasikan rute ke layanan backend Cloud Run Anda. Lihat Membuat konfigurasi API.
- Deploy API gateway menggunakan konfigurasi API Anda. Lihat Men-deploy API gateway.
- Melacak aktivitas ke layanan Anda. Lihat Melacak aktivitas API.
- Hindari tagihan ke akun Google Cloud Anda. Lihat Pembersihan.
Sebelum memulai
Di konsol Google Cloud, buka halaman Dasbor, lalu pilih atau buat project Google Cloud .
Pastikan penagihan diaktifkan untuk project Anda.
Catat project ID yang ingin Anda gunakan untuk tutorial ini. Di bagian lain halaman ini, project ID ini disebut sebagai PROJECT_ID.
Download dan instal Google Cloud CLI.
Perbarui komponen
gcloud
:gcloud components update
Tetapkan project default. Ganti PROJECT_ID dengan Google Cloud project ID Anda
gcloud config set project PROJECT_ID
Jika Anda belum men-deploy layanan Cloud Run sendiri, ikuti langkah-langkah di Mulai Cepat: Men-deploy Container Contoh Bawaan untuk memilih atau membuat project Google Cloud dan men-deploy backend contoh. Catat URL aplikasi, serta region dan project ID tempat aplikasi Anda di-deploy.
Mengaktifkan layanan yang diperlukan
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 |
Untuk mengonfirmasi bahwa layanan yang diperlukan telah diaktifkan:
gcloud services list
Jika Anda tidak melihat layanan yang diperlukan tercantum, aktifkan layanan tersebut:
gcloud services enable apigateway.googleapis.comgcloud services enable servicemanagement.googleapis.com
gcloud services enable servicecontrol.googleapis.com
Untuk mengetahui informasi selengkapnya tentang layanan gcloud
, lihat
layanan gcloud
.
Membuat konfigurasi API
Sebelum dapat digunakan untuk mengelola traffic ke backend Cloud Run yang di-deploy, API Gateway memerlukan konfigurasi API.
Anda dapat membuat konfigurasi API menggunakan spesifikasi OpenAPI yang berisi anotasi khusus untuk menentukan perilaku API Gateway yang dipilih. Anda harus menambahkan kolom khusus Google yang berisi URL untuk setiap aplikasi Cloud Run sehingga API Gateway memiliki informasi yang diperlukan untuk memanggil aplikasi.
- Buat file teks bernama
openapi2-run.yaml
. (Untuk memudahkan, halaman ini merujuk ke spesifikasi OpenAPI berdasarkan nama file tersebut, tetapi Anda dapat memberinya nama lain jika mau.) - Cantumkan setiap aplikasi Anda di bagian
paths
fileopenapi2-run.yaml
, seperti yang ditunjukkan dalam contoh berikut:# openapi2-run.yaml swagger: '2.0' info: title: API_ID optional-string description: Sample API on API Gateway with a Cloud Run backend version: 1.0.0 schemes: - https produces: - application/json x-google-backend: address: APP_URL paths: /assets/{asset}: get: parameters: - in: path name: asset type: string required: true description: Name of the asset. summary: Assets operationId: getAsset responses: '200': description: A successful response schema: type: string /hello: get: summary: Cloud Run hello world operationId: hello responses: '200': description: A successful response schema: type: string
- Di kolom
title
, ganti API_ID dengan nama API Anda dan ganti optional-string dengan deskripsi singkat pilihan Anda. Jika API Anda belum ada, perintah untuk membuat Konfigurasi API juga akan membuat API dengan nama yang Anda tentukan. Nilai kolomtitle
digunakan saat membuat kunci API yang memberikan akses ke API ini. Lihat Persyaratan ID API untuk mengetahui pedoman penamaan API. - Di kolom
address
di bagianx-google-backend
, ganti APP_URL dengan URL sebenarnya dari layanan Cloud Run Anda (jalur lengkap API yang dipanggil). Misalnya:https://hello-abc1def2gh-uc.a.run.app
. - Masukkan perintah berikut, dengan:
- CONFIG_ID menentukan nama konfigurasi API Anda.
- API_ID menentukan nama API Anda. Jika API belum ada, perintah ini akan membuatnya.
- PROJECT_ID menentukan nama project Google Cloud Anda.
- SERVICE_ACCOUNT_EMAIL menentukan akun layanan yang digunakan untuk menandatangani token untuk backend dengan autentikasi yang dikonfigurasi. Untuk mengetahui informasi selengkapnya, lihat Membuat akun layanan.
gcloud api-gateway api-configs create CONFIG_ID \ --api=API_ID --openapi-spec=openapi2-run.yaml \ --project=PROJECT_ID --backend-auth-service-account=SERVICE_ACCOUNT_EMAIL
Operasi ini mungkin memerlukan waktu beberapa menit hingga selesai karena konfigurasi API disebarkan ke sistem downstream. Pembuatan konfigurasi API yang kompleks dapat memerlukan waktu hingga sepuluh menit untuk selesai.
- Setelah konfigurasi API dibuat, Anda dapat melihat detailnya dengan menjalankan perintah ini:
gcloud api-gateway api-configs describe CONFIG_ID \ --api=API_ID --project=PROJECT_ID
Men-deploy gateway API
Sekarang Anda dapat men-deploy API di API Gateway. Men-deploy API di API Gateway juga menentukan URL eksternal yang dapat digunakan klien API untuk mengakses API Anda.
Jalankan perintah berikut untuk men-deploy konfigurasi API yang baru saja Anda buat ke API Gateway:
gcloud api-gateway gateways create GATEWAY_ID \ --api=API_ID --api-config=CONFIG_ID \ --location=GCP_REGION --project=PROJECT_ID
dengan:
- GATEWAY_ID menentukan nama gateway.
- API_ID menentukan nama API Gateway API yang terkait dengan gateway ini.
- CONFIG_ID menentukan nama konfigurasi API yang di-deploy ke gateway.
GCP_REGION adalah Google Cloud region untuk gateway yang di-deploy.
PROJECT_ID menentukan nama project Google Cloud Anda.
Setelah berhasil diselesaikan, Anda dapat menggunakan perintah berikut untuk melihat detail tentang gateway:
gcloud api-gateway gateways describe GATEWAY_ID \ --location=GCP_REGION --project=PROJECT_ID
Perhatikan nilai properti defaultHostname
dalam output perintah ini. Ini adalah bagian nama host dari URL gateway yang Anda gunakan untuk menguji deployment di langkah berikutnya.
Menguji deployment API
Sekarang Anda dapat mengirim permintaan ke API menggunakan URL yang dibuat saat gateway di-deploy.
Masukkan URL berikut di browser web Anda, dengan:
- DEFAULT_HOSTNAME menentukan bagian nama host dari URL gateway yang di-deploy.
hello
adalah jalur yang ditentukan dalam konfigurasi API Anda.
https://DEFAULT_HOSTNAME/hello
Contoh:
https://my-gateway-a12bcd345e67f89g0h.uc.gateway.dev/hello
Anda akan melihat container Cloud Run menjalankan aplikasi di browser.
Berhasil! Gateway Anda mengelola akses ke layanan backend Cloud Run.
Melacak aktivitas API
Lihat grafik aktivitas untuk API Anda di halaman API Gateway di konsol Google Cloud. Klik API Anda untuk melihat grafik aktivitasnya di halaman Ringkasan. Mungkin perlu waktu beberapa saat hingga permintaan ditampilkan dalam grafik.
Lihat log permintaan untuk API Anda di halaman Logs Explorer. Link ke halaman Logs Explorer dapat ditemukan di halaman API Gateway di konsol Google Cloud.
Setelah berada di halaman API Gateway:
- Pilih API yang akan dilihat.
- Klik tab Detail.
- Klik link di bagian Logs.
Pembersihan
Agar tidak menimbulkan tagihan pada akun Google Cloud Anda untuk resource yang digunakan dalam panduan memulai ini, Anda dapat:
Atau, Anda juga dapat menghapus project Google Cloud yang digunakan untuk tutorial ini.