Gerenciar o controle de origem com o painel do Git

A extensão do painel do Git para o AWS Cloud9 fornece acesso conveniente à interface de usuário para comandos Git core e avançados.

Esta seção demonstra como acessar os principais recursos do Git para gerenciar o controle do código-fonte. Os procedimentos se concentram em usar o menu Git panel (Painel do Git) para executar comandos do Git em seu repositório e conteúdo.

Você também pode acessar qualquer comando Git suportado começando a inserir o nome na caixa de pesquisa no painel do Git:

Exibe uma janela mostrando os comandos do Git que são executados quando você interage com a interface do painel do Git. Para ver a atividade da linha de comando, acesse o menu Git panel (Painel do Git) e escolha Show Git Output (Mostrar saída do Git).

Inicialize ou clone um repositório Git

Um repositório Git (“repo”) contém o histórico completo de um projeto, desde o início. Um repositório consiste em todos os snapshots do conteúdo do projeto que foram capturados cada vez que você confirmou arquivos preparados nesse repositório.

O painel do Git suporta ambas as formas de obter um repositório Git:

• Inicialize um diretório existente como um repositório Git.

• Clone um repositório existente e copie-o no diretório local.

nota

As opções de interface para inicializar ou clonar um repositório estarão disponíveis somente se você ainda não tiver um repositório Git adicionado à pasta do espaço de trabalho em seu ambiente. Se você já tiver um diretório de trabalho para um repositório, a janela do painel do Git exibirá o status do diretório de trabalho e da área de preparação. O menu Git panel (Painel do Git) também está disponível para fornecer acesso aos comandos do Git que você pode executar no repositório.

Para inicializar ou clonar um repositório

1. Se o painel do Git ainda não estiver disponível, acesse-o escolhendo Window (Janela), Source Control (Controle de origem) e, em seguida, escolha o ícone do Git.

   nota

   Você também pode abrir o painel do Git usando o atalho de teclado Ctrl+Shift+G.

2. Escolha se deseja inicializar um novo repositório ou clonar um já existente.

   Initialize a repository

   • No painel do Git, escolha Initialize Repository (Inicializar repositório).

   • Em seguida, escolha uma pasta do espaço de trabalho onde o repositório Git será inicializado. Você pode inserir um caminho para a pasta, escolher um caminho ou escolher uma pasta em uma caixa de diálogo.

   • Se você estiver usando uma caixa de diálogo, selecione a pasta de destino e escolha Initialize Repository (Inicializar repositório).

   

   Depois de inicializar o repositório do Git na pasta selecionada, o painel do Git exibe todos os arquivos que já estiverem nessa pasta como não monitorados e prontos para serem adicionados à área de preparação do Git.

   

   Clone a repository

   • Na janela do painel do Git, escolha Clone Repository (Clonar repositório).

   • Em seguida, insira um URL para o repositório remoto que você deseja clonar (https://github.com/my-own-repo/my-repo-project-name.git, por exemplo, para clonar um repositório hospedado no GitHub) e pressione Return.

   • Na caixa de diálogo exibida, selecione uma pasta do espaço de trabalho para o repositório clonado e escolha Select Repository Location (Selecionar local do repositório).

   nota

   Se você estiver acessando um repositório hospedado em um site externo (GitHub, por exemplo), também será necessário inserir credenciais de login para que o site conclua o processo.

   Depois de clonar o repositório remoto na pasta selecionada, você pode executar o comando git pull para sincronizar o repositório local com as alterações mais recentes no repositório remoto. Para obter mais informações, consulte Trabalhar com repositórios remotos.

Preparação e confirmação de arquivos

Depois de obter um repositório Git, você pode começar a preenchê-lo com conteúdo usando um processo de duas etapas:

1. Adicione conteúdo não monitorado ou modificado recentemente à área de preparação.

2. Confirme os arquivos na área de preparação para o diretório de trabalho.

Importante

Talvez você não queira confirmar todos os arquivos em seu diretório de trabalho para o repositório. Por exemplo, é improvável que você queira adicionar arquivos gerados durante o tempo de execução ao repositório do seu projeto. Com o painel do Git, você pode marcar arquivos a serem ignorados, adicionando-os a uma lista em um arquivo .gitignore.

Para atualizar a lista no .gitignore, clique com o botão direito do mouse em um arquivo que não tenha sido adicionado à área de preparação e selecione Add File to .gitignore (Adicionar arquivo ao .gitignore). O IDE abre o arquivo .gitignore e o nome do arquivo selecionado é adicionado à lista de arquivos ignorados.

Para obter informações sobre como usar a correspondência de padrões no .gitignore para excluir tipos de arquivos, consulte a referência relevante no site git-scm.com.

Stage files

Os arquivos não monitorados (rotulados como “U”) e os arquivos modificados (rotulados como “M”), que não foram adicionados à área de preparação, estarão listados em Changes (Alterações) no painel do Git.

Usando a interface do painel do Git, você pode adicionar arquivos específicos ou todos os arquivos não monitorados e modificados à área de preparação:

• Arquivos específicos: pause no arquivo e, em seguida, escolha +para adicioná-lo à área de preparação. Como alternativa, clique com o botão direito no arquivo e escolha Unstage Change (Cancelar preparação de alterações).

• Todos os arquivos: Acesse o menu Git panel (Painel do Git) e selecione Stage All Changes (Preparar todas as alterações).

Os arquivos adicionados ao índice do repositório são listados em Staged Changes (Alterações preparadas). Arquivos não monitorados anteriormente são rotulados como “A” para indicar que eles foram preparados.

nota

Você também pode remover alterações específicas não preparadas ou todas as alterações. Para um único arquivo, pause o arquivo e, em seguida, escolha -. Como alternativa, clique com o botão direito e escolha Unstage Change (Cancelar preparação de alterações). Para desfazer todas as alterações, acesse o menu Git panel (Painel do Git) e escolha Unstage All Changes (Desfazer todas as alterações).

Commit files

Você pode usar o camndo commit do Git para capturar arquivos preparados, como um snapshot permanente no repositório. Usando a interface do painel do Git, você pode escolher quais arquivos serão confirmados:

• Confirme os arquivos na área de preparação: acesse o Painel do Git e selecione Commit (Confirmar) ou Commit Staged (Confirmar arquivos preparados).

• Confirmar todos os arquivos no diretório de trabalho: acesse o Painel do Git e selecione Commit All (Confirmar tudo). (Esta opção usa o git add para adicionar arquivos à área de preparação antes de chamar o git commit).

nota

Você também pode usar as opções amend e signed-off ao confirmar os arquivos com o painel do Git. A opção amend modifica a mensagem de confirmação da confirmação mais recente. A opção sign-off pode identificar quem executou a confirmação no log do Git.

Você também pode reverter uma confirmação no painel do Git, escolhendo Undo Last Commit (Desfazer a última confirmação).

Exibir diferentes versões do arquivo

Você pode comparar as versões de um arquivo que foi modificado após ele ter sido preparado ou confirmado.

• Arquivos listados em Changes (Alterações): Escolha “M” para exibir as diferenças entre a versão no diretório de trabalho e a versão que foi preparada recentemente ou confirmada no repositório.

• Arquivos listados em Staged Changes (Alterações preparadas): Escolha “M” para exibir as diferenças entre a versão na área de preparação e a versão que foi confirmada recentemente no repositório.

Depois de escolher “M”, uma janela do IDE exibe as diferenças entre as duas versões do arquivo. Um lado mostra a versão que é monitorada como atual no repositório. O outro lado mostra a versão modificada que ainda não foi confirmada.

Trabalhar com ramificações

O Git facilita muito o gerenciamento do fluxo de trabalho, permitindo que você trabalhe em novos recursos nas ramificações que são independentes da ramificação principal do repositório. Você pode alternar facilmente entre várias ramificações, garantindo que tenha sempre o código-fonte pronto para construir na ramificação principal.

Criar uma ramificação

Criar uma ramificação envolve a nomeação da ramificação e a seleção do ponto de partida dela.

1. No menu Git panel (Painel do Git), selecione Checkout to (Finalizar a compra). Selecione o nome da ramificação atual na parte inferior do painel do Git.

   

2. Escolha uma opção para criar uma nova ramificação:

   • Criar nova ramificação: a nova ramificação começa na última confirmação da ramificação atual.

   • Criar nova ramificação a partir de: a nova ramificação começa na última confirmação da ramificação que você selecionar em uma tela subsequente.

3. Insira o nome da nova ramificação.

4. Se você estiver especificando uma ramificação específica como o ponto de partida para a ramificação, selecione uma na lista.

Depois de mudar para a nova ramificação, você pode verificar o nome da ramificação atual visualizando a parte inferior do painel do Git.

nota

Se você estiver trabalhando com um repositório remoto, publique a nova ramificação no repositório remoto upstream para permitir que outras pessoas acessem o conteúdo.

Alternar ramificação

Uma das principais vantagens de gerenciar o controle de código-fonte com o Git é que você pode saltar entre diferentes projetos simplesmente alternando as ramificações.

Importante

Você não poderá alternar ramificações se tiver arquivos na ramificação atual que não foram confirmadas no repositório. Você deve primeiro limpar seu diretório de trabalho, confirmando ou criando um stash do seu trabalho.

1. Selecione o nome da ramificação atual na parte inferior do painel do Git. Como alternativa, vá para o Git panel (Painel do Git) e selecione Checkout to (Finalizar a compra para).

2. Escolha uma ramificação na lista exibida.

Depois de alternar, o diretório de trabalho do repositório é atualizado com versões de arquivo que foram confirmadas mais recentemente na ramificação selecionada.

Mesclar ramificações

Quando terminar de trabalhar em um recurso em uma ramificação discreta, geralmente você deverá integrar as alterações no projeto principal. Com o Git, este tipo de integração é facilitada pela mesclagem de uma ramificação (uma ramificação de recurso, por exemplo) com outra (geralmente a ramificação principal ou padrão do repositório).

1. Para selecionar uma ramificação na qual você mesclará outra ramificação, vá para o menu Git panel (Painel do Git) e escolha Checkout to (Finalizar a compra).

   Como alternativa, escolha o nome da ramificação atual na parte inferior do painel do Git.

2. Na lista exibida, escolha uma ramificação para a qual alternar.

3. Na caixa Search (Pesquisar) do painel do Git, comece a inserir a palavra “merge”.

   Quando Git: Merge Branch é exibido na lista de Comandos, escolha-o.

   

4. Na lista exibida, escolha uma ramificação para mesclar com a ramificação de destino.

   Se a mesclagem for concluída sem conflitos, a interface do painel do Git será atualizada para mostrar a ramificação de destino que contém as alterações mescladas.

Ao fazer a mesclagem de ramificações, você pode encontrar conflitos de mesclagem que resultam de alterações incompatíveis feitas no mesmo conteúdo. Se isso acontecer, você será avisado de que precisa resolver os conflitos antes de confirmar a mesclagem.

Você pode usar a janela do editor de código do IDE para identificar o conteúdo conflitante nas duas ramificações e, em seguida, fazer alterações para resolver as diferenças.

Trabalhar com repositórios remotos

Os repositórios remotos hospedados na Internet ou em uma rede facilitam a colaboração, permitindo que os membros da equipe compartilhem as alterações que comprometeram com suas responsabilidades locais. Ao usar comandos do Git que carregam e baixam os dados, você garante que o conteúdo do repositório “downstream” (local) seja sincronizado com os do repositório “upstream” (remoto).

Publicar uma ramificação em um repositório remoto

Depois de criar uma ramificação para um repositório local, ela será privada para você e não estará disponível para seus colaboradores até que você a envie “upstream” para o repositório remoto.

1. Para publicar a ramificação atual, vá até o menu Git panel (Painel do Git) e escolha Publish Branch (Publicar ramificação). Como alternativa, clique no símbolo da nuvem que está ao lado do nome da ramificação na parte inferior do painel do Git.

   

2. Se necessário, insira suas credenciais de login para acessar o repositório remoto.

Se a ramificação for publicada com êxito no repositório remoto, um símbolo de sincronização será exibido ao lado do nome da ramificação na parte inferior do painel do Git. Escolha-o para sincronizar o conteúdo dos repositórios locais e remotos.

Enviar e extrair conteúdo entre repositórios locais e remotos

Ao usar o Git para colaborar em um projeto compartilhado, você geralmente começa extraindo as alterações recentes feitas por outros membros da equipe do repositório remoto para o repositório local. E depois de confirmar as alterações no repositório local, você as envia ao repositório remoto para que elas possam ser acessadas pelo resto da equipe. Essas ações são executadas pelos comandos git pull e git push.

nota

Você precisa inserir suas credenciais de login ao enviar e extrair alterações entre a maioria dos repositórios hospedados (como aqueles no GitHub, por exemplo).

Pull changes from remote

Usando o comando git pull na interface do painel do Git, você pode atualizar o repositório remoto com as confirmações mais recentes em uma ramificação especificada em seu repositório local.

1. No menu Git panel (Painel do Git), selecione Checkout to (Finalizar a compra).

2. Na lista de ramificações, escolha a ramificação local para onde deseja levar as alterações.

3. Em seguida, acesse o menu Git panel (Painel do Git) e escolha Pull from (Extrair de).

4. Escolha um repositório remoto e, em seguida, uma ramificação nesse repositório, do qual extrair as alterações.

Depois de fazer um pull, você pode acessar os arquivos recuperados do repositório remoto no diretório de trabalho do repositório. Depois de modificar os arquivos, você pode enviar as alterações para a ramificação remota.

Push changes to remote

Usando o comando git push na interface do painel do Git, você pode atualizar o repositório remoto com as alterações mais recentes em uma ramificação especificada em seu repositório local.

1. No menu Git panel (Painel do Git), selecione Checkout to (Finalizar a compra).

2. Na lista de ramificações, escolha a ramificação local da qual deseja extrair as alterações.

3. Em seguida, acesse o menu Git panel (Painel do Git) e escolha Push to (Enviar para).

4. Escolha um repositório remoto e, em seguida, uma ramificação nesse repositório, do qual enviar as alterações.

Depois de fazer um push, outros membros da equipe podem acessar suas alterações levando-as para suas próprias cópias locais do repositório.

Armazenar e recuperar arquivos

Com o recurso de stash do Git, você pode alternar ramificações sem antes ter que confirmar os arquivos preparados ou modificados. O recurso de stash captura o status atual do diretório de trabalho e da área de preparação e o salva para uso posterior. Esse recurso é útil sempre que você ainda estiver trabalhando em conteúdo inacabado e precisar alternar as ramificações sem demora.

Trabalho do Stash

1. Para ocultar o estado atual do diretório de trabalho, acesse o menu Git panel (Painel do Git) e escolha uma das seguintes opções:

   • Stash: Todos os arquivos modificados ou preparados no diretório de trabalho são adicionados ao stash. Arquivos não monitorados não são adicionados.

   • Stash (incluir não monitoradas): todos os arquivos no diretório de trabalho, incluindo aqueles ainda não monitorados, serão adicionados ao stash.

2. Insira uma mensagem opcional que ajude você a identificar o stash para recuperação futura.

Após o stashing, a interface do painel do Git é atualizada para exibir o diretório de trabalho que foi limpo.

Recuperar um stash

1. Para recuperar um stash e aplicá-lo ao seu diretório de trabalho, acesse o menu Git panel (Painel do Git) e escolha uma das seguintes opções:

   • Aplicar Stash: aplique um stash selecionado ao seu diretório de trabalho e mantenha o stash para uso posterior.

   • Pop Stash (Excluir Stash): aplique um stash selecionado ao seu diretório de trabalho e exclua o stash da pilha de stash.

   nota

   Você também pode optar por aplicar ou executar o último stash que foi adicionado à pilha de stash.

2. Selecione um stash a ser aplicado ao diretório de trabalho.

A interface do painel do Git é atualizada para exibir seu diretório de trabalho com o stash aplicado.