Použití dev proxy v kontejneru Dockeru

Při použití dev Proxy se můžete rozhodnout, že ho budete spouštět přímo na počítači nebo v kontejneru Dockeru. Spuštění Dev Proxy v Dockeru je skvělý způsob, jak ho izolovat od místního prostředí. Nabízí také konzistentní způsob použití služby Dev Proxy mezi místním počítačem a prostředími CI/CD.

Použijte Docker image pro vývojářský proxy server

Pro vaše pohodlí poskytujeme připravenou k použití image Dockeru s Dev Proxy. Můžete ho použít ke spuštění Dev Proxy v kontejneru Dockeru. Image můžete načíst ze služby GitHub Container Registry pomocí následujícího příkazu:

docker pull ghcr.io/dotnet/dev-proxy:latest

Poznámka:

Pokud chcete vyzkoušet nejnovější funkce preview, použijte beta verzi kontejneru Dev Proxy.

docker pull ghcr.io/dotnet/dev-proxy:beta

Pokud používáte Dev Proxy v kanálu CI/CD, zvažte použití konkrétní verze image místo latest nebo beta. Tímto způsobem můžete zajistit, aby váš kanál nebyl ovlivněn žádnými zásadními změnami zavedenými v nejnovější verzi dev proxy serveru. Pokud například chcete použít Dev Proxy verze 0.26.0, použijte následující příkaz:

docker pull ghcr.io/dotnet/dev-proxy:0.26.0

Spuštění kontejneru Dev Proxy

Ke spuštění kontejneru Dev Proxy použijte následující příkaz:

docker run \
    # remove the container when it exits
    --rm \
    # run the container interactively
    -it \
    # map Dev Proxy ports to the host
    -p 8000:8000 -p 8897:8897 \
    # map volumes to the host. Create the `cert` folder in the current working directory before running the command
    -v ${PWD}:/config -v ${PWD}/cert:/home/devproxy/.config/dev-proxy/rootCert \
    # specify the image to use
    ghcr.io/dotnet/dev-proxy:0.26.0

Po spuštění příkazu se dev proxy spustí automaticky a naslouchá provozu na portu 8000. Vzhledem k tomu, že běží v kontejneru Dockeru, nezaregistruje se automaticky jako systémový proxy server na hostiteli za účelem zachycení webových požadavků. Místo toho musíte ručně nakonfigurovat systémový proxy server na hostiteli nebo nakonfigurovat proxy server pro vaši aplikaci.

Spuštěním kontejneru interaktivně (pomocí -it možností) můžete řídit vývojový proxy server z příkazového řádku. Interakce s dev proxy serverem je užitečná například při spouštění a zastavování nahrávání, vymazání obrazovky atd. Pokud kontejner spustíte na pozadí, můžete stále řídit dev proxy pomocí rozhraní DEV Proxy API.

Parametry

Dev Proxy Docker obsahuje několik parametrů, které můžete použít k přizpůsobení jeho chování.

Přístavy

Image zveřejňuje následující porty:

• 8000 – port, na kterém dev proxy naslouchá příchozímu provozu.
• 8897 – port, na kterém dev proxy zpřístupňuje své rozhraní API. Můžete ho použít k programové interakci s dev proxy serverem.

Důležité

Nezapomeňte namapovat oba porty na hostitele, abyste měli přístup k Dev Proxy z místního počítače a používali Dev Proxy Toolkit.

Objemы

Obrázek zobrazuje následující svazky:

• /config – aktuální pracovní adresář, ze kterého kontejner spouští vývojový proxy server. Pokud složka, kterou mapujete, obsahuje devproxyrc.json soubor, dev Proxy ho automaticky použije ke konfiguraci.
• /home/devproxy/.config/dev-proxy/rootCert – složka, ve které dev proxy ukládá kořenový certifikát. Mapováním svazku na váš hostitelský počítač můžete snadno získat přístup ke kořenovému certifikátu a nainstalovat jej do svého systému nebo prohlížeče.

Návod

Alternativně k mapování kořenového certifikátu na hostitele můžete pomocí rozhraní DEV Proxy API stáhnout veřejný klíč kořenového certifikátu ve formátu PEM (Privacy Enhanced Mail). Pokud chcete certifikát stáhnout, zavolejte GET http://127.0.0.1:8897/proxy/rootCertificate?format=crt koncový bod.

Použití dev proxy v Dockeru

Při spuštění kontejneru Dev Proxy se automaticky spustí vývojový proxy server, který naslouchá příchozímu provozu na portu 8000.

Výchozí konfigurace

Dev Proxy vyhledá soubor devproxyrc.json ve složce, kterou namapujete na svazek /config. Pokud soubor najde, použije ho ke konfiguraci. Pokud soubor nenajde, použije výchozí konfiguraci.

Vlastní konfigurace

Vlastní konfiguraci pro dev proxy můžete použít tak, že vytvoříte soubor devproxyrc.json ve složce, kterou namapujete na svazek /config. Případně můžete konfigurační soubor zadat pomocí parametru --config-file při spuštění dev proxy serveru. Pokud například chcete použít soubor myconfig.json, použijte následující příkaz:

docker run \
    # remove the container when it exits
    --rm \
    # run the container interactively
    -it \
    # map Dev Proxy ports to the host
    -p 8000:8000 -p 8897:8897 \
    # map volumes to the host. Create the `cert` folder in the current working directory before running the command
    -v ${PWD}:/config -v ${PWD}/cert:/home/devproxy/.config/dev-proxy/rootCert \
    # specify the image to use
    ghcr.io/dotnet/dev-proxy:0.26.0 \
    # specify the configuration file to use
    --config-file /config/myconfig.json

Zadaný konfigurační soubor musí být přístupný z kontejneru. Pokud použijete relativní cestu, musí být vztažená ke svazku /config.

Další možnosti

Pokud chcete použít jiné možnosti, můžete je zadat stejným způsobem jako při spuštění Dev Proxy přímo na svém počítači. Pokud chcete například zadat adresy URL, které se mají sledovat, použijte následující příkaz:

docker run \
    # remove the container when it exits
    --rm \
    # run the container interactively
    -it \
    # map Dev Proxy ports to the host
    -p 8000:8000 -p 8897:8897 \
    # map volumes to the host. Create the `cert` folder in the current working directory before running the command
    -v ${PWD}:/config -v ${PWD}/cert:/home/devproxy/.config/dev-proxy/rootCert \
    # specify the image to use
    ghcr.io/dotnet/dev-proxy:0.26.0 \
    # specify the URLs to watch
    --urls-to-watch "https://example.com/*"