Menyebarkan gateway yang dihost sendiri ke Kubernetes dengan YAML

BERLAKU UNTUK: Pengembang | Premium

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

Penting

Dukungan untuk gateway yang dihost sendiri Azure API Management versi 0 dan gambar kontainer versi 1 berakhir pada 1 Oktober 2023, bersama dengan Api Konfigurasi v1 yang sesuai. Gunakan panduan migrasi kami untuk menggunakan gateway yang dihost sendiri v2.0.0 atau yang lebih tinggi dengan Configuration API v2. Pelajari lebih lanjut dalam dokumentasi penghentian kami

Catatan

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

Prasyarat

• Menyelesaikan mulai cepat berikut: Membuat instans Azure API Management.
• Buat kluster Kubernetes, atau miliki akses ke kluster yang sudah ada.

  Tip

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

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

Sebarkan ke Kubernetes

Tip

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. Sebuah token akses di kotak teks Token dibuat otomatis untuk Anda, berdasarkan pada nilai Kedaluwarsa dan Kunci 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 dihost 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 dihost sendiri yang menggunakan ConfigMap dengan konfigurasi gateway.

Konfirmasikan bahwa gateway sedang berjalan

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
   

   Ini harus 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
   

   Ini harus 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 dihost sendiri yang disebarkan berhasil berkomunikasi dengan layanan API Management dan memiliki "heartbeat" reguler.

Tip

• 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.

Langkah berikutnya

• 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.