Criar e hospedar um túnel de desenvolvimento

Os túneis de desenvolvimento são uma ferramenta poderosa para abrir de forma segura o seu localhost à internet e controlar quem tem acesso, para que possa testar e depurar facilmente as suas aplicações web e webhooks praticamente em qualquer lugar. Cria, aloja e liga-te ao teu primeiro túnel de desenvolvimento em segundos.

Neste guia rápido, vai aprender a criar, hospedar e conectar-se ao seu primeiro túnel de desenvolvimento em segundos.

Install

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

Windows Gestor de Pacotes (winget)

Podes usar o winget, o gestor de pacotes da Microsoft para Windows, para instalar e atualizar a CLI devtunnel.

winget install Microsoft.devtunnel

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

winget upgrade Microsoft.devtunnel

Script de PowerShell

Também pode instalar a devtunnel CLI usando o PowerShell e executar 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

Executar comandos com devtunnel em vez de ./devtunnel:

  1. Pressiona a tecla Windows e escreve 'Variáveis de ambiente'.
  2. Selecione a opção 'Editar as variáveis do ambiente do sistema'.
  3. Selecione o botão das 'Variáveis de Ambiente...'.
  4. Lá vês duas tabelas, na tabela 'System Variables', encontra e seleciona a variável 'PATH'.
  5. Seleciona o botão 'Editar...'.
  6. Deve surgir uma janela. Selecione o botão 'Novo'.
  7. Escreve o caminho do diretório do teu ficheiro devtunnel.exe (diretório significa excluir o nome do ficheiro do caminho).
  8. Para encontrar a cadeia de diretórios, pode navegar até ao diretório no PowerShell ou terminal e escrever 'pwd')
  9. Selecione 'Ok' em todas as janelas abertas e reinicie o prompt de comandos.

Iniciar sessão

Para iniciar um túnel de desenvolvimento, primeiro precisa de iniciar sessão com uma conta Microsoft Entra ID, Microsoft ou GitHub. O Dev Tunnels não suporta alojamento anónimo de túneis. Para mais informações, consulte a documentação de referência de comandos CLI .

devtunnel user login

Host

Depois de iniciar sessão, podes começar a hospedar um túnel de desenvolvimento usando o host comando. No exemplo abaixo, os túneis de desenvolvimento irão:

  • Executa um servidor local na porta 8080 que ecoa os pedidos que lhe são enviados.
  • Aloja um túnel de desenvolvimento para a porta 8080 local acessível pela 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 seguinte exemplo na consola.

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 aceder ao seu túnel de desenvolvimento, https://<tunnel_id>.usw2.devtunnels.ms:8080/ neste exemplo.
  • Inspect URL - O URL que podes usar para inspecionar o tráfego enviado através do túnel de desenvolvimento, https:/<tunnel_id>-8080-inspect.usw2.devtunnels.ms/ neste exemplo.

Connect

Para te ligares ao túnel de desenvolvimento, precisas de:

  1. Visite este URL num navegador web.
  2. Inicia sessão com a mesma conta que usaste para alojar o túnel de desenvolvimento. Por defeito, os túneis de desenvolvimento só estão acessíveis a ti.

Parabéns! Agora pode aceder ao seu serviço local através da internet.

Próximas Etapas

  • Last updated on