Como facilitar a criação rápida e a retomada de codespaces

Adicione um link para levar as pessoas diretamente a uma página para criar um codespace, com sua escolha de opções previamente configurada. Como alternativa, você pode fornecer um link para a página "Retomar codespace".

Neste artigo

Visão geral

Você pode facilitar para as pessoas trabalharem no seu repositório em um codespace fornecendo um link para a página de criação do codespace. Um lugar em que é interessante fazer isso é no arquivo LEIAME do repositório. Por exemplo, você pode adicionar o link para uma notificação "Abrir no GitHub Codespaces".

Captura de tela de uma notificação "Abrir no GitHub Codespaces" em uma página LEIAME.

O link para a página de criação do codespace pode incluir opções de configuração específicas para ajudar as pessoas a criar um codespace apropriado. As pessoas que usam o link poderão escolher opções diferentes, se desejarem, antes de criar o codespace. Para obter informações sobre as opções disponíveis, confira "Como criar um codespace para um repositório".

Como alternativa, você pode fornecer um link para a página "Retomar codespace", que oferece uma forma rápida de as pessoas abrirem um codespace no qual estavam trabalhando recentemente.

Como criar um link para a página de criação do codespace para seu repositório

Você pode usar essas URLs para vincular à página de criação de codespace do repositório. Substitua o texto em letras maiúsculas.

  • Crie um codespace para o branch padrão do repositório: https://codespaces.new/OWNER/REPO-NAME
  • Crie um codespace para um branch específico do repositório: https://codespaces.new/OWNER/REPO-NAME/tree/BRANCH-NAME
  • Crie um codespace para o branch do tópico de uma solicitação de pull: https://codespaces.new/OWNER/REPO-NAME/pull/PR-SHA

Como configurar mais opções

Use a opção "Compartilhar um link profundo" para configurar mais opções para o codespace e criar uma URL personalizada e, em seguida, copiar um snippet Markdown ou HTML para uma notificação "Abrir no GitHub Codespaces".

  1. Em GitHub, acesse a página principal do repositório.

  2. Caso deseje criar um link para um branch diferente do branch padrão do repositório, no nome do repositório, clique no botão rotulado com o nome do branch atual. No menu suspenso, selecione o branch para o qual deseja criar um link.

    Captura de tela do menu suspenso do branch expandido, listando vários branches. O menu suspenso, rotulado com um ícone de branch e "trunk" está realçado com um contorno laranja escuro.

  3. Clique no botão Código, depois clique na guia Codespaces.

  4. Para abrir a janela "Compartilhar configuração do codespace", no canto superior direito da guia Codespaces , selecione e clique em Compartilhar um link profundo.

    Captura de tela do menu suspenso de opções na guia "Codespaces". A opção "Compartilhar um link profundo" está realçada com um contorno laranja.

  5. Opcionalmente, para levar os usuários a uma página em que eles possam retomar rapidamente um codespace recente ou criar um, selecione Início rápido. Para obter mais informações, confira "Como criar um link para retomar um codespace".

  6. Opcionalmente, para especificar uma configuração de contêiner de desenvolvimento, selecione Arquivo de configuração e use o menu suspenso para escolher uma configuração. Se você não especificar uma configuração, a configuração padrão do repositório será usada. Para obter mais informações, confira "Introdução aos contêineres de desenvolvimento".

  7. Em "Snippets", você pode copiar a URL criada ou copiar um snippet Markdown ou HTML, incluindo uma notificação "Abrir no GitHub Codespaces". Para copiar a URL ou o snippet, selecione o espaço entre as guias URL, HTML e Markdown e clique em .

    Captura de tela da janela "Compartilhar configuração do codespace". Ao lado da URL do "novo codespace", um ícone de dois quadrados sobrepostos está realçado em laranja.

Você pode criar um link para uma página para retomar o codespace mais recente que corresponde ao repositório, ao branch e às outras opções especificadas na URL.

Adicione ?quickstart=1 a uma URL codespaces.new, como as URLs listadas na seção anterior deste artigo. Isso produz uma URL que exibe uma página "Retomar codespace".

Por exemplo, a URL https://codespaces.new/octo-org/octo-repo?quickstart=1 abre uma página para permitir que você retome o codespace mais recente para o branch padrão do repositório octo-org/octo-repo.

Captura de tela da página "Retomar codespace" que mostra os botões "Retomar este codespace" e "Criar um".

Observações:

  • Se a URL codespaces.new já contiver uma cadeia de consulta, adicione &quickstart=1 ao final da cadeia de consulta.
  • Esse tipo de URL sempre abrirá um codespace no cliente Web do VS Code, mesmo que isso não esteja definido como o editor padrão para o GitHub Codespaces.

Se nenhum codespace correspondente for encontrado, a página será intitulada "Criar codespace" e um botão será exibido para criar um codespace com parâmetros correspondentes.

Esse tipo de URL é útil, por exemplo, em um LEIAME do repositório, pois fornece às pessoas uma forma de criar um codespace ou retomar o codespace, em apenas alguns cliques.

Como criar uma notificação "Abrir em GitHub Codespaces"

Dica: use a opção "Compartilhar um link profundo" para criar um snippet de Markdown ou HTML que inclua uma notificação "Abrir no GitHub Codespaces" com uma URL personalizada. Para obter mais informações, confira "Como configurar mais opções".

  1. Obtenha a URL para a página de criação do codespace ou a página "Retomar codespace", conforme descrito nas seções anteriores.

  2. Adicione o seguinte markdown, por exemplo, ao arquivo README.md do repositório:

    Markdown
    [![Open in GitHub Codespaces](https://github.com/codespaces/badge.svg)](URL)

    Por exemplo:

    [![Open in GitHub Codespaces](https://github.com/codespaces/badge.svg)](https://codespaces.new/github/docs)

    O exemplo de Markdown é renderizado da seguinte maneira:

    Abrir no GitHub Codespaces.