Skip to main content

Como criar um codespace com base em um modelo

Se você estiver iniciando um novo projeto, poderá criar um codespace com base em um modelo em branco ou escolher um modelo projetado especificamente para o tipo de trabalho que deseja realizar.

Sobre os modelos do GitHub Codespaces

Se você estiver iniciando um novo projeto, poderá começar o trabalho de desenvolvimento rapidamente criando um codespace com base em um modelo. Você poderá trabalhar no projeto em um ambiente de desenvolvimento baseado em nuvem, salvar os arquivos na nuvem e publicar o trabalho em um novo repositório remoto que poderá ser compartilhado com outras pessoas ou clonado no computador local.

Você pode começar com um modelo em branco, escolher entre os modelos mantidos pelo GitHub para tecnologias populares, como React ou Jupyter Notebook, ou iniciar um codespace usando qualquer repositório de modelos no GitHub.

Com um modelo em branco, você começará com um diretório vazio, com acesso a recursos de computação baseados em nuvem e às ferramentas, linguagens e ambientes de runtime que vêm pré-instalados com a imagem de contêiner de desenvolvimento padrão. Com outros modelos, você obterá arquivos iniciais para a tecnologia com a qual está trabalhando, além de, normalmente, alguns arquivos extras, como um arquivo README, um arquivo .gitignore e arquivos de configuração de contêiner de desenvolvimento que contenham alguma configuração de ambiente personalizada. Para obter mais informações sobre os contêineres de dev. e a imagem padrão, confira "Introdução aos contêineres de desenvolvimento".

Por exemplo, se você criar um codespace com base em um modelo React do GitHub, acessará um workspace contendo arquivos de modelo para um aplicativo simples, como index.js, app.js e package.json. Logo após a abertura do codespace, um servidor de desenvolvimento será iniciado automaticamente e você poderá ver o aplicativo em execução em uma guia de navegador simples no cliente Web do VS Code.

Captura de tela do navegador simples do VS Code renderizando o aplicativo Web no modelo do React do GitHub.

Os arquivos e a configuração incluídos nos modelos são definidos em repositórios de modelo. O repositório de modelos é clonado no codespace quando você cria o codespace. Depois disso, o link será cortado e o codespace não será vinculado a um repositório remoto até que você o publique em um.

Dica: para ajudar as pessoas a começar a usar a estrutura, a biblioteca ou outro projeto, você pode definir um repositório de modelos a ser usado com os GitHub Codespaces. Para obter mais informações, confira "Como configurar um repositório de modelos para os GitHub Codespaces".

Como criar um codespace com base em um modelo do GitHub

Os modelos mantidos pelo GitHub, incluindo o modelo em branco, estão disponíveis na página "Seus codespaces".

  1. No canto superior esquerdo de GitHub, selecione e clique em Codespaces para levar você à página "Seus codespaces" em github.com/codespaces.

  2. Para ver a lista completa de modelos, na seção "Explorar modelos de início rápido", clique em Ver tudo.

    Captura de tela da seção "Explorar modelos de início rápido". A opção "Ver tudo" está realçada com um contorno laranja escuro.

  3. Para ver o repositório de modelos que contém os arquivos de um modelo, você pode clicar no nome do modelo.

    Captura de tela da seção "Explorar modelos de início rápido" da página de codespaces. Três modelos estão listados e os nomes dos modelos estão realçados com contorno laranja.

  4. No nome do modelo que você deseja iniciar, clique em Usar este modelo.

Quando você cria um codespace a partir de um modelo, ele sempre é aberto no cliente Web Visual Studio Code. Você pode reabrir um codespace existente em qualquer editor compatível. Para obter mais informações, confira "Como abrir um codespace existente".

Como criar um codespace com base em um repositório de modelos

Você pode criar um codespace com base em qualquer repositório de modelos e publicar o trabalho em um novo repositório quando estiver pronto. Para obter mais informações sobre repositórios de modelos, confira "Criar um repositório a partir de um modelo".

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

  2. Clique em Usar este modelo e, em seguida, em Abrir em um codespace.

    Captura de tela do botão "Usar este modelo" e do menu suspenso expandido para mostrar a opção "Abrir em um codespace".

    Observação: se você é um mantenedor do repositório de modelos e quer fazer commit de alterações no próprio repositório de modelos, crie um codespace usando o menu suspenso Código. Para obter mais informações, confira "Como criar um codespace para um repositório".

Quando você cria um codespace a partir de um modelo, ele sempre é aberto no cliente Web Visual Studio Code. Você pode reabrir um codespace existente em qualquer editor compatível. Para obter mais informações, confira "Como abrir um codespace existente".

Como publicar em um repositório no GitHub

Quando você trabalha em um codespace criado com base em um modelo, seu trabalho é salvo em uma máquina virtual na nuvem, mas não é armazenado em um repositório no GitHub.

É possível salvar seus arquivos, fechar e parar o codespace e voltar mais tarde. Normalmente, o Git vem pré-instalado e o diretório de trabalho é inicializado automaticamente como um repositório Git, a menos que você tenha começado com o modelo em branco do GitHub. Isso significa que é possível usar o Git imediatamente para o controle do código-fonte local, como adicionar e confirmar arquivos.

No entanto, se você excluir um codespace não publicado ou ele for excluído automaticamente por não ser usado durante o período de retenção, seu trabalho também será excluído. Para manter seu trabalho e permitir que outras pessoas trabalhem no projeto, publique o codespace em um repositório no GitHub.

Observação: se um codespace não publicado atualmente for cobrado para uma organização, a publicação dele transfere a propriedade e a cobrança do codespace para sua conta pessoal. Confira "Sobre o faturamento do GitHub Codespaces".

Como publicar do VS Code

Se você estiver trabalhando em um codespace, poderá publicá-lo no cliente Web ou no aplicativo da área de trabalho do VS Code.

  1. Na Barra de Atividades, clique na exibição Controle do Código-Fonte.

    Captura de tela da Barra de Atividades do VS Code com o botão Controle do Código-Fonte realçado com um contorno laranja.

  2. Para preparar as alterações, clique em + ao lado do arquivo que você alterou ou ao lado de Alterações se tiver alterado vários arquivos e quiser preparar todos eles.

    Captura de tela da barra lateral "Controle do código-fonte" com o botão de preparo (um sinal de adição), à direita de "Alterações", realçada com um contorno laranja escuro.

    Observação: se você começar com o modelo em branco do GitHub, não verá uma lista de alterações, a menos que já tenha inicializado o diretório como um repositório Git. Para publicar codespaces criados por meio do modelo em branco, clique em Publicar no GitHub na exibição “Controle do Código-Fonte” e pule para a etapa 5.

  3. Para fazer commit das alterações preparadas, digite uma mensagem de commit descrevendo a alteração que você fez e clique em Fazer commit.

    Captura de tela da barra lateral "Controle do código-fonte" com uma mensagem de confirmação e, abaixo dela, o botão "Confirmar" realçado com um contorno laranja escuro.

  4. Clique em Publicar Branch.

    Captura de tela da barra lateral "Controle do código-fonte" mostrando o botão "Publicar Branch".

  5. Na lista suspensa "Nome do Repositório", digite um nome para o novo repositório e selecione Publicar no repositório privado do GitHub ou Publicar no repositório público do GitHub .

    Captura de tela do menu suspenso do nome do repositório no VS Code. Duas opções são mostradas, para publicação em um repositório público ou privado.

    O proprietário do novo repositório será a conta do GitHub com a qual você criou o codespace.

  6. Opcionalmente, no pop-up exibido no canto inferior direito do editor, clique em Abrir no GitHub para exibir o novo repositório no GitHub.

    Captura de tela de uma mensagem de confirmação para um repositório publicado com êxito, mostrando o botão "Abrir no GitHub".

Quando um codespace é publicado, você tem acesso a uma gama maior de opções para personalizar a experiência dos GitHub Codespaces. Por exemplo, você pode:

Como publicar do GitHub.com

Você pode publicar um codespace não publicado usando a página "Seus codespaces" no GitHub.com. Isso é útil para publicar um codespace que não está aberto no navegador no momento. Se você fizer isso, o trabalho será preservado em um repositório, mas não haverá um link entre o codespace existente e o novo repositório. No entanto, você pode navegar até o novo repositório e criar um codespace a partir daí, e esse codespace será conectado ao repositório.

  1. No canto superior esquerdo de GitHub, selecione e clique em Codespaces para levar você à página "Seus codespaces" em github.com/codespaces.

  2. Ao lado do codespace não publicado, clique nas reticências ( ... ) e selecione Publicar em um novo repositório.

    Captura de tela do menu suspenso de um codespace, mostrando a opção "Publicar em um novo repositório".

  3. Escolha um nome para o novo repositório, defina-o como Público ou Privado e clique em Criar repositório.

    Captura de tela da lista suspensa "Publicar em um novo repositório", com o campo "Nome", as opções "Público" e "Privado" e o botão "Criar repositório".

  4. Opcionalmente, para ver o novo repositório, clique em Ver repositório.

Leitura adicional