Skip to main content

Como abrir um codespace existente

Você pode reabrir um codespace que fechou ou parou e retornar ao trabalho.

Observação: o uso dos GitHub Codespaces com IDEs do JetBrains está em versão beta pública e sujeito a alterações no momento.

Você pode reabrir um dos codespaces ativos ou interrompidos no GitHub.com em um IDE JetBrains, no Visual Studio Code ou usando a GitHub CLI. Você não pode reabrir um codespace que foi excluído. Para obter mais informações, confira "O ciclo de vida do codespace".

Você pode exibir todos os seus codespaces na página "Seus codespaces" em github.com/codespaces. Nesta página, você pode:

Como abrir um codespace existente

  1. Navegue até a página "Seus codespaces" em github.com/codespaces.

  2. Para abrir um codespace no editor padrão, clique no nome do codespace. Você pode definir seu editor padrão para Codespaces na sua página de configurações pessoais. Para obter mais informações, confira "Como configurar o editor padrão dos GitHub Codespaces".

    Para abrir o codespace em um editor diferente do padrão:

    1. Clique nas reticências ( ) à direita do codespace que você deseja abrir.
    2. Clique em Abrir em.
    3. Clique em Abrir no APLICATIVO.

    Captura de tela da página "Abrir em", com a opção "Abrir no Visual Studio Code" realçada

    Você pode abrir o codespace no:

    • Seu navegador
    • Visual Studio Code
    • JetBrains Gateway
    • JupyterLab

    Se você escolher Visual Studio Code ou JetBrains Gateway, verifique se você instalou o aplicativo selecionado em seu computador local.

    Se você escolher JupyterLab, o aplicativo JupyterLab deverá ser instalado no codespace. A imagem de contêiner padrão inclui o JupyterLab, portanto, os codespaces criados com base na imagem padrão sempre terão o JupyterLab instalado. Para obter mais informações sobre a imagem padrão, confira "Introdução aos contêineres de desenvolvimento" e ao repositório devcontainers/images. Se você não estiver usando a imagem padrão na configuração do contêiner de desenvolvimento, instale o JupyterLab adicionando o recurso ghcr.io/devcontainers/features/python ao arquivo devcontainer.json. Você deve incluir a opção "installJupyterlab": true. Para obter mais informações, confira o LEIAME do python recurso, no repositório devcontainers/features.

Observação: Para usar o GitHub Codespaces no VS Code, você deverá instalar a extensão do Codespaces. Para obter mais informações, confira "Como usar GitHub Codespaces no Visual Studio Code".

  1. No aplicativo da área de trabalho VS Code, abra a Paleta de Comandos com Command+Shift+P (Mac) ou Ctrl+Shift+P (Windows/Linux).

  2. Digite "Codespaces" e selecione um dos comandos a seguir.

    • Para abrir um codespace em uma nova janela do VS Code, selecione Codespaces: Abrir Codespace em Nova Janela
    • Para abrir um codespace no editor da Web, selecione Codespaces: Abrir no Navegador
  3. Clique no codespace que deseja alterar.

    Captura de tela de uma lista de codespaces no Visual Studio Code

Você também pode acessar os comandos listados acima navegando até a exibição do Gerenciador Remoto no VS Code e clicando com o botão direito do mouse no codespace que deseja abrir.

Captura de tela de um codespace selecionado no Gerenciador Remoto, com a opção "Abrir no Navegador" realçada

Note: If the Remote Explorer is not displayed in the Activity Bar:

  1. Access the Command Palette. For example, by pressing Shift+Command+P (Mac) / Ctrl+Shift+P (Windows/Linux).
  2. Type: codespaces.
  3. Click Codespaces: Details.
  1. Em um terminal, insira um dos seguintes comandos da GitHub CLI.

    • Para abrir um codespace no VS Code, insira:

      Shell
      gh codespace code

      Observação: é necessário ter o VS Code instalado no computador local. Para obter mais informações, confira "Como configurar o Visual Studio Code" na documentação do VS Code.

    • Para abrir um codespace no navegador, insira:

      Shell
      gh codespace code --web
    • Para abrir um codespace no JupyterLab, insira:

      Shell
      gh codespace code --jupyter

      Observação: O aplicativo JupyterLab deve ser instalado no codespace que você está abrindo. A imagem de contêiner padrão inclui o JupyterLab, portanto, os codespaces criados com base na imagem padrão sempre terão o JupyterLab instalado. Para obter mais informações sobre a imagem padrão, confira "Introdução aos contêineres de desenvolvimento" e ao repositório devcontainers/images. Se você não estiver usando a imagem padrão na configuração do contêiner de desenvolvimento, instale o JupyterLab adicionando o recurso ghcr.io/devcontainers/features/python ao arquivo devcontainer.json. Você deve incluir a opção "installJupyterlab": true. Para obter mais informações, confira o LEIAME do python recurso, no repositório devcontainers/features.

  2. Usando as teclas de direção, navegue até o codespace que deseja abrir.

  3. Para abrir o codespace, pressione Enter.

Para obter mais informações, confira gh codespace code no manual da GitHub CLI.

Se você definiu o JetBrains Gateway como o editor padrão, ele será iniciado automaticamente quando você abrir um codespace no GitHub.com.

Se o JetBrains Gateway não for o editor padrão, ainda será possível abrir um codespace nele acessando a página "Seus codespaces" em github.com/codespaces e clicando nas reticências (...) à direita do codespace que você deseja abrir. Para saber mais, confira "Como abrir um codespace existente".

Como alternativa, também é possível abrir o JetBrains Gateway e selecionar um codespace existente, conforme descrito no procedimento a seguir.

  1. Abra o aplicativo JetBrains Gateway.

  2. Clique em Conectar-se a Codespaces .

    Captura de tela da exibição inicial do JetBrains Gateway

  3. Na lista "Seus codespaces", clique no codespace em que você deseja trabalhar.

    Captura de tela da lista de codespaces do JetBrains Gateway

  4. Na lista "IDEs disponíveis", clique no IDE do JetBrains que você deseja usar. O Gateway lembrará de sua escolha na próxima vez que você se conectar a um codespace.

    Captura de tela da lista de codespaces do JetBrains Gateway

  5. Clique em Conectar.

    Nota: se você estiver executando um firewall, na primeira vez que se conectar a um recurso remoto, poderá ser solicitado que você permita que o JetBrains Gateway se comunique pela rede.