Encaminhar portas no seu código

Quando um aplicativo em execução em um codespace imprime a saída para o terminal que contém uma URL do localhost, como http://localhost:PORT ou http://127.0.0.1:PORT, a porta é encaminhada automaticamente. Se você estiver usando os GitHub Codespaces no navegador ou no Visual Studio Code, a cadeia de caracteres da URL no terminal será convertida em um link que acessa a página da Web no computador local. Por padrão, GitHub Codespaces encaminha portas usando HTTP.

Você também pode encaminhar uma porta manualmente, etiquetar portas encaminhadas, compartilhar portas encaminhadas com integrantes da sua organização, compartilhar as portas encaminhadas publicamente e adicione as portas encaminhadas à configuração do codespace.

Encaminhar uma porta

Você pode encaminhar manualmente uma porta que não foi encaminhada automaticamente. 1. No seu codespace, embaixo do editor de texto, clique em "Portas".

1. Na lista de portas, clique em Adicionar porta.

   

2. Digite o número da porta ou endereço e, em seguida, pressione enter.

   

Usando encaminhamento de HTTPS

Por padrão, GitHub Codespaces encaminha portas usando HTTP, mas é possível atualizar qualquer porta para usar HTTPS, conforme necessário. Se uma porta com visibilidade pública for atualizada para usar HTTPS, a visibilidade dela mudará automaticamente para privada.

1. No seu codespace, embaixo do editor de texto, clique em "Portas".
2. Clique com o botão direito do mouse na porta que deseja atualizar e posicione o cursor sobre Alterar Protocolo de Porta.
3. Selecione o protocolo necessário para esta porta. O protocolo que você selecionar será lembrado por esta porta durante o ciclo de vida do codespace.

Compartilhar uma porta

Se você quiser compartilhar uma porta encaminhada com outras pessoas, você pode tornar a porta privada da sua organização ou tornar a porta pública. Após tornar uma porta privada para a sua organização, qualquer pessoa na organização com a URL da porta poderá ver o aplicativo em execução. Após você tornar uma porta pública, qualquer pessoa que conheça a URL e o número da porta poderá ver o aplicativo em execução sem precisar efetuar a autenticação.

1. No seu codespace, embaixo do editor de texto, clique em "Portas".
2. Clique com o botão direito do mouse na porta que deseja compartilhar, selecione o menu "Visibilidade da Porta" e clique em Privado para Organização ou Público.
3. À direita do endereço local para a porta, clique no ícone copiar.
4. Envie a URL copiada para a pessoa com quem você deseja compartilhar a porta.

Etiquetar uma porta

Ao abrir um codespace no navegador ou no aplicativo da área de trabalho VS Code, você pode rotular uma porta encaminhada para facilitar a identificação em uma lista.

1. No seu codespace, embaixo do editor de texto, clique em "Portas".
2. Passe o mouse sobre a porta que você deseja etiquetar, em seguida, clique no ícone da etiqueta. 1. Digite uma etiqueta para a sua porta e pressione enter. ## Adicionar uma porta à configuração do código

É possível adicionar uma porta encaminhada à configuração dos GitHub Codespaces do repositório para que a porta seja encaminhada automaticamente a todos os codespaces criados do repositório. Depois de atualizar a configuração, todos os codespaces criados anteriormente deverão ser reconstruídos para que a alteração seja aplicada. Para obter mais informações, confira "Introdução aos contêineres de desenvolvimento".

Você pode configurar manualmente portas encaminhadas em um arquivo .devcontainer.json usando a propriedade forwardPorts, usar o painel "Portas" em um codespace aberto no navegador ou o aplicativo da área de trabalho VS Code.

1. No seu codespace, embaixo do editor de texto, clique em "Portas".
2. Clique com o botão direito do mouse na porta que deseja adicionar à configuração do codespace e clique em Definir Rótulo e Atualizar devcontainer.json. 1. Digite uma etiqueta para a sua porta e pressione enter.