Compartilhar via


Criar e hospedar um túnel de desenvolvimento

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

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

Install

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

Windows Gerenciador de Pacotes (winget)

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

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 de 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 de download direto:

Windows (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 o botão 'Variáveis de Ambiente...'
  4. Lá você vê duas tabelas, na tabela 'Variáveis do Sistema', localizar e selecionar 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 (o diretório significa excluir o nome do arquivo do caminho.
  8. Para localizar a cadeia de caracteres de diretório, navegue até o diretório no PowerShell ou terminal e digite 'pwd')
  9. Selecione 'Ok' em todas as janelas abertas e reinicie o prompt de comando.

Entrar

Para iniciar um túnel de desenvolvimento, primeiro você precisa fazer logon com uma conta de Microsoft Entra ID, Microsoft ou GitHub. Túneis Dev não suportam a hospedagem de túneis de forma anônima. Para obter mais informações, consulte a documentação de referência de comando da CLI .

devtunnel user login

Anfitrião

Depois de conectado, você pode começar a hospedar um túnel de desenvolvimento usando o host comando. No exemplo abaixo, os túneis de desenvolvimento serã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 o túnel de desenvolvimento, https://<tunnel_id>.usw2.devtunnels.ms:8080/ neste exemplo.
  • Inspecionar a 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.

Connect

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

  1. Visite essa URL em um navegador da Web.
  2. Faça logon 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