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

BERLAKU UNTUK: Pengembang | Premi

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

Catatan

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

Prasyarat

• Buat sebuah instans API Management Azure
• Buat kluster Azure Kubernetes menggunakan Azure CLI, menggunakan Azure PowerShell, atau menggunakan portal Azure.
• Menyediakan sumber daya gateway di instans API Management Anda.

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 <nama_gateway>.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.
   • Sampel 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 berikut untuk memeriksa apakah pod gateway Anda berjalan. Nama pod ini adalah contoh.

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

13. Jalankan perintah berikut untuk memeriksa apakah layanan gateway Anda sedang berjalan. Nama layanan dan alamat IP adalah contoh.

    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 Microsoft Azure dan konfirmasikan bahwa simpul gateway yang Anda sebarkan melaporkan status sehat.

Tip

Gunakan perintah kubectl logs <gateway-pod-name> untuk melihat cuplikan log gateway yang di-host sendiri.

Konten terkait

• Untuk mempelajari selengkapnya tentang gateway yang dihost sendiri, lihat Gambaran umum gateway yang dihost sendiri oleh Azure API Management.
• Pelajari cara menyebarkan gateway API Management yang dihost sendiri ke kluster Kubernetes yang didukung Azure Arc.
• Pelajari selengkapnya tentang kemampuan observabilitas gateway Azure API Management.
• Pelajari selengkapnya tentang panduan untuk menjalankan gateway yang dihost sendiri pada Kubernetes saat produksi.
• Pelajari selengkapnya tentang Azure Kubernetes Service.