Códigos melhores com Bitbucket: quatro etapas iniciais

Agora, vamos começar a mexer com bits e buckets.

Passo 1: Coloque seu código no Bitbucket

Os repositórios são o código reside no Bitbucket. Há algumas maneiras de começar, dependendo de suas necessidades:

Começando do zero

Criar um novo repositório vazio

1. Clique em + na barra lateral global à esquerda e, em Criar novo, selecione Repositório.

2. Dê um nome para o repositório. Isso é muito importante. O nome do repositório vai estar na URL.

3. Defina a opção Incluir um README? como Sim, com um template.

4. Você pode deixar as outras como vêm por padrão e clicar em Criar.

De outro provedor

Importar um repositório de outro provedor de Git

1. Clique em + na barra lateral global à esquerda e, em Importar, selecione Repositório.

2. Use o URL pelo qual o repositório pode ser acessado.

3. Se o repositório precisar de autorização, marque Requer autorização e informe as credenciais de acesso.

4. Dê um nome para o repositório. Isso é muito importante. O nome do repositório vai estar na URL.

5. Você pode deixar as outras como vêm por padrão e clicar em Importar repositório.

Etapa 2: Configure com base na localização, colabore em nível global

Clonar um repositório do Bitbucket

1. Clique em + na barra lateral global à esquerda e, em Mãos à obra, selecione Clonar este repositório.

2. Selecione HTTPS no menu da parte superior direita (a não ser que você já tenha configurado as chaves SSH).

3. Copie o comando de clonagem.

Na CLI

• Altere para o diretório onde você quer clonar seu repositório. cd

• Cole o comando git clone que você copiou do Bitbucket (seria algo assim): git clone https://username@bitbucket.org/teamsinspace/documentation-test.git

Um novo subdiretório vai aparecer na sua unidade local com o mesmo nome do repositório que você clonou. Se você clonou um repositório vazio, talvez ainda não exista nada nesse diretório local. 

Fazer alterações no arquivo no Bitbucket online

Opa, eu não tenho nenhum arquivo no Bitbucket...

Você pulou a etapa opcional para adicionar um arquivo README ao seu repositório Bitbucket? Tudo bem! Se o repositório ainda estiver vazio, vá para o repositório e crie um agora clicando em Criar um README. Agora você tem algo para clonar além do repositório vazio.

Atualizações de pull do Bitbucket

Na CLI

1. Altere para o diretório onde você quer clonar seu repositório. cd

2. Cole o comando que você copiou do Bitbucket (é algo assim): git clone

Agora você baixou as mudanças feitas naqueles arquivos para o sistema local.

Etapa 3: Ramificação básica com o Bitbucket

As ramificações permitem que cada membro da equipe trabalhe em coisas diferentes ao mesmo tempo, sem afetar a base de código original ou o trabalho um do outro. Quando estiver com tudo pronto para mesclar as alterações, você envia a ramificação para o Bitbucket, para que ela possa ser analisada em uma pull request.

Existem algumas maneiras de criar ramificações, então escolha aquela que faça mais sentido para as necessidades da equipe.

Criar ramificação

Do Bitbucket (mais fácil)

1. No repositório, clique em + na barra lateral global e, em Mãos à obra, selecione Criar ramificação.

2. No pop-up exibido, selecione um Tipo (se estiver usando o Modelo de ramificação), insira um Nome de ramificação e clique em Criar.

Na CLI

1. Depois de criado, execute um git fetch e faça o checkout da ramificação no sistema local. O Bitbucket vai mostrar o comando necessário, e vai ser algo assim: git fetch && git checkout

2. Faça as alterações no local e depois adicione, faça o commit e envie as mudanças para a ramificação:

   git add.

   git commit -m "adicionando uma alteração da ramificação de função"git push origin

3. Clique na página de Fonte do repositório. Você deve ver tanto a main quanto a ramificação em um menu suspenso

De sua CLI

Na CLI, no diretório do repositório local

1. Crie uma ramificação usando o comando Ramificação do Git.

2. Liste as ramificações deste repositório. Você vai ver a ramificação principal padrão e a nova, que você criou. 

3. Faça o checkout da ramificação.

4. Envie a nova ramificação para o Bitbucket. 

Agora é hora de ir para o Bitbucket para ver a ramificação.

1. Vá para o repositório. 

2. Clique em Ramificações.

Do Jira

Isso requer que você tenha acesso ao Jira Software Cloud e o integre ao Bitbucket. Você vai precisar de permissões de administrador para fazer isso, mas, se quiser apenas brincar com a integração para ver como ela funciona, pode se inscrever para uma avaliação gratuita do Jira Software Cloud.

Leia Como conectar o Bitbucket Cloud ao Jira Software Cloud para obter instruções sobre como integrar os dois produtos depois de configurar o site do Jira.

Etapa 4: Analisar as alterações de código com uma solicitação pull

Depois que suas alterações de código forem enviadas para o Bitbucket, é hora da análise por um colega. As solicitações pull são uma maneira simples e eficaz de analisar seu código e colaborar no ambiente compartilhado com sua equipe.

Criar uma solicitação pull

1. No repositório aberto, clique em + na barra lateral global e selecione Criar uma solicitação pull em Mãos à obra.

2. Preencha o restante do formulário da solicitação pull:

1. Fonte: o repositório e a ramificação em que foram feitas as alterações do código em que você quer fazer a mesclagem.

2. Destino: o repositório e a ramificação para as quais você quer fazer a mesclagem das alterações.

3. Título e descrição: eles aparecem em notificações por e-mail, e o título aparece na lista de pull request.

4. Revisores: selecione revisores que vão dar feedback eficiente e que vão ter que aprovar as alterações.

5. Fechar ramificação: selecione se você quiser que o fechamento da ramificação seja automático depois da mesclagem da pull request.

6. Diff e Commits: nessas guias, você pode ver as alterações feitas (Diff) ou os commits incluídos.

1. Clique em Criar solicitação pull.

Você pode ver essa solicitação pull nas listas de solicitações pull na navegação lateral do seu repositório.

Analisar uma solicitação pull

Como revisor, você vai receber uma notificação de que tem uma pull request para analisar. Você também pode encontrar as pull requests abertas na guia Pull requests do Painel. Existem várias maneiras de analisar o código para garantir a qualidade, e cada equipe escolhe como vai fazer essa análise. Aqui estão algumas maneiras de estabelecer uma comunicação eficaz com os colegas para garantir que todos entendam o que está sendo alterado e aprovem a alteração que precisa de mesclagem.

Ver a comparação (diff) ao ver uma pull request, você vai ver as diffs (alterações) de todos os arquivos alterados na pull request. As linhas sombreadas em verde foram adicionadas, e as em vermelho, removidas. Você também pode clicar na guia Commits, na parte superior da pull request, para ver quais commits estão incluídos, algo útil para analisar pull requests grandes.

Oferecer feedback e fazer perguntas nos comentáriosNo Bitbucket, você pode deixar comentários na pull request como um todo, no arquivo específico ou em um local específico dentro do arquivo. Esse processo é útil quando você quer dar contexto ou especificidade aos seus comentários. Os comentários podem ter imagens, links, rich text e ter um URL exclusivo para que você possa compartilhar comentários específicos com rapidez.

Aprovar ou rejeitar uma pull requestDepois de analisar as alterações no código, você precisa informar ao autor da pull request se ela está pronta para a mesclagem. Clicar no botão Aprovar envia uma notificação ao autor da pull request e indica que você acha que a mesclagem das alterações pode ser feito com segurança. O oposto se aplica se você rejeitar a pull request. Depois que você recusar uma pull request, ela não vai poder ser reaberta. Para fazer a mesclagem da ramificação, vai ser necessário abrir uma nova pull request.

Observe que recusar uma solicitação pull não é bom para o autor e talvez deva ser reservado apenas para alterações que estejam muito erradas ou para trabalhos que não são mais necessários. Não esqueça de ser gentil ao revisar o trabalho de outras pessoas e sempre tente primeiro entender antes de tentar ser entendido.

Mesclagem de uma pull request Depois que o código for revisado e aprovado na pull request, clique no botão Mesclagem para fazer a mesclagem da ramificação com a principal. As alterações de código da ramificação de origem agora estão todas incorporadas na ramificação de destino.