Använda Dev Proxy i en Docker-container

När du använder Dev Proxy kan du välja att köra den direkt på datorn eller i en Docker-container. Att köra Dev Proxy i Docker är ett bra sätt att isolera den från din lokala miljö. Det ger dig också ett konsekvent sätt att använda Dev Proxy mellan din lokala dator och CI/CD-miljöer.

Använd Docker-avbildningen för Dev Proxy

För din bekvämlighet tillhandahåller vi en färdig att använda Docker-image med Dev Proxy. Du kan använda den för att köra Dev Proxy i en Docker-container. Du kan hämta avbildningen från GitHub Container Registry med hjälp av följande kommando:

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

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

Om du använder Dev Proxy i en CI/CD-pipeline kan du överväga att använda en specifik version av avbildningen i stället för latest eller beta. På så sätt kan du se till att din pipeline inte påverkas av några störande ändringar som infördes med den senaste versionen av Dev Proxy. Om du till exempel vill använda Dev Proxy version 0.26.0 använder du följande kommando:

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

Starta Dev Proxy-containern

Starta Dev Proxy-containern med följande kommando:

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

När du har kört kommandot startar Dev Proxy automatiskt och lyssnar efter trafik på port 8000. Eftersom den körs i en Docker-container registreras den inte automatiskt som en systemproxy på värddatorn för att fånga upp webbbegäranden. I stället måste du konfigurera systemproxyn manuellt på din värd eller konfigurera proxyn för din applikation.

Genom att köra containern interaktivt (med alternativen -it ) kan du styra Dev Proxy från kommandoraden. Att interagera med Dev Proxy är till exempel användbart för att starta och stoppa inspelning, rensa skärmen osv. Om du startar containern i bakgrunden kan du fortfarande styra Dev Proxy med hjälp av Dev Proxy-API:et.

Parameterar

Dev Proxy Docker innehåller flera parametrar som du kan använda för att anpassa dess beteende.

Hamnar

Bilden visar följande portar:

• 8000 – porten där Dev Proxy lyssnar efter inkommande trafik.
• 8897 – porten där Dev Proxy exponerar sitt API. Du kan använda den för att interagera med Dev Proxy programmatiskt.

Volymer

Bilden visar följande volymer:

• /config – den aktuella arbetskatalog som containern startar Dev Proxy från. Om mappen som du mappar innehåller en devproxyrc.json fil använder Dev Proxy den automatiskt för att konfigurera sig själv.
• /home/devproxy/.config/dev-proxy/rootCert – mappen där Dev Proxy lagrar sitt rotcertifikat. Genom att mappa volymen till ditt värdsystem kan du enkelt komma åt rotcertifikatet och installera det i systemet eller webbläsaren.

Använda Dev Proxy i Docker

När du startar Dev Proxy-containern startar den automatiskt Dev Proxy och lyssnar efter inkommande trafik på port 8000.

Standardkonfiguration

Dev Proxy söker devproxyrc.json efter filen i mappen som du mappar till /config volymen. Om den hittar filen använder den den för att konfigurera sig själv. Om den inte hittar filen använder den standardkonfigurationen.

Anpassad konfiguration

Du kan använda anpassad konfiguration för Dev Proxy genom att skapa devproxyrc.json filen i mappen som du mappar till /config volymen. Du kan också ange konfigurationsfilen med hjälp av parametern --config-file när du startar Dev Proxy. Om du till exempel vill använda myconfig.json filen använder du följande kommando:

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

Konfigurationsfilen som du anger måste vara tillgänglig från containern. Om du använder en relativ sökväg måste den /config vara relativ till volymen.

Andra alternativ

Om du vill använda andra alternativ kan du ange dem på samma sätt som när du kör Dev Proxy direkt på datorn. Om du till exempel vill ange vilka URL:er som ska övervakas använder du följande kommando:

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/*"