Controle de versões com o Cloud Workstations

Nesta página, descrevemos como usar o controle de versão para os arquivos do seu aplicativo com o suporte Git do editor base do Cloud Workstations.

Clique em Source Control na barra de atividades para criar um novo repositório Git, acessar seus repositórios Git existentes, ver alterações existentes e graduais ou mesclar alterações.

Aqui, você pode preparar e remover mudanças, diferenciar o estado anterior e a versão atual dos arquivos e confirmar alterações, tudo no editor básico.

Autenticar com o Git

Para extrair ou enviar alterações para seu repositório Git ou clonar seu repositório, da mesma forma que você faz ao importar uma amostra personalizada, é preciso autenticar com o Git.

Quando você realiza uma ação que requer autenticação, o Git solicita uma senha. Insira um token de acesso pessoal (PAT, na sigla em inglês), que é uma alternativa mais segura às senhas do Git. Para detalhes sobre como configurar seu PAT, consulte o guia Como criar um token de acesso pessoal.

Para tornar seu fluxo de trabalho mais eficiente e evitar a necessidade de inserir seu PAT várias vezes, ative o auxiliar de credenciais para permitir que o Git armazene seu PAT em cache por 15 minutos:

  1. Inicie o terminal do editor base do Cloud Workstations clicando em Terminal > Novo Terminal.
  2. Execute este comando:

    git config --global credential.helper cache
    

Para mais opções de personalização, como alterar o tempo limite e especificar um caminho local para o armazenamento de credenciais, consulte a documentação Ferramentas do Git - Armazenamento de credenciais.

Alternar entre vários repositórios

É possível trabalhar em vários repositórios Git com o editor base do Cloud Workstations. Para alternar entre seus repositórios, na barra de status do editor base do Cloud Workstations, clique no nome do seu repositório. No menu, selecione o repositório para alterar o escopo.

Isso atualiza o controle de origem: painel do Git com o contexto do repositório escolhido.

Mostrar as mudanças que estão funcionando

Quando você adiciona, modifica e exclui arquivos, essas alterações são refletidas na seção "Alterações" no painel controle de origem: Git. Você pode optar por abrir o arquivo selecionado, preparar essas alterações, descartar alterações ou ver quais mudanças estão sendo feitas nessa confirmação.

Ativar a visualização de diferenças

No painel "Controle de origem: Git", os arquivos modificados são listados em "Mudanças". Se você tiver preparado os arquivos alterados, eles também serão listados em "Alterações graduais". Clique em qualquer um desses arquivos para exibir a visualização de diferenças, mostrando o que mudou entre o estado confirmado anteriormente do arquivo e o estado atual.

Confirmar alterações

Quando estiver pronto para verificar suas alterações, você poderá fazer isso diretamente no Cloud Workstations.

  1. Execute os comandos git a seguir usando o terminal do Cloud Workstations. Não se esqueça de atualizar o e-mail e o nome com seus dados:

    git config --global user.email alex@example.com
    git config --global user.name Alex
    
  2. Para verificar sua mudança, no painel "Source Control: Git" no editor base, escreva uma mensagem de confirmação e clique em check_boxCommit ou pressione Control+Enter (ou Command+Enter no Mac OS).

Clonar um repositório

Para clonar um repositório Git remoto para uso no editor básico do Cloud Workstations:

  1. Recupere o URL do repositório: para repositórios do GitHub, abra a página principal do seu repositório e, em seguida, abra a caixa de diálogo "Clonar" ou "Fazer download".
  2. Para abrir o Palette de comandos, pressione Control+Shift+P (ou Command+Shift+P no macOS) ou clique em View > Command Palette.
  3. Execute Git: Clone.
  4. Quando solicitado, digite o local do repositório Git.

Criar e alternar entre ramificações

Para criar uma nova ramificação ou mudar para uma ramificação existente:

  1. Para abrir o Palette de comandos, pressione Control+Shift+P (ou Command+Shift+P no macOS) ou clique em View > Command Palette.
  2. Execute Git: Checkout.
  3. Selecione uma opção na lista de ramificações ou crie uma nova filial local.

Barra de status do Git

A barra de status do Git fornece uma maneira de acompanhar sua ramificação atual e alternar para outra com o indicador da ramificação. Ele também fornece a ação Synchronize Changes para verificar se há alterações entre o repositório local e a ramificação upstream. A sincronização envia as alterações locais para o branch upstream e extrai as alterações remotas no seu repositório local.

Se você não tiver um branch upstream configurado, a ação Publicar estará disponível para enviar as alterações locais a um repositório remoto.