Menyebarkan gateway mandiri yang di-host sendiri dari Azure API Management 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.

Note

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

Prerequisites

• Selesaikan panduan memulai cepat berikut: Membuat instans Azure API Management.
• Membuat lingkungan Docker: Docker untuk Desktop adalah opsi yang baik untuk tujuan pengembangan dan evaluasi. Lihat dokumentasi Docker untuk informasi tentang semua edisi Docker, fiturnya, dan dokumentasi komprehensif tentang Docker itu sendiri.
• Provisikan sumber daya gateway di instans Azure API Management Anda.

Note

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

Menyebarkan gateway yang dihost sendiri ke Docker

1. Pilih Gateway yang dihost sendiri di bawah Penyebaran + infrastruktur.

2. Pilih sumber daya gateway yang ingin Anda sebarkan.

3. PilihPengaturan>Penyebaran.

4. Perhatikan bahwa token akses dalam kotak teks Token dibuat secara otomatis untuk Anda dengan menggunakan nilai kunci Kedaluwarsa dan Rahasia default. Jika diperlukan, pilih nilai yang diinginkan di salah satu atau kedua kontrol untuk menghasilkan token baru.

5. Pastikan Docker dipilih di bawah 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 Anda.

8. Tempel perintah ke jendela terminal (atau jendela perintah). Sesuaikan pemetaan port dan nama kontainer sesuai kebutuhan. Perintah 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 dengan menggunakan gambar kontainer 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, pilih Gambaran Umum, dan konfirmasikan bahwa kontainer gateway yang dihost sendiri yang baru saja Anda sebarkan melaporkan status sehat.

    

Tip

Gunakan perintah console docker container logs <gateway-name> untuk melihat cuplikan log gateway yang dihosting sendiri.

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

Konten terkait

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