Menyebarkan gateway yang dihost sendiri ke Kubernetes dengan YAML

BERLAKU UNTUK: Developer | Premium

Artikel ini menjelaskan langkah-langkah untuk menyebarkan komponen gateway yang dihost sendiri dari Azure API Management ke klaster Kubernetes.

Catatan

Anda juga dapat menyebarkan gateway yang dihost sendiri ke kluster Kubernetes yang didukung Azure Arc sebagai ekstensi kluster.

Prasyarat

• Selesaikan panduan memulai cepat berikut: Membuat instans Azure API Management.

• Buat kluster Kubernetes, atau miliki akses ke kluster yang sudah ada.

  Petunjuk

  Klaster node tunggal bekerja dengan baik untuk tujuan pengembangan dan evaluasi. Gunakan kluster multi-node Bersertifikat Kubernetes secara lokal atau di cloud untuk beban kerja produksi

• Sediakan sumber daya gateway yang dihost sendiri di instans API Management Anda.

Sebarkan ke Kubernetes

Petunjuk

Langkah-langkah berikut menyebarkan gateway yang dihost sendiri ke Kubernetes dan mengaktifkan autentikasi ke instans API Management dengan menggunakan token akses gateway (kunci autentikasi). Anda juga dapat menyebarkan gateway yang dihost sendiri ke Kubernetes dan mengaktifkan autentikasi ke instans API Management dengan menggunakan ID Microsoft Entra.

1. Pilih Gateway pada Penyebaran dan infrastruktur.
2. Pilih sumber daya gateway yang dihost sendiri yang ingin Anda sebarkan.
3. Pilih Penyebaran.
4. Token akses dalam kotak teks Token dibuat secara otomatis untuk Anda, berdasarkan nilai kunci Kedaluwarsa dan Rahasia default. Jika diperlukan, pilih nilai di salah satu atau kedua kontrol untuk membuat token baru.
5. Pilih tab Kubernetes di Skrip penyebaran.
6. Pilih link file <gateway-name>.yml dan unduh file YAML.
7. Pilih ikon salin di sudut kanan bawah kotak teks Sebarkan untuk menyimpan perintah kubectl ke clipboard.
8. Saat menggunakan Azure Kubernetes Service (AKS), jalankan az aks get-credentials --resource-group <resource-group-name> --name <resource-name> --admin di sesi terminal baru.
9. Jalankan perintah untuk membuat objek Kubernetes yang diperlukan di namespace default dan mulai pod gateway yang dihosting sendiri dari gambar kontainer yang diunduh dari Microsoft Artifact Registry.
   • Langkah pertama membuat rahasia Kubernetes yang berisi token akses yang dihasilkan pada langkah 4. Selanjutnya, ini membuat penyebaran Kubernetes untuk gateway yang dihosting sendiri, yang menggunakan ConfigMap dengan konfigurasi gateway.

Pastikan bahwa gateway berfungsi

1. Jalankan perintah berikut untuk memeriksa apakah penyebaran telah berhasil. Mungkin perlu sedikit waktu agar semua objek dibuat dan agar pod dapat diinisialisasi.

   kubectl get deployments
   

   Seharusnya kembali

   NAME             READY   UP-TO-DATE   AVAILABLE   AGE
   <gateway-name>   1/1     1            1           18s
   

2. Jalankan perintah berikut untuk memeriksa apakah layanan berhasil dibuat. IP dan port layanan Anda akan berbeda.

   kubectl get services
   

   Seharusnya kembali

   NAME                                TYPE           CLUSTER-IP      EXTERNAL-IP   PORT(S)                      AGE
   <gateway-name>-live-traffic         ClusterIP      None            <none>        4290/UDP,4291/UDP   9m1s
   <gateway-name>-instance-discovery   LoadBalancer   10.99.236.168   <pending>     80:31620/TCP,443:30456/TCP   9m1s
   

3. Kembali ke portal Microsoft Azure dan pilih Gambaran Umum.

4. Konfirmasikan bahwa Status menunjukkan tanda centang hijau, diikuti dengan jumlah node yang sesuai dengan jumlah replika yang ditentukan dalam file YAML. Status ini berarti pod gateway yang dihosting sendiri yang telah disebarkan berhasil berkomunikasi dengan layanan Manajemen API dan memiliki heartbeat reguler.

Petunjuk

• Jalankan perintah kubectl logs deployment/<gateway-name> untuk melihat log dari pod yang dipilih secara acak jika ada lebih dari satu pod.
• Jalankan kubectl logs -h untuk serangkaian opsi perintah lengkap, seperti cara melihat log untuk pod atau kontainer tertentu.

Konten terkait

• Untuk mempelajari selengkapnya tentang gateway yang dihost sendiri, lihat Gambaran umum gateway yang dihost sendiri.
• Pelajari cara menyebarkan gateway API Management yang dihost sendiri ke kluster Kubernetes yang didukung Azure Arc.
• Pelajari selengkapnya panduan untuk menjalankan gateway yang dihost sendiri di Kubernetes dalam produksi.