Menyebarkan gateway yang dihost sendiri API Management Azure ke Docker

BERLAKU UNTUK: Pengembang | Premium

Artikel ini menyediakan langkah-langkah untuk menyebarkan komponen gateway yang dihost sendiri dari Azure API Management ke lingkungan Docker.

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

Hosting gateway yang dihost sendiri di Docker paling cocok untuk kasus evaluasi dan penggunaan pengembangan. Kubernetes disarankan untuk digunakan dalam produksi. Pelajari cara menyebarkan dengan Helm atau menggunakan penyebaran file YAML untuk mempelajari cara menyebarkan gateway yang dihost sendiri ke Kubernetes.

Prasyarat

• Selesaikan panduan mulai cepat berikut: Memulai instans Azure API Management
• Buat lingkungan Docker. Docker for Desktop adalah opsi yang bagus untuk tujuan pengembangan dan evaluasi. Lihat dokumentasi Docker untuk informasi tentang semua edisi Docker, fiturnya, dan dokumentasi komprehensif tentang Docker itu sendiri.
• Menyediakan sumber daya gateway di instans API Management Anda

Catatan

Gateway yang dihost sendiri dikemas sebagai kontainer Docker berbasis Linux x86-64.

Menyebarkan gateway yang dihost sendiri ke Docker

1. Pilih Gateway dari Penyebaran dan infrastruktur.

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

3. Pilih Penyebaran.

4. Perhatikan bahwa token di kotak teks Token dibuat secara otomatis untuk Anda menggunakan Kedaluwarsa default dan nilai Kunci rahasia. Jika diperlukan, ambil nilai yang diinginkan di salah satu atau kedua kontrol untuk membuat token baru.

5. Pastikan Docker dipilih di Skrip Penyebaran.

6. Pilih tautan file env.conf di samping Lingkungan untuk mengunduh file.

7. Pilih ikon salin yang terletak di ujung kanan kotak teks Jalankan untuk menyalin perintah Docker ke clipboard.

8. Tempelkan perintah ke jendela terminal (atau perintah). Sesuaikan pemetaan port dan nama kontainer sesuai yang dibutuhkan. Perhatikan bahwa perintah tersebut mengasumsikan bahwa file lingkungan yang diunduh ada di direktori saat ini.

   docker run -d -p 80:8080 -p 443:8081 --name <gateway-name> --env-file env.conf mcr.microsoft.com/azure-api-management/gateway:<tag>
   

9. Jalankan perintah . Perintah ini menginstruksikan lingkungan Docker Anda untuk menjalankan kontainer menggunakan gambar kontainer yang diunduh dari Microsoft Artifact Registry, dan untuk memetakan port HTTP (8080) dan HTTPS (8081) kontainer ke port 80 dan 443 pada host.

10. Jalankan perintah berikut untuk memeriksa apakah kontainer gateway sedang berjalan:

    docker ps
    CONTAINER ID        IMAGE                                                 COMMAND                  CREATED             STATUS              PORTS                                         NAMES
    895ef0ecf13b        mcr.microsoft.com/azure-api-management/gateway:latest   "/bin/sh -c 'dotnet …"   5 seconds ago       Up 3 seconds        0.0.0.0:80->8080/tcp, 0.0.0.0:443->8081/tcp   my-gateway
    

11. Kembali ke portal Microsoft Azure, klik Gambaran Umum dan konfirmasi bahwa kontainer gateway yang dihost sendiri yang baru saja Anda terapkan melaporkan status sehat.

    

Tip

Gunakan console docker container logs <gateway-name> perintah untuk melihat rekam jepret log gateway yang dihost sendiri.

Gunakan perintah docker container logs --help untuk melihat semua opsi melihat log.

Langkah berikutnya

• Untuk mempelajari selengkapnya tentang gateway yang dihost sendiri, lihat Gambaran umum gateway yang dihost sendiri oleh Azure API Management.
• Mengonfigurasi nama domain kustom untuk gateway yang dihost sendiri.