Créer et héberger un tunnel de développement

  • Article

Les tunnels de développement sont un outil puissant permettant d’ouvrir en toute sécurité votre localhost sur Internet et de contrôler qui a accès. Vous pouvez donc facilement tester et déboguer vos applications web et webhooks en tout lieu. Créez, hébergez et connectez-vous à votre premier tunnel de développement en secondes.

Dans ce guide de démarrage rapide, vous allez apprendre à créer, héberger et à vous connecter à votre premier tunnel de développement en secondes.

Installer

Avant de créer un tunnel de développement, vous devez d’abord télécharger et installer l’outil devtunnel CLI (interface de ligne de commande) qui correspond à votre système d’exploitation.

Gestionnaire de package Windows (winget)

Vous pouvez utiliser winget, gestionnaire de package de Microsoft pour Windows, pour installer et mettre à jour l’interface devtunnel CLI.

winget install Microsoft.devtunnel

Cette commande installe la dernière version par défaut et supprime l’ancienne version dans le même emplacement, qui est %LOCALAPPDATA%\Microsoft\WinGet\Packages. Pour spécifier une version, ajoutez-la --version <version_number> avec votre version souhaitée à la commande.

winget upgrade Microsoft.devtunnel

Script PowerShell

Vous pouvez également installer l’interface CLI à l’aide devtunnel de PowerShell et exécuter la commande suivante :

Invoke-WebRequest -Uri https://aka.ms/TunnelsCliDownload/win-x64 -OutFile devtunnel.exe
.\devtunnel.exe -h

Lien de téléchargement direct :

Windows (x64) - https://aka.ms/TunnelsCliDownload/win-x64

Exécutez des commandes avec devtunnel au lieu de ./devtunnel:

  1. Appuyez sur la touche Windows et tapez « Variables d’environnement ».
  2. Sélectionnez l’option « Modifier les variables d’environnement système ».
  3. Sélectionnez les « variables d’environnement... » Bouton.
  4. Vous voyez deux tables, dans la table « Variables système », recherchez et sélectionnez la variable « PATH ».
  5. Sélectionnez le bouton « Modifier... ».
  6. Une fenêtre doit s’afficher. Sélectionnez le bouton « Nouveau ».
  7. Tapez le chemin d’accès du répertoire de votre fichier devtunnel.exe (le répertoire signifie exclure le nom de fichier du chemin d’accès.
  8. Pour rechercher la chaîne de répertoire, vous pouvez accéder au répertoire dans PowerShell ou terminal et taper « pwd »
  9. Sélectionnez « Ok » sur toutes les fenêtres ouvertes et redémarrez l’invite de commandes.

Connexion

Pour démarrer un tunnel de développement, vous devez d’abord vous connecter avec un compte Microsoft Entra ID, Microsoft ou GitHub. Les tunnels de développement ne prennent pas en charge l’hébergement anonyme de tunnels pour plus d’informations, consultez la documentation de référence de la commande CLI.

devtunnel user login

Hôte

Une fois connecté, vous pouvez commencer à héberger un tunnel de développement à l’aide de la host commande. Dans l’exemple ci-dessous, les tunnels de développement sont les suivants :

  • Exécutez un serveur local sur le port 8080 qui fait écho aux demandes envoyées à celui-ci.
  • Hébergez un tunnel de développement pour le port 8080 local accessible à Internet.
# Start a http server on port 8080
devtunnel echo http -p 8080
# Tunnel port 8080
devtunnel host -p 8080

Une commande réussie host imprime quelque chose similaire à l’exemple suivant à la console.

Connecting to host tunnel relay wss://usw2-data.rel.tunnels.api.visualstudio.com/api/v1/Host/Connect/<tunnel_id>
Hosting port 8080 at https://<tunnel_id>.usw2.devtunnels.ms:8080/, https://<tunnel_id>-8080.usw2.devtunnels.ms/ and inspect it at https:/<tunnel_id>-8080-inspect.usw2.devtunnels.ms/
Ready to accept connections for tunnel: <tunnel_id>

Le texte imprimé contient :

  • tunnel_id - ID du tunnel de développement.
  • URL publique : URL qui peut être utilisée pour accéder à votre tunnel de développement, https://<tunnel_id>.usw2.devtunnels.ms:8080/ dans cet exemple.
  • URL d’inspection : URL que vous pouvez utiliser pour inspecter le trafic envoyé dans le tunnel de développement, https:/<tunnel_id>-8080-inspect.usw2.devtunnels.ms/ dans cet exemple.

Se connecter

Pour vous connecter au tunnel de développement, vous devez :

  1. Visitez cette URL dans un navigateur web.
  2. Connectez-vous à l’aide du même compte que vous avez utilisé pour héberger le tunnel de développement. Par défaut, les tunnels de développement ne sont accessibles qu’à vous.

Félicitations ! Vous pouvez désormais accéder à votre service local sur Internet.

Étapes suivantes