Dev Proxy használata Docker-tárolóban

Dev Proxy használata esetén dönthet úgy, hogy közvetlenül a számítógépen vagy egy Docker-tárolóban futtatja. A Dev Proxy Dockerben való futtatásával el lehet különíteni a helyi környezettől. Emellett konzisztens módon használhatja a Dev Proxyt a helyi gép és a CI/CD-környezetek között.

A Dev Proxy Docker-lemezkép használata

Az Ön kényelme érdekében biztosítunk egy használatra kész Docker-rendszerképet a Dev Proxyval. Használatával dev proxyt futtathat Egy Docker-tárolóban. A rendszerképet lekérheti a GitHub Container Registryből az alábbi paranccsal:

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

Megjegyzés:

A legújabb előzetes verziójú funkciók kipróbálásához használja a Fejlesztői proxy tároló bétaverzióját.

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

Ha Dev Proxyt használ egy CI/CD-folyamatban, fontolja meg a rendszerkép egy adott verziójának használatát ahelyett, latest vagy beta. Így gondoskodhat arról, hogy a folyamatra ne legyenek hatással a Dev Proxy legújabb verziójában bevezetett kompatibilitástörő változások. A Dev Proxy 0.26.0-s verziójának használatához például használja a következő parancsot:

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

A fejlesztői proxytároló elindítása

A Dev Proxy tároló elindításához használja a következő parancsot:

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

A parancs futtatása után a Dev Proxy automatikusan elindul, és figyeli a forgalmat a 8000-s porton. Mivel Docker-tárolóban fut, nem regisztrál automatikusan rendszerproxyként a gazdagépen a webes kérések elfogásához. Ehelyett manuálisan kell konfigurálnia a rendszerproxyt a gazdagépen, vagy be kell állítania a proxy-t az alkalmazáshoz.

A tároló interaktív futtatásával (a beállítások használatával) vezérelheti a -it dev proxyt a parancssorból. A Dev Proxy használata hasznos lehet például a rögzítés elindításához és leállításához, a képernyő törléséhez stb. Ha a háttérben indítja el a tárolót, a Dev Proxy API használatával továbbra is vezérelheti a Dev Proxyt.

Paraméterek

A Dev Proxy Docker számos paramétert tartalmaz, amelyekkel testre szabhatja a viselkedését.

Kikötők

A kép a következő portokat teszi elérhetővé:

• 8000 – az a port, amelyen a Dev Proxy figyeli a bejövő forgalmat.
• 8897 – az a port, amelyen a Dev Proxy közzéteszi az API-t. Használhatja arra, hogy programkód által kommunikáljon a Dev Proxyval.

Fontos

Győződjön meg arról, hogy mindkét portot a hostra képezi le, így hozzáférhet a Dev Proxyhoz a helyi gépéről, és használhatja a Dev Proxy Toolkitet.

Mennyiségek

A kép a következő köteteket teszi elérhetővé:

• /config – az aktuális munkakönyvtár, amelyből a tároló elindítja a Dev Proxyt. Ha a leképezendő mappa tartalmaz egy devproxyrc.json fájlt, a Dev Proxy automatikusan arra használja, hogy konfigurálja magát.
• /home/devproxy/.config/dev-proxy/rootCert – az a mappa, amelyben a Dev Proxy tárolja a főtanúsítványát. A tárolóegység helyi rendszerre való leképezésével egyszerűen elérheti a gyökértanúsítványt, és telepítheti azt a rendszerébe vagy a böngészőjébe.

Jótanács

A főtanúsítvány gazdagéphez való leképezéséhez a Dev Proxy API-val letöltheti a főtanúsítvány nyilvános kulcsát PEM (Privacy Enhanced Mail) formátumban. A tanúsítvány letöltéséhez hívja meg a végpontot GET http://127.0.0.1:8897/proxy/rootCertificate?format=crt .

Dev Proxy használata a Dockerben

A Dev Proxy tároló indításakor a rendszer automatikusan elindítja a Dev Proxyt a bejövő forgalom figyelésekor a 8000-s porton.

Alapértelmezett konfiguráció

A Dev Proxy megkeresi a devproxyrc.json kötethez /config hozzárendelt mappában lévő fájlt. Ha megtalálta a fájlt, azt használja a konfiguráláshoz. Ha nem találja a fájlt, az alapértelmezett konfigurációt használja.

Egyéni konfiguráció

A Dev Proxy egyéni konfigurációját úgy használhatja, hogy létrehozza a devproxyrc.json fájlt a kötethez /config hozzárendelt mappában. Másik lehetőségként megadhatja a konfigurációs fájlt a paraméterrel a --config-file Dev Proxy indításakor. Például a myconfig.json fájl használatához használja a következő parancsot:

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

A megadott konfigurációs fájlnak elérhetőnek kell lennie a tárolóból. Ha relatív útvonalat használ, annak a /config kötethez képest kell, hogy legyen.

Egyéb lehetőségek

Ha más beállításokat szeretne használni, ugyanúgy megadhatja őket, mint a dev proxy közvetlenül a számítógépen való futtatásakor. Például a figyelendő URL-címek megadásához használja a következő parancsot:

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