Megosztás a következőn keresztül:

Fejlesztői alagutak parancssori referenciája

  • Cikk

A fejlesztői alagutak parancssori felületet (CLI) biztosítanak a fejlesztői alagutak létrehozásához és kezeléséhez. Ez a cikk a különböző devtunnel CLI-parancsok szintaxisát és paramétereit ismerteti.

Fontos

Ez a funkció jelenleg nyilvános előzetes verzióban érhető el. Ez az előzetes verzió szolgáltatásszintű szerződés nélkül érhető el, és éles számítási feladatokhoz nem ajánlott. Előfordulhat, hogy néhány funkció nem támogatott, vagy korlátozott képességekkel rendelkezik.

Megjegyzés:

devtunnel A parancssori felület parancsai előzetes verzióban érhetők el. A parancsnevek és a beállítások a későbbi kiadásokban változhatnak.

Globális beállítások

  • -v, --verbose: Részletes kimenet engedélyezése.
  • -?, -h, --help: Súgó- és használati adatok megjelenítése.

Felhasználói hitelesítő adatok kezelése

A dev tunnel szolgáltatás bejelentkezést igényel a fejlesztői alagutak felügyeletének és hozzáférésének engedélyezéséhez. Alapértelmezés szerint a fejlesztői alagút csak a fejlesztői alagutat létrehozó felhasználó számára érhető el, bár ez a felhasználó hozzáférést adhat másoknak.

A bejelentkezés után a bejelentkezési jogkivonat gyorsítótárazva lesz a rendszer biztonságos kulcsláncában, és több napig érvényes a lejárat előtt. A parancssori felületről való kijelentkezés törli ezt a gyorsítótárazott jogkivonatot, de nem törli a böngésző cookie-kat. Ezek közé tartozhatnak a fejlesztői alagút hozzáférési jogkivonatai, ha egy böngészőt használnak a dev tunnel-hitelesítéshez.

Parancs Leírás
devtunnel user login Jelentkezzen be Egy Microsoft- vagy GitHub-fiókkal.
devtunnel user logout A gyorsítótárazott jogkivonat törlése
devtunnel user show Aktuális bejelentkezési állapot megjelenítése

Tipp.

devtunnel login és devtunnel logout rövidített parancsok a bejelentkezéshez és a kijelentkezéshez.

Íme néhány példa az alábbi parancsok használatára:

Példák Leírás
devtunnel user login Bejelentkezés Microsoft-szervezettel (Microsoft Entra-azonosító) vagy személyes fiókkal
devtunnel user login -g Bejelentkezés GitHub-fiókkal
devtunnel user login -d Jelentkezzen be egy GitHub-fiókkal eszközkód-bejelentkezéssel, ha a helyi interaktív böngészőbe való bejelentkezés nem lehetséges
devtunnel user login -g -d Jelentkezzen be egy GitHub-fiókkal eszközkód-bejelentkezéssel, ha a helyi interaktív böngészőbe való bejelentkezés nem lehetséges

Fejlesztői alagút üzemeltetésére

devtunnel host a dev tunnel üzemeltetéséhez használt fő parancs. A parancsot a fejlesztői alagúton keresztül elérni kívánt kiszolgálót futtató gazdarendszeren kell futtatni.

Parancs Leírás
devtunnel host Egy fejlesztői alagút üzemeltetésére. Ha nincs megadva fejlesztői alagút azonosítója, létrejön egy új ideiglenes fejlesztői alagút, amely a kapcsolat bezárása után törlődik.

Íme néhány példa a parancs használatára:

Példák Leírás
devtunnel host -p 3000 Ideiglenes fejlesztői alagutat üzemeltet a 3000-es portot figyelő kiszolgáló számára a gazdarendszeren.
devtunnel host -p 3000 --allow-anonymous Ideiglenes fejlesztői alagutat üzemeltet, és engedélyezi a névtelen ügyfélhozzáférést.
devtunnel host -p 3000 5000 A 3000-es és az 5000-es porton figyelő helyi kiszolgálók ideiglenes fejlesztői alagutat üzemeltetnek.
devtunnel host -p 8443 --protocol https A HTTPS protokollt használó 8443-es porton figyelő kiszolgáló ideiglenes fejlesztői alagutat üzemeltet.
devtunnel host -p 8000 --expiration 2d Egyéni lejárati idővel rendelkező ideiglenes fejlesztői alagutat üzemeltet. A minimum 1 óra (1 óra) és a maximum 30 nap (30d).
devtunnel host TUNNELID Üzemeltetje a korábban konfigurált meglévő fejlesztői alagutat.

Figyelmeztetés

Ha engedélyezi a névtelen hozzáférést egy fejlesztői alagúthoz, az azt jelenti, hogy az interneten bárki csatlakozhat a helyi kiszolgálóhoz, ha kitalálják a fejlesztői alagút azonosítóját.

A Control-C billentyű lenyomásával állítsa le a fejlesztői alagút gazdafolyamatát, és állítsa le az ügyfélkapcsolatokat a fejlesztői alagúton keresztül. Ha egy meglévő fejlesztői alagút nem lett megadva, a folyamat által automatikusan létrehozott fejlesztői alagút törlődik a folyamatból való kilépéskor.

Csatlakozás fejlesztői alagútba

Webtovábbítási felhasználói felület használata:

A devtunnel host parancs a következőhöz hasonló kimenetet jelenít meg:

Hosting port 3000 at https://l3rs99qw-3000.usw2.devtunnels.ms/

A megjelenített https: URI egyedi a fejlesztői alagút portjához: az első összetevő egy altartomány, amely a megadott fejlesztői alagút azonosítóját és portszámát tartalmazza.

Ha a üzemeltetett port egy webkiszolgálóhoz csatlakozik, akkor az URI közvetlenül a böngészőben nyitható meg bárhonnan. Ha a fejlesztői alagúthoz való hozzáférés engedélyezést igényel, akkor az URI kezdeti kérése átirányít egy bejelentkezési lapra, és a felhasználó engedélyezése után visszatér a webhelyre.

Ha a üzemeltetett port egy webszolgáltatáshoz csatlakozik, akkor ez az URI használható alap URI-ként egy webszolgáltatás-ügyfélalkalmazás által. Ha azonban a fejlesztői alagút nem engedélyezi a névtelen hozzáférést, akkor a webszolgáltatás-ügyfél általában nem tudja, hogyan kell hitelesíteni. Ha a webszolgáltatás biztonságosan közzéteheti nyilvánosan, fontolja meg a névtelen hozzáférés engedélyezését. Ellenkező esetben a webszolgáltatás-ügyfél hozzáadhat egy kérésfejlécet egy fejlesztői alagút hozzáférési jogkivonatával a kapcsolat engedélyezéséhez.

A parancssori felület használata:

Ahelyett, hogy egy ügyfélböngésző vagy alkalmazás közvetlenül csatlakozik egy dev tunnel relay URI-hoz, a parancssori felület az ügyfél portjáról egy fejlesztői alagút portjára továbbíthatja a kapcsolatokat. Előfordulhat, hogy az ügyfélnek be kell jelentkeznie, ha a fejlesztői alagút nem engedélyezi a névtelen hozzáférést.

devtunnel connect TUNNELID
  • Cserélje le TUNNELID ugyanazt a fejlesztői alagút-azonosítót, amelyet a gazdagépen használtak.

A sikeres ügyfélkimenet a következőhöz hasonló:

Connected to tunnel: l3rs99qw
SSH: Forwarding from 127.0.0.1:3000 to host port 3000.
SSH: Forwarding from [::1]:3000 to host port 3000.

A gazdagép 3000-s portján megosztott kiszolgáló most már elérhető az ügyfélen localhost:3000 , IPv4 vagy IPv6 használatával. (Az "SSH" előtag azért van, mert a dev tunnel szolgáltatás a porttovábbítás szabványos SSH protokolljára épül.) Ha a üzemeltetett port egy webkiszolgálóhoz csatlakozik, akkor http://localhost:3000/ megnyitható egy böngészőben. Ebben az esetben nincs szükség további engedélyezésre, mert az ügyfél parancssori felületének bejelentkezési jogkivonatát használták a kapcsolat engedélyezéséhez, ha szükséges.

Speciális: Fejlesztői alagutak kezelése

Létrehozhat egy fejlesztői alagutat anélkül, hogy még üzemeltette volna. Ez olyan fejlett fejlesztői alagútkonfigurációkhoz és -felügyelethez hasznos, mint például:

  • Az összes tulajdonban lévő fejlesztői alagút listázása
  • Fejlesztői alagút portjainak hozzáadása és eltávolítása
  • Fejlesztői alagút hozzáférési vezérlőinek kezelése
  • Metaadatok hozzáadása egy fejlesztői alagúthoz, például leírás és címkék
Parancs Leírás
devtunnel create Állandó fejlesztői alagút létrehozása
devtunnel list Fejlesztői alagutak listázása
devtunnel show Fejlesztői alagút részleteinek megjelenítése
devtunnel update Fejlesztői alagút tulajdonságainak frissítése
devtunnel delete Fejlesztői alagút törlése
devtunnel delete-all Az összes fejlesztői alagút törlése

Íme néhány példa az alábbi parancsok használatára:

Példák Leírás
devtunnel create -a Hozzon létre egy állandó fejlesztői alagutat, amely lehetővé teszi a névtelen hozzáférést.
devtunnel create -d 'my tunnel description' Hozzon létre egy állandó fejlesztői alagutat nem kereshető leírással.
devtunnel create --expiration 4h Hozzon létre egy állandó fejlesztői alagutat egyéni lejárati idővel. A minimum 1 óra (1 óra) és a maximum 30 nap (30d).
devtunnel create myTunnelID Hozzon létre egy állandó fejlesztői alagutat egy egyéni alagútazonosítóval.
devtunnel create --tags my-web-app v1 Hozzon létre egy állandó fejlesztői alagutat, és alkalmazzon kereshető címkéket.
devtunnel list --tags my-web-app Listázhatja azokat a fejlesztői alagutakat, amelyek rendelkeznek a megadott címkék bármelyikével.
devtunnel list --all-tags my-web-app v1 Az összes megadott címkét tartalmazó fejlesztői alagutak listázása.
devtunnel show Az utoljára használt fejlesztői alagút részleteinek megjelenítése.
devtunnel show TUNNELID Egy fejlesztői alagút részleteinek megjelenítése.
devtunnel update TUNNELID -d 'my new tunnel description' Frissítse egy fejlesztői alagút leírását.
devtunnel update TUNNELID --remove-tags Távolítsa el az összes címkét egy fejlesztői alagútból.
devtunnel update TUNNELID --expiration 10d Frissítsen egy fejlesztői alagutat egy új egyéni lejárati idővel. A minimum 1 óra (1 óra) és a maximum 30 nap (30d).
devtunnel delete TUNNELID Fejlesztői alagút törlése.
devtunnel delete-all Törölje az összes fejlesztői alagutat.

Tipp.

A legtöbb CLI-parancs implicit módon működik az utoljára használt fejlesztői alagúton, de szükség esetén lehetőség van a fejlesztői alagút azonosítójának megadására.

Speciális: Fejlesztői alagút portjainak kezelése

A parancs használatával devtunnel create létrehozott fejlesztői alagút kezdetben nem rendelkezik portokkal. A devtunnel port következő parancsokkal adhat hozzá portokat üzemeltetés előtt:

Parancs Leírás
devtunnel port create Fejlesztői alagút portjának létrehozása
devtunnel port list Fejlesztői alagút portjainak listázása
devtunnel port show Fejlesztői alagút portjának részleteinek megjelenítése
devtunnel port update Fejlesztői alagút port tulajdonságainak frissítése
devtunnel port delete Fejlesztői alagút portjának törlése
Példák Leírás
devtunnel port create -p 3000 --protocol http Port hozzáadása a megadott protokollal
devtunnel port list TUNNELID Aktuális portok listázása
devtunnel port show TUNNELID -p 3000 A 3000-s port részleteinek megjelenítése
devtunnel port update -p 3000 --description 'frontend port' Fejlesztői alagút portjának leírásának frissítése
devtunnel port delete -p 3000 Port törlése

Port létrehozásakor szükség esetén megadható a protokoll, ha az automatikus észlelés nem működik megfelelően. Az aktuális beállítások a "http", a "https" vagy az "auto" (alapértelmezett). Ha a üzemeltetett port HTTPS, akkor ajánlott a portprotokollt "https" értékre állítani; egyébként az "auto" valószínűleg rendben van.

Miután konfigurálta a fejlesztői alagutat a fenti parancsokkal, kezdje el üzemeltetni:

devtunnel host

Speciális: Dev Tunnel-hozzáférés kezelése

Az alábbi parancsokkal a fejlesztői alagút hozzáférési jogkivonatai kibocsáthatók, hogy más ügyfelek számára is hozzáférést biztosítsanak a fejlesztői alagúthoz névtelen hozzáférés engedélyezése nélkül. A hozzáférés-vezérlési beviteli parancsok lehetővé teszik a hozzáférés-vezérlés konfigurálását fejlesztői alagutakon és fejlesztői alagútportokon.

Parancs Leírás
devtunnel token Fejlesztői alagút hozzáférési jogkivonatának kiadása
devtunnel access create Hozzáférés-vezérlési bejegyzés létrehozása
devtunnel access list Hozzáférés-vezérlési bejegyzések listázása
devtunnel access delete Hozzáférés-vezérlési bejegyzés törlése
devtunnel access reset A hozzáférés-vezérlés bejegyzéseinek alaphelyzetbe állítása alapértelmezettre

Íme néhány példa az alábbi parancsok használatára:

Példák Leírás
devtunnel token TUNNELID --scopes connect Szerezze be a "connect" hozzáférési jogkivonatot egy megosztott fejlesztői alagúthoz, amely ideiglenes hozzáférést biztosít a fejlesztői alagúthoz.
devtunnel access create TUNNELID --anonymous Névtelen ügyfélhozzáférés engedélyezése a fejlesztői alagúton.
devtunnel access create TUNNELID --anonymous --expiration 4h Névtelen ügyfélhozzáférés engedélyezése a fejlesztői alagútban egyéni hozzáférés-vezérlési lejárati idővel. A minimum 1 óra (1 óra) és a maximum 30 nap (30d).
devtunnel access create TUNNELID --port 3000 --anonymous Névtelen ügyfélhozzáférés engedélyezése a 3000-s porton.
devtunnel access create TUNNELID --tenant Engedélyezze az aktuális Microsoft Entra-bérlői hozzáférést a fejlesztői alagúton.
devtunnel access create TUNNELID --org ORG A GitHub-szervezet név szerinti hozzáférésének engedélyezése a fejlesztői alagúton.

Tipp.

A GitHub szervezeti hozzáféréséhez telepíteni kell a Dev Tunnels GitHub alkalmazást a szervezetbe.

Kiegészítő parancsok

Ezek a parancsok akkor használhatók, ha explicit módon be kell állítania vagy meg kell szüntetnie a legutóbb használt fejlesztői alagút helyi gyorsítótárát.

Parancs Leírás
devtunnel set Alapértelmezett fejlesztői alagút beállítása
devtunnel unset Alapértelmezett fejlesztői alagút törlése

Diagnosztikai parancsok

Parancs Leírás
devtunnel clusters Elérhető szolgáltatásfürtök listázása hely szerint
devtunnel echo Diagnosztikai echokiszolgáló futtatása helyi porton
devtunnel ping Diagnosztikai üzenetek küldése távoli echo-kiszolgálóra
Példák Leírás
devtunnel clusters --ping Az elérhető szolgáltatásfürtök listája mért késés szerint rendezve.
devtunnel echo http --port 8080 --interface 127.0.0.1 Helyi HTTP diagnosztikai kiszolgáló indítása a 8080-as porton.

Hibaelhárítás

A parancssori devtunnel felülettel kapcsolatos problémák elhárításához az alábbi tippek hasznosak lehetnek:

  • Győződjön meg arról, hogy a parancssori devtunnel felület legújabb verzióját használja. Ellenőrizze a jelenleg telepített verziót a következővel devtunnel --version: .
  • A --verbose beállítás kinyomtatja a hibakeresési üzeneteket, amelyek további diagnosztikai információkat nyújthatnak.