API Gateway：Akses aplikasi di ACK menggunakan API HTTP

Prasyarat

1. Kluster ACK telah dibuat. Untuk informasi lebih lanjut, lihat Buat kluster ACK yang dikelola.

2. Demo layanan mikro telah diterapkan ke ACK.

   Terapkan demo layanan mikro

   Masuk ke Konsol ACK. Di panel navigasi kiri, pilih Clusters.

   Di halaman Clusters, klik kluster yang ingin Anda kelola. Di pohon navigasi kiri halaman detail kluster, pilih Workloads > Deployments.

   Di halaman Penyebaran, klik Create from YAML. Di bidang Template, masukkan kode berikut dalam format YAML untuk membuat deployment bernama httpbin dan service bernama httpbin.

   apiVersion: apps/v1
   kind: Deployment
   metadata:
     name: httpbin
     namespace: default
   spec:
     replicas: 1
     selector:
       matchLabels:
         app: httpbin
     template:
       metadata:
         labels:
           app: httpbin
           version: v1
       spec:
         containers:
           - image: registry.cn-hangzhou.aliyuncs.com/mse-ingress/go-httpbin
             args:
               - "--version=v1"
             imagePullPolicy: Always
             name: httpbin
   ---
   apiVersion: v1
   kind: Service
   metadata:
     name: httpbin
     namespace: default
   spec:
     ports:
       - port: 8080
         protocol: TCP
     selector:
       app: httpbin

   Di halaman Penyebaran, klik penyebaran httpbin yang Anda buat. Jika status penyebaran adalah Running, aplikasi layanan mikro berhasil diterapkan, seperti yang ditunjukkan pada gambar berikut.

   

Ikhtisar Proses

Pertama, buat instance API Gateway Berbasis Cloud-native. Kemudian, kaitkan layanan dari ACK. Setelah itu, buat kebijakan perutean untuk layanan terkait Anda di API Gateway Berbasis Cloud-native agar layanan tersebut dapat diakses sesuai dengan kebijakan perutean tersebut.

1. Buat instance API Gateway Berbasis Cloud-native.

   Pada langkah ini, Anda membuat instance API Gateway Berbasis Cloud-native berdasarkan lingkungan layanan mikro Anda.

2. Buat API HTTP.

   Pada langkah ini, Anda membuat API HTTP di instance gateway.

3. Buat rute.

   Pada langkah ini, Anda mengonfigurasi kebijakan perutean untuk layanan Anda dan menerbitkan kebijakan perutean tersebut.

   1. Tambahkan sumber layanan.

      Pada sub-langkah ini, Anda menambahkan sumber layanan di API Gateway Berbasis Cloud-native. Dalam contoh ini, ACK digunakan sebagai sumber layanan.

   2. Tambahkan layanan.

      Pada sub-langkah ini, Anda menambahkan layanan. API Gateway Berbasis Cloud-native dapat memperoleh namespace dari ACK dan kemudian menambahkan layanan yang ada sebagai layanan kandidat.

4. Debug rute.

   Pada langkah ini, Anda memeriksa apakah rute yang dibuat bekerja sesuai harapan dan menyesuaikan rute jika perlu.

Langkah 1: Buat instance API Gateway Berbasis Cloud-native

1. Masuk ke Konsol API Gateway Berbasis Cloud-native. Jika Anda menggunakan API Gateway Berbasis Cloud-native untuk pertama kalinya, lakukan operasi berikut:

   Catatan

   Jika Anda mengakses API Gateway Berbasis Cloud-native untuk pertama kalinya, sistem akan meminta Anda untuk memberikan otorisasi untuk membuat peran terkait layanan.

   1. Di halaman yang muncul, klik Authorize Now. Di kotak dialog yang muncul, klik OK untuk membuat peran terkait layanan.

   2. Klik Experience Cloud-native API Gateway Now untuk masuk ke konsol.

2. Di panel navigasi kiri, klik Instance. Di bilah navigasi atas, pilih wilayah. Lalu, klik Create Instance.

   Penting

   Pastikan bahwa instance dibuat di wilayah yang sama dengan kluster ACK.

3. Di halaman pembelian, konfigurasikan parameter dan klik Buy Now.

   

4. Di halaman Confirm Order, baca syarat layanan dan klik Activate Now.

   Catatan

   Pembuatan instance mungkin memerlukan waktu dua hingga tiga menit untuk selesai.

5. Kembali ke halaman Instance untuk memeriksa informasi dan status instance yang dibuat.

   Jika informasi instance sesuai harapan dan status-nya adalah Running, instance berhasil dibuat.

Langkah 2: Buat API HTTP

1. Di halaman API Konsol API Gateway Berbasis Cloud-native, klik Create API.

2. Di kotak dialog yang muncul, klik Create di bagian HTTP API. Di panel Buat API HTTP, konfigurasikan parameter API Name sesuai petunjuk.

Langkah 3: Buat rute

1. Di halaman API Konsol API Gateway Berbasis Cloud-native, klik API yang ingin Anda kelola.

   Klik Create Route. Di panel Create Route, konfigurasikan parameter.

Konfigurasikan informasi dasar rute

• Nama Domain: Anda dapat mengklik Add Domain Name di sebelah kanan untuk membuat nama domain di panel Tambah Nama Domain.

• Path: Pilih Prefix dari daftar drop-down dan masukkan garis miring (/) di bidang untuk mencocokkan permintaan HTTP yang dimulai dengan /.

Pilih instance dan konfigurasikan layanan backend

1. Pilih instance yang dibuat di Langkah 1 dari daftar drop-down Instance.

   

2. Skenario: Pilih Single Service dari daftar drop-down Scenarios.

3. Untuk parameter Backend Services, klik Create Service di bawah Service Name.

4. Buat sumber layanan dan layanan.

   1. Pilih ACK dari daftar drop-down Source Type.

   2. Klik Add Source dan pilih kluster yang Anda buat di bagian Prasyarat.

   3. Dari service list, pilih httpbin dan klik OK.

      

   4. Di item konfigurasi Backend Services, pilih layanan yang dibuat di langkah sebelumnya dari daftar drop-down Service Name.

      

5. Klik Save and Publish.

Langkah 4: Debug rute

1. Di halaman API Konsol API Gateway Berbasis Cloud-native, klik API yang ingin Anda kelola.

2. Di daftar rute, temukan httpbin-demo dan klik Debug di kolom Actions.

3. Di halaman yang muncul, masukkan versi dan klik Send. Gambar berikut menunjukkan hasil yang dikembalikan.

   

Referensi

• Untuk informasi lebih lanjut tentang cara mengelola beberapa kluster ACK, lihat Gunakan API Gateway Berbasis Cloud-native untuk mengelola beberapa kluster ACK.

• Untuk informasi lebih lanjut tentang pertanyaan yang sering diajukan (FAQ) tentang penggunaan API Gateway Berbasis Cloud-native, lihat FAQ.