Skip to main content

Conectando-se a uma rede privada

Você pode conectar GitHub Codespaces a recursos de uma rede privada, incluindo registros de pacotes, servidores de licenças e bancos de dados no local.

Sobre a rede do codespace

Por padrão, os seus códigos têm acesso a todos os recursos na internet pública, incluindo os gestores de pacotes, servidores de licença, bancos de dados e APIs da plataforma em nuvem, mas eles não têm acesso a recursos em redes privadas.

Conectando-se a recursos em uma rede privada

No momento, existem dois métodos de acesso a recursos em uma rede privada dentro dos GitHub Codespaces.

  • Com uma extensão GitHub CLI para configurar seu computador local como um gateway para recursos remotos.
  • Como usar uma VPN.

Como usar a extensão da CLI do GitHub para acessar recursos remotos

Aviso: A extensão GitHub CLI foi preterida e não tem mais suporte.

A extensão GitHub CLI permite que você crie uma ponte entre um codespace e seu computador local para que o codespace possa acessar qualquer recurso remoto que esteja acessível em seu computador. O codespace usa seu computador local como um gateway de rede para alcançar esses recursos. Para obter mais informações, confira "Como usar GitHub CLI para acessar recursos remotos."

Usar uma VPN para acessar recursos por trás de uma rede privada

Como alternativa à extensão GitHub CLI, você pode usar uma VPN para acessar recursos por trás de uma rede privada de dentro do seu codespace.

Recomendamos o uso de ferramentas de VPN como o OpenVPN para acessar recursos em uma rede privada. Para obter mais informações, confira "Como usar o cliente OpenVPN dos GitHub Codespaces".

Também existem várias soluções de terceiros que, embora não sejam aprovadas explicitamente pelo GitHub, oferecem exemplos de como fazer a integração com os GitHub Codespaces.

Essas soluções de terceiros incluem:

Permitir a listagem de recursos privados para codespaces

Embora o GitHub publique intervalos de IP para diversos produtos na respectiva API Meta, os endereços IP para codespaces são atribuídos dinamicamente, o que significa que não há como garantir que o codespace tenha o mesmo endereço IP todos os dias. Para obter mais informações, confira "Pontos de extremidade da API REST para metadados".

Como permitir um intervalo de IP inteiro daria um acesso excessivamente amplo a todos os codespaces (incluindo usuários não afiliados aos seus codespaces), a criação de codespace será desabilitada se você habilitar as listas de permissão de IP. Para obter mais informações, confira "Gerenciar endereços IP permitidos para sua organização".

Restringindo o acesso à internet pública

Atualmente, não há forma de restringir os codespaces de acessar a Internet pública ou de restringir o acesso de usuários devidamente autenticados a uma porta encaminhada.

Para obter mais informações sobre como proteger seus codespaces, confira "Segurança no GitHub Codespaces".