Nasazení brány azure API Management v místním prostředí do Dockeru

PLATÍ PRO: Vývojář | Premium

Tento článek obsahuje postup nasazení komponenty brány v místním prostředí služby Azure API Management do prostředí Dockeru.

Důležité

Podpora místních imagí kontejnerů služby Azure API Management verze 0 a verze 1 končí 1. října 2023 spolu s odpovídajícím konfiguračním rozhraním API v1. Pomocí našeho průvodce migrací můžete používat místní bránu verze 2.0.0 nebo vyšší s rozhraním CONFIGURATION API v2. Další informace najdete v naší dokumentaci k vyřazení

Poznámka:

Hostování brány v Dockeru je nejvhodnější pro případy použití vyhodnocení a vývoje. Kubernetes se doporučuje pro produkční použití. Zjistěte, jak nasadit pomocí Helmu nebo pomocí souboru YAML nasazení, abyste se dozvěděli, jak nasadit bránu v místním prostředí do Kubernetes.

Požadavky

• Projděte si následující rychlý start: Vytvoření instance služby Azure API Management
• Vytvořte prostředí Dockeru. Docker for Desktop je dobrou volbou pro účely vývoje a vyhodnocení. Informace o všech edicích Dockeru, jejich funkcích a komplexní dokumentaci o samotné Dockeru najdete v dokumentaci k Dockeru.
• Zřízení prostředku brány v instanci služby API Management

Poznámka:

Brána v místním prostředí je zabalená jako kontejner Dockeru založený na platformě x86-64 s Linuxem.

Nasazení brány v místním prostředí do Dockeru

1. V části Nasazení a infrastruktura vyberte Brány.

2. Vyberte prostředek brány, který chcete nasadit.

3. Vyberte Nasazení.

4. Všimněte si, že přístupový token v textovém poli Token byl automaticky vygenerován pomocí výchozích hodnot vypršení platnosti a tajného klíče . V případě potřeby vyberte požadované hodnoty v obou ovládacích prvcích a vygenerujte nový token.

5. Ujistěte se, že je v části Skripty nasazení vybraný Docker.

6. Vyberte odkaz na soubor env.conf vedle prostředí a stáhněte soubor.

7. Výběrem ikony kopírování umístěné na pravém konci textového pole Spustit zkopírujte příkaz Dockeru do schránky.

8. Vložte příkaz do okna terminálu (nebo příkazu). Podle potřeby upravte mapování portů a název kontejneru. Všimněte si, že příkaz předpokládá, že stažený soubor prostředí se nachází v aktuálním adresáři.

   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. Spusťte příkaz . Příkaz dává prostředí Dockeru pokyn ke spuštění kontejneru pomocí image kontejneru z Registr artefaktů Microsoft a k mapování portů HTTP (8080) a HTTPS (8081) kontejneru na porty 80 a 443 na hostiteli.

10. Spuštěním následujícího příkazu zkontrolujte, jestli je kontejner brány spuštěný:

    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. Vraťte se na Web Azure Portal, klikněte na Přehled a ověřte, že kontejner brány, který jste právě nasadili, hlásí stav, který je v pořádku.

    

Tip

Pomocí console docker container logs <gateway-name> příkazu zobrazíte snímek protokolu brány v místním prostředí.

Pomocí docker container logs --help příkazu zobrazíte všechny možnosti zobrazení protokolu.

Další kroky

• Další informace o bráně v místním prostředí najdete v přehledu brány v místním prostředí služby Azure API Management.
• Nakonfigurujte vlastní název domény pro bránu v místním prostředí.