Como usar o controle de versão com o editor do Cloud Shell

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

Como usar o controle de versão

Ao clicar no controle de origem: visualização Git na barra de atividades Ícone de controle de origem, você pode acessar seus repositórios Git (ou criar um novo), visualizar alterações existentes e preparadas e mesclar alterações.

Daqui, você pode organizar e cancelar a fase de alterações, diferenças entre o estado anterior e a versão atual dos arquivos e confirmar as alterações, tudo isso no Cloud Shell Editor.

Como autenticar com o Git

Para extrair ou enviar alterações para seu repositório Git ou clonar o repositório, da mesma forma como você faz ao importar uma amostra personalizada, é necessário autenticar com o Git. Se você estiver trabalhando com o Cloud Source Repositories; No entanto, o Cloud Shell processa a autenticação para você automaticamente.

Quando você realiza uma ação que requer autenticação, o Git solicita uma senha. Digite um token de acesso pessoal (PAT, na sigla em inglês), uma alternativa mais segura para as 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 do Cloud Shell clicando em Terminal > New 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.

Como alternar entre vários repositórios

É possível trabalhar em diversos repositórios Git com o editor do Cloud Shell. Para alternar entre seus repositórios, clique no nome do repositório na barra de status do editor do Cloud Shell. 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.

Nome do repositório destacado na barra de status, clicado e menu "Editor" do Cloud Shell exibido com repositórios disponíveis.

Como exibir as alterações de trabalho

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.

Arquivos alterados, listados na seção Mudanças no Controle de origem: visualização do Git

Como ativar a visualização de diferenças

No painel controle de origem: Git, os arquivos alterados são listados em "Alterações" e, se você os preparou, em "Alterações preparadas". Clicar em qualquer um desses arquivos mostra a visualização de diferenças, mostrando o que mudou entre o estado confirmado anteriormente do arquivo e o estado atual.

Diferença entre o app.js antigo e o app.js alterado com as mensagens de confirmação e as alterações preparadas visíveis na visualização em árvore

Como confirmar mudanças

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

  1. Execute os seguintes comandos git usando o terminal do Cloud Shell:

    git config --global user.email you@example.com
    git config --global user.name YourName
    
  2. Para verificar sua alteração, no painel "Source Control: Git" no editor do Cloud Shell, escreva uma mensagem de confirmação e clique em ícone de confirmação Commit ou pressione Cmd/Ctrl + Enter.

Preenchido na mensagem de confirmação e as alterações preparadas visíveis na visualização em árvore

Como clonar um repositório

Para clonar um repositório Git remoto para uso no editor do Cloud Shell:

  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. Inicie a paleta de comandos clicando em Cmd/Ctrl+Shift+P e execute Git: Clone.
  3. Quando solicitado, digite o local do repositório Git.

Como criar e alternar entre branches

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

  1. Inicie a paleta de comandos clicando em Cmd/Ctrl+Shift+P e execute Git: Checkout.
  2. 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.

Barra de status do Git com o indicador de branch mostrando o branch principal como atual e a ação "Sincronizar Alterações" adjacente

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.

Barra de status do Git com indicador de branch que mostra o branch principal como atual e a ação Publicar adjacente