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

Nesta página, descrevemos como usar o controle de versão nos arquivos do aplicativo com o Suporte ao Git incorporado com o editor do Cloud Shell.

Como usar o controle de versão

Ao clicar na visualização de controle de origem: Git na barra de atividades Ícone de controle de origem, é possível acessar seus repositórios Git (ou criar um novo), visualizar as mudanças 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 seu repositório, como você faz ao importar uma amostra personalizada, é necessário autenticar com o Git. No entanto, se você estiver trabalhando com o Cloud Source Repositories, o Cloud Shell processará a autenticação automaticamente.

Quando você realiza uma ação que requer autenticação, o Git solicita uma senha. Será necessário inserir um token de acesso pessoal (PAT, na sigla em inglês), uma alternativa mais segura às senhas do Git. Consulte o guia Como criar um token de acesso pessoal para ver detalhes sobre como configurar seu PAT.

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 em cache seu PAT por 15 minutos. Para fazer isso, siga estas etapas:

  1. Inicie o terminal do editor do Cloud Shell selecionando Terminal > Novo terminal no menu.
  2. Execute este comando:

    $ git config --global credential.helper cache

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

Como alternar entre vários repositórios

É possível trabalhar em vários repositórios Git com o editor do Cloud Shell. Para alternar entre seus repositórios, clique no nome do repositório (exibido na barra de status do editor do Cloud Shell). No menu exibido, selecione o repositório para que você quer alterar o escopo. Isso atualiza o painel do controle de origem Git com o contexto do repositório escolhido.

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

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.

Primeiro, 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

Em seguida, de volta ao painel "Controle da origem: Git" no editor do Cloud Shell, escreva uma mensagem de confirmação e clique em "confirmar".ícone de confirmação (ou pressioneCmd/Ctrl +Entrar ) para verificar sua alteração.

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 usar no editor do Cloud Shell, você só precisa do URL do repositório. Para repositórios do GitHub, isso está disponível imediatamente na caixa de diálogo "Clone" ou "Download" ao visualizar a página principal do seu repositório.,

Inicie o Palette de comandos com Cmd/Ctrl+Shift+P e pesquise Git: Clonar Depois de selecionado, o editor do Cloud Shell solicita a localização do repositório Git.

Pesquisar comandos de Git na paleta de comandos

Como criar e alternar entre branches

Para criar uma nova ramificação ou mudar para trabalhar em uma ramificação existente, inicie a paleta de comandos com Cmd/Ctrl+Shift+P e pesquise Git: Checkout. Depois disso, selecione uma opção na lista de branches ou crie um novo branch local.

Barra de status do Git

Além da Paleta de comandos, você pode acompanhar sua ramificação atual e alternar para outra com o indicador de ramificação na barra de status do Git.

Além disso, você pode usar a ação Sincronizar alterações 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