Bagikan melalui


Menyebarkan gateway yang dihost sendiri ke Kubernetes dengan YAML

BERLAKU UNTUK: Pengembang | Premi

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

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. Cuplikan layar memperlihatkan status gateway yang dihost sendiri di portal.

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