Objetivo

Inicia un repositorio con un compañero y obtén comentarios sobre tu cambio.

Resumen de la misión

Hasta el momento, eres la única persona que ha trabajado en un repositorio. Pero ¿qué ocurre si quieres colaborar con tus compañeros de equipo en un repositorio? Puedes hacerlo tanto si te encuentras en la misma sala como si estás en la otra parte del mundo.

Tiempo Público Requisitos previos
15 minutos Cuentas con algo de experiencia en el uso de Bitbucket Cloud. En caso contrario, consulta uno de nuestros tutoriales para principiantes. Regístrate en Bitbucket Cloud
Ninguno Para aquellos que prefieren usar una interfaz de usuario gráfica de Git con Bitbucket Cloud Regístrate en Sourcetree

Acerca de las ramas y solicitudes de extracción

Cuando trabajas en un equipo con varios usuarios de Bitbucket, querrás trabajar en tu propio conjunto de código de forma independiente del código base principal. Esto es lo que te permiten hacer las ramas. Una rama representa una línea de desarrollo independiente para tu repositorio. Piensa que es como un directorio de trabajo, un área de entorno de ensayo y un historial de proyecto completamente nuevos. Tras crear una rama, trabajas en el código y lo confirmas para dicha rama, incorporas actualizaciones de Bitbucket para mantener la rama actualizada y envías todo tu trabajo a Bitbucket.

Una vez que tienes cambios de código en una rama en Bitbucket, puedes crear una solicitud de extracción, que es donde se produce la revisión del código. Tus compañeros de equipo añadirán comentarios a tu código con sus opiniones y preguntas y, por último (con suerte), aprobarán la solicitud de extracción. Cuando tengas un número suficiente de aprobaciones, fusiona la solicitud de extracción para poder fusionar la rama en el código principal.

Crea un repositorio y añade a un compañero de equipo

Acabas de llegar a la estación espacial de Bitbucket y es hora de pasar por el proceso de orientación, parte del cual implica realizar actualizaciones en tu paquete de bienvenida y obtener su aprobación. Para comenzar, te guiaremos en el proceso de creación de un repositorio de equipo con algo de contenido y al proporcionar acceso a los usuarios.

  1. Haz clic en + en la barra lateral global y selecciona Repositorio en Crear.

  2. Asegúrate de que el equipo que has creado es el propietario del repositorio.

  3. Introduce el nombre que desees como nombre del proyecto y nombre del repositorio. Si no sabes ninguno, prueba con Welcome package y First impressions, respectivamente.

  4. En ¿Incluir un README?, selecciona cualquiera de las opciones .

  5. En Sistema de control de versiones, selecciona una opción para el tipo de repositorio que desees crear. Si no estás seguro, déjalo tal cual.

  6. Haz clic en Crear repositorio y se te redirigirá a la vista de la marca Fuente , nuevo repositorio.

  7. En Fuente, selecciona > Añadir archivo.

  8. Nombra el archivo survey.html, copia este código y pégalo en el área de texto principal.

\<\!DOCTYPE html><html><head> <meta http-equiv="Content-Type" content="text/html; charset=utf-8"> <style media="screen" type="text/css"> body { margin: auto; width: 700px; color: #FFFFFF; font-family: Arial, sans-serif; background-color: #172B4D; } body>h1 { margin: 50px; font-size: 50px; text-align: center; color: #0052CC; } </style></head><body> <h1>Team up in space</h1> <p> Welcome to the team! You've made it this far so we know that you've got the potential to do great things. Because you're going to be collaborating with other awesome people, anything you add needs to be code reviewed and approved. That's just how a team works! You should have already created a branch and checked it out locally. If you haven't, go back to the tutorial and do that now. We'll be here. </p> <p> Because you're on your own branch, you can go crazy. Spice up this file any way you like. Add more files to this repository if you see fit. If want to take it slow and are just here to learn about pull requests, you can use this opportunity to fill out our short questionaire. </p> <br> <p> <b>Question 1</b>: Have you used pull requests before? </p> <p> <b>Answer 1</b>: **** Your answer here **** </p> <p> <b>Question 2</b>: Why do you want to learn about code review? </p> <p> <b>Answer 2</b>: **** Your answer here **** </p> <p> <b>Question 3</b>: Who do you plan to work with on Bitbucket? </p> <p> <b>Answer 3</b>: **** Your answer here **** </p></body></html>
  1. Haz clic en Confirmar y, a continuación, de nuevo en Confirmar en el cuadro de diálogo.

Tu repositorio tiene bastante buen aspecto. Echa un vistazo si te apetece. Si haces clic en Configuración y vas a la página Acceso de usuario y grupos , verás que el compañero de equipo breezycloud que has añadido tiene acceso al repositorio a través del grupo Desarrolladores .

Clona y haz un cambio en la nueva rama

En un contexto habitual de equipo, lo más probable es que hayas clonado el repositorio antes de crear una rama. Así que eso es lo que vamos a hacer en primer lugar, antes de configurar tu propia rama.

Si estás usando una línea de comandos

Paso 1. Clona el repositorio a tu sistema local

Vamos a acceder a tu sistema local para que puedas empezar a trabajar en ello.

  1. En el repositorio, haz clic en el botón Clonar en la parte superior derecha.
    Bitbucket muestra el cuadro de diálogo Clonar este repositorio. De forma predeterminada, el cuadro de diálogo de clonación establece el protocolo como HTTPS o SSH, en función de la configuración. En consecuencia, no es necesario cambiar el protocolo predeterminado.
  2. Copia el comando "clone".

  3. En una ventana de terminal, cambia al directorio local donde quieres clonar tu repositorio.

$ cd ~/<path_to_directory>
  1. Pega el comando que has copiado de Bitbucket, por ejemplo:
$ git clone https://breezy@bitbucket.org/powerstars/first-impressions.git

Cloning into 'first-impressions'...
Password for 'https://breezycloud@bitbucket.org': 
remote: Counting objects: 6, done.
remote: Compressing objects: 100% (5/5), done.
remote: Total 6 (delta 1), reused 0 (delta 0)
Unpacking objects: 100% (6/6), done.

Para más información, consulta nuestro vídeo sobre clonación para ver cómo se hace:

Paso 2. Crea una rama e incorpora cambios a nivel local

Ahora que se ha configurado todo el repositorio, empieza lo interesante. Puedes crear ramas de forma local o a través de Bitbucket. En este tutorial, vamos a crear una rama a través de Bitbucket.

  1. Haz clic en Ramas en el panel de navegación izquierdo. Verás que ya tienes una rama (la rama principal), master.

  2. Click Crea una rama en la esquina superior derecha.

  3. Una vez que crees la rama, debes comprobar que funciona en tu sistema local. Bitbucket proporciona los comandos "fetch" y "checkout" que puedes copiar y pegar en la línea de comandos, de forma parecida a lo siguiente:

$ git fetch && git checkout my-updates

Password for 'https://breezycloud@bitbucket.org': 
From https://bitbucket.org/planetbreezycloud/first-impressions
 * [new branch]      my-updates -> origin/my-updates
Branch 'my-updates' set up to track remote branch 'my-updates' from 'origin'.
Switched to a new branch 'my-updates'

Como ves, has cambiado a tu nueva rama en el entorno local, lo que te permite actuar en esa línea de código independiente y aplicar en ella el comando "push".

Paso 3. Realizar un cambio en la rama

Ahora, te toca a ti hacer algunos cambios en tu repositorio. Como menciona el archivo, puedes complicar o simplificar el proceso tanto como quieras. Cambia el CSS, añade más archivos, crea una obra maestra o simplemente responde las preguntas.

  1. Abre el archivo survey.html (o el archivo con el nombre que hayas elegido) con un editor de texto.

  2. Haz tus cambios, ya sean grandes o pequeños, y, a continuación, guarda y cierra el archivo.

  3. En la ventana de terminal, debes encontrarte aún en el directorio de repositorio a menos que hayas realizado algún cambio. Muestra el estado del repositorio con el comando git status. Verás el archivo survey.html que has modificado. Si has añadido o modificado otros archivos, también los verás.

$ git status
On branch my-updates
Your branch is up-to-date with 'origin/my-updates'.
Changes not staged for commit:
  (use "git add <file>..." to update what will be committed)
  (use "git checkout -- <file>..." to discard changes in working directory)
        modified:   survey.html
no changes added to commit (use "git add" and/or "git commit -a")
  1. Para añadir tus cambios en el entorno local, usa git add :
$ git add survey.html
  1. Confirma tus cambios en el entorno local con git commit -m "your commit message":
$ git commit -m "Answered questions"
[my-updates 7506040] Answered questions
 1 file changed, 3 insertions(+), 3 deletions(-)
  1. Introduce git push origin para aplicar los cambios a tu rama en Bitbucket y especifica tu contraseña para terminar de aplicar los cambios.
$ git push origin my-updates

Password for 'https://breezycloud@bitbucket.org': 

Counting objects: 3, done.

Delta compression using up to 8 threads.

Compressing objects: 100% (3/3), done.

Writing objects: 100% (3/3), 350 bytes | 350.00 KiB/s, done.

Total 3 (delta 1), reused 0 (delta 0)

To https://bitbucket.org/planetbreezycloud/first-impressions.git

   454ccaf..7506040  my-updates -> my-updates

Branch master set up to track remote branch master from origin.
  1. En Bitbucket, haz clic en la página Fuente de tu repositorio. Debes ver ambas ramas en la lista desplegable. Todas las confirmaciones que realices en my-updates también aparecerán en dicha rama.

Si estás usando Sourcetree

Paso 1. Clona el repositorio a tu sistema local

Vamos a acceder a tu sistema local para que puedas empezar a trabajar en ello.

  1. En el repositorio, haz clic en + en la barra lateral global y selecciona Clonar este repositorio en Empezar a trabajar.
  2. Haz clic en el botón Clonar en Sourcetree .
  3. En la ventana Clonar nuevo, actualiza la ruta de destino a /first-impressions/.
  4. Haz clic en el botón Clonar .

Para ver cómo se hace, consulta la parte correspondiente a clonar un repositorio de nuestro vídeo:

Paso 2. Crea una rama e incorpora cambios a nivel local

Ahora que el repositorio está configurado, viene lo interesante. Puesto que las ramas no son solo un concepto de Bitbucket, puedes crear una de forma local. No obstante, en este tutorial vamos a crear una desde Bitbucket.

  1. Haz clic en Ramas en el panel de navegación izquierdo. Verás que ya tienes una rama (la rama principal).

  2. Haz clic en Crear una rama en la esquina superior derecha.

  3. Introduce un nombre de rama y haz clic en Crear. Si no estás seguro de qué nombre poner a la rama, prueba con algo como my-updates.

  4. Una vez que crees la rama, debes comprobar que funciona en tu sistema local. Para ello, haz clic en el botón Echar un vistazo en Sourcetree.

  5. En el cuadro de diálogo Comprobar existentes en Sourcetree, haz clic en Comprobar.

Ahora ya tienes una rama en Bitbucket y la has comprobado en tu sistema local, lo que te permite actuar en esa línea de código independiente y aplicar en ella el comando "push".

Paso 3. Realizar un cambio en la rama

Ahora, te toca a ti hacer algunos cambios en tu repositorio. Como menciona el archivo, puedes complicar o simplificar el proceso tanto como quieras. Cambia el CSS, añade más archivos, crea una obra maestra o simplemente responde las preguntas.

  1. En el repositorio en Sourcetree, haz clic en el botón Mostrar en buscador.
  2. Abre el archivo survey.html (o el archivo con el nombre que hayas elegido) con un editor de texto.

  3. Haz tus cambios, ya sean grandes o pequeños, y, a continuación, guarda y cierra el archivo.

  4. Abre Sourcetree y observa que tu repositorio tiene cambios sin confirmar.

  5. (Solo para Git) Añade el archivo al área de entorno de ensayo:

    1. Selecciona la línea Cambios sin confirmar .

    2. En la lista Unstaged files, coloca una marca de verificación junto al archivo survey.htm (y otros archivos que tengan cambios sin confirmar).

    3. En el cuadro de diálogo ¿Confirmar fase?, haz clic en Aceptar.

  6. Haz clic en el botón Confirmar en la parte superior para confirmar el archivo.

  7. Introduce un mensaje de confirmación en el espacio proporcionado, por ejemplo, algo del tipo preguntas contestadas.

  8. Haz clic en el botón Confirmar en el cuadro de mensaje. Cuando vuelvas a la vista, verás que los archivos se han confirmado, pero no se han aplicado al repositorio de Bitbucket.

  9. En Sourcetree, haz clic en el botón Aplicar para aplicar los cambios confirmados.

  10. En el cuadro de diálogo que aparece, haz clic en Aceptar para aplicar la rama con la confirmación a Bitbucket.

  11. En Bitbucket, haz clic en la página Fuente de tu repositorio. Debes ver las dos ramas en la lista desplegable. Las demás confirmaciones que realices en my-updates también aparecerán en dicha rama.

Crear una solicitud de extracción para fusionar el cambio

Para avisar a tus compañeros de equipo de tus actualizaciones y obtener su aprobación, el siguiente paso es crear una solicitud de extracción. Además de proporcionar un lugar para la revisión del código, la solicitud de extracción muestra una comparación de tus cambios con respecto al repositorio original (también conocida como diferencia) y proporciona una manera sencilla de fusionar código cuando esté listo.

Paso 1. Crea la solicitud de extracción

Para crear una solicitud de extracción, necesitas una rama. Lo bueno es que ya tienes una.

  1. En el repositorio, haz clic en + en la barra lateral global. A continuación, haz clic en Crear una solicitud de extracción en Empezar a trabajar.
    Bitbucket muestra el formulario de solicitud.
  2. Completa el formulario:
    1. Ya tienes un título automático, tu último mensaje de confirmación.

    2. Añade una descripción si quieres.

    3. En el campo Revisores, añade al miembro de tu equipo breezycloud como revisor.

    Cuando hayas terminado, el formulario tendrá un aspecto parecido al siguiente:
  3. Haz clic en Crear solicitud de extracción.

Bitbucket abre la solicitud de extracción y el revisor recibe una notificación por correo electrónico con información de la solicitud de extracción para que la revise.

Paso 2. Fusiona la solicitud de extracción

¡Alto! Habrás visto el botón Fusionar en la parte superior. Antes de hacer clic en él, debes esperar a que se aprueben tus cambios. Además de la notificación que reciben tus compañeros de equipo por correo electrónico, también podrán ver la solicitud de extracción en Solicitudes de extracción para revisar del panel Tu trabajo.

En la solicitud de extracción, el revisor puede ver la diferencia y añadir los comentarios para empezar un debate antes de hacer clic en el botón Aprobar.

Cuando alguien aprueba tu solicitud de extracción, recibes una notificación por correo electrónico. Una vez que tengas el número de aprobaciones necesario (en este caso, solo una), puedes realizar la fusión. En la solicitud de extracción, haz clic en Fusionar. ¡Y eso es todo! Si quieres ver el aspecto que tendrá cuando tu rama se fusione con la rama principal, haz clic en Confirmaciones para ver el árbol de confirmaciones.