Menyebarkan gateway yang dihost sendiri Azure API Management ke Azure Kubernetes Service

  • Artikel

BERLAKU UNTUK: Pengembang | Premium

Artikel ini menyediakan langkah-langkah untuk menyebarkan komponen gateway yang dihost sendiri dari Azure API Management ke Azure Kubernetes Service. Untuk menyebarkan gateway yang dihost sendiri ke kluster Kubernetes, lihat artikel cara penyebaran dengan menggunakan file YAML penyebaran atau dengan Helm.

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

Menyebarkan gateway yang dihost sendiri ke AKS

  1. Pilih Gateway dari Penyebaran dan infrastruktur.

  2. Pilih sumber daya gateway yang dihost sendiri yang ingin Anda sebarkan.

  3. Pilih Penyebaran.

  4. Token baru di kotak teks Token dibuat secara otomatis untuk Anda menggunakan nilai Kedaluwarsa dan Kunci Rahasia default. Sesuaikan salah satu atau keduanya jika diinginkan dan pilih Buat untuk membuat token baru.

  5. Pastikan Kubernetes dipilih di Skrip Penyebaran.

  6. Pilih tautan file <gateway-name>.yml di samping Penyebaran untuk mengunduh file.

  7. Sesuaikan config.service.endpoint, pemetaan port, dan nama kontainer dalam file .yml sesuai kebutuhan.

  8. Tergantung pada skenario Anda, Anda mungkin perlu mengubah jenis layanan.

    • Nilai default-nya adalah LoadBalancer, yang merupakan penyeimbang beban eksternal.
    • Anda dapat menggunakan penyeimbang beban internal untuk membatasi akses ke gateway yang dihost sendiri hanya untuk pengguna internal.
    • Contoh berikut menggunakan NodePort.

  9. Pilih ikon salin yang terletak di ujung kanan kotak teks Sebarkan untuk menyimpan kubectl perintah ke clipboard.

  10. Tempelkan perintah ke jendela terminal (atau perintah). Perintah ini mengharapkan file lingkungan yang diunduh ada di direktori saat ini.

    kubectl apply -f <gateway-name>.yaml

  11. Jalankan perintah . Perintah menginstruksikan kluster AKS Anda untuk:

    • Menjalankan kontainer, dengan menggunakan citra gateway yang dihost sendiri yang diunduh dari Microsoft Container Registry.
    • Mengonfigurasi kontainer untuk mengekspos port HTTP (8080) dan HTTPS (443).

  12. Jalankan perintah di bawah ini untuk memeriksa pod gateway yang sedang berjalan. Nama pod Anda akan berbeda.

    kubectl get pods
NAME                                   READY     STATUS    RESTARTS   AGE
contoso-apim-gateway-59f5fb94c-s9stz   1/1       Running   0          1m

  13. Jalankan perintah di bawah ini untuk memeriksa layanan gateway yang sedang berjalan. Nama layanan dan alamat IP Anda akan berbeda.

    kubectl get services
NAME             TYPE        CLUSTER-IP      EXTERNAL-IP   PORT(S)                      AGE
contosogateway   NodePort    10.110.230.87   <none>        80:32504/TCP,443:30043/TCP   1m

  14. Kembali ke portal Azure dan konfirmasi bahwa simpul gateway yang disebarkan melaporkan status sehat.

Tip

Gunakan kubectl logs <gateway-pod-name> perintah untuk melihat rekam jepret log gateway yang dihost sendiri.

Langkah berikutnya