Sobre modelos para 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 em um modelo em branco, escolher entre modelos mantidos por GitHub tecnologias populares, como React ou Jupyter Notebook, ou iniciar um codespace em qualquer repositório de modelos.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 contêineres de desenvolvimento e a imagem padrão, consulte Introdução aos contêineres de desenvolvimento.

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

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.

Criando um codespace a partir de um GitHub modelo

Os modelos mantidos por 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ê até a página "Your 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.

   

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

   

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

Quando você cria um novo codespace a partir de um modelo, ele sempre é aberto no Visual Studio Code cliente Web. Você pode reabrir um codespace existente em qualquer editor compatível. Para saber mais, 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, consulte 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.

   

   Observação

   Se você for um mantenedor do repositório de modelos e quiser confirmar alterações no próprio repositório de modelos, crie um codespace na lista suspensa Código. Para saber mais, confira Como criar um codespace para um repositório.

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

Publicando em um repositório em 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.

Publicação de 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.

   

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

   

   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.

   

4. Clique em 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 .

   

   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.

   

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

• Altere o tipo de máquina do seu espaço de código para garantir que você esteja usando recursos apropriados para o trabalho que está realizando (consulte Alterando o tipo de máquina para seu codespace).
• Permitir GitHub usar o GPG automaticamente para assinar confirmações que você faz em seu codespace (consulte Gerenciando a verificação GPG para GitHub Codespaces).
• Compartilhar segredos com seu codespace (consulte Gerenciando seus segredos específicos da conta no GitHub Codespaces).

Publicação de GitHub

Você pode publicar um codespace não publicado na página "Seus codespaces" em GitHub. 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ê até a página "Your 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.

   

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

   

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

Leitura adicional

• Como criar um codespace para um repositório
• Noções básicas sobre o ciclo de vida do codespace
• Usando controle de origem no seu codespace