Criar e hospedar um túnel de desenvolvimento

Os túneis de desenvolvimento são uma ferramenta poderosa para abrir com segurança seu host local para a Internet e controlar quem tem acesso, para que você possa testar e depurar facilmente seus aplicativos da Web e webhooks de praticamente qualquer lugar. Crie, hospede e conecte-se ao seu primeiro túnel de desenvolvimento em segundos.

Neste guia de início rápido, você aprenderá a criar, hospedar e se conectar ao seu primeiro túnel de desenvolvimento em segundos.

Instalar

Antes de criar um túnel de desenvolvimento, primeiro você precisa baixar e instalar a devtunnel ferramenta CLI (Command Line Interface) que corresponde ao seu sistema operacional.

Gerenciador de pacotes do Windows (winget)

Você pode usar o winget, gerenciador de pacotes da Microsoft para Windows, para instalar e atualizar a devtunnel CLI.

winget install Microsoft.devtunnel

Esse comando instala a versão mais recente por padrão e remove a versão mais antiga no mesmo local, que é %LOCALAPPDATA%\Microsoft\WinGet\Packages. Para especificar uma versão, adicione --version <version_number> com a versão desejada ao comando.

winget upgrade Microsoft.devtunnel

Script do PowerShell

Você também pode instalar a CLI usando o devtunnel PowerShell e executando o seguinte comando:

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

Link para download direto:

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

Execute comandos com devtunnel em vez de ./devtunnel:

  1. Pressione a tecla Windows e digite 'Variáveis de ambiente'.
  2. Selecione a opção 'Editar as variáveis de ambiente do sistema'.
  3. Selecione as 'Variáveis de ambiente...' botão.
  4. Lá você vê duas tabelas, na tabela 'Variáveis do sistema', localize e selecione a variável 'PATH'.
  5. Selecione o botão 'Editar...'.
  6. Uma janela deve aparecer. Selecione o botão 'Novo'.
  7. Digite o caminho do diretório do arquivo devtunnel.exe (diretório significa excluir o nome do arquivo do caminho.
  8. Para localizar a cadeia de caracteres do diretório, você pode navegar até o diretório no PowerShell ou no terminal e digitar 'pwd')
  9. Selecione 'Ok' em todas as janelas abertas e reinicie o prompt de comando.

Logon

Para iniciar um túnel de desenvolvimento, primeiro você precisa fazer logon com uma conta do Microsoft Entra ID, Microsoft ou GitHub. Os túneis de desenvolvimento não oferecem suporte à hospedagem de túneis anonimamente, para obter mais informações, consulte a documentação de referência de comando da CLI.

devtunnel user login

Host

Uma vez conectado, você pode começar a hospedar um túnel de desenvolvimento usando o host comando. No exemplo abaixo, os túneis de desenvolvimento irão:

  • Execute um servidor local na porta 8080 que ecoa as solicitações enviadas a ele.
  • Hospede um túnel de desenvolvimento para a porta 8080 local acessível à Internet.
# Start a http server on port 8080
devtunnel echo http -p 8080
# Tunnel port 8080
devtunnel host -p 8080

Um comando bem-sucedido host imprime algo semelhante ao exemplo a seguir no 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>

O texto impresso contém:

  • tunnel_id - O ID do túnel de desenvolvimento.
  • URL pública - A URL, que pode ser usada para acessar seu túnel de desenvolvimento, https://<tunnel_id>.usw2.devtunnels.ms:8080/ neste exemplo.
  • Inspecionar URL - A URL que você pode usar para inspecionar o tráfego enviado pelo túnel de desenvolvimento, https:/<tunnel_id>-8080-inspect.usw2.devtunnels.ms/ neste exemplo.

Conectar

Para se conectar ao túnel de desenvolvimento, você precisa:

  1. Visite este URL em um navegador da Web.
  2. Faça login usando a mesma conta que você usou para hospedar o túnel de desenvolvimento. Por padrão, os túneis de desenvolvimento só são acessíveis para você.

Parabéns! Agora você pode acessar seu serviço local pela internet.

Próximas etapas