Ejercicio: Creación, revisión y combinación de una solicitud de incorporación de cambios

  • 5 minutos

Ha completado el trabajo para agregar una cola a su sitio web. Ahora, el equipo de desarrollo del sitio web está listo para combinar los cambios en la rama principal. En este ejercicio, creará y combinará una solicitud de incorporación de cambios para los cambios.

Durante el proceso, hará lo siguiente:

  • Cree una solicitud de incorporación de cambios.
  • Revise la solicitud de incorporación de cambios.
  • Complete la solicitud de incorporación de cambios.
  • Compruebe que los cambios se han combinado.

Creación de una solicitud de incorporación de cambios para combinar la rama de características

Dado que no se pueden insertar cambios directamente en la rama principal del repositorio, debe crear una solicitud de incorporación de cambios.

  1. En el explorador, vaya a Código.

  2. Seleccione 2 ramas para enumerar las ramas del repositorio de GitHub.

    Captura de pantalla de GitHub que muestra la página del repositorio con el vínculo a la lista de ramas resaltado.

  3. Junto a add-orders-queue, seleccione el icono Más (...) y, a continuación, seleccione Nueva solicitud de cambios.

    Captura de pantalla de GitHub que muestra la lista de ramas. El botón de una nueva solicitud de incorporación de cambios está resaltado para la rama add-orders-queue.

  4. Cuando creó la solicitud de incorporación de cambios, observe que GitHub usó automáticamente el mensaje de confirmación de Git como título de la solicitud de incorporación de cambios.

    Actualice la descripción al texto siguiente:

    Esta solicitud de incorporación de cambios agrega una nueva cola de Azure Storage para procesar pedidos y actualiza la configuración del sitio web para incluir la información de la cola y la cuenta de almacenamiento.

  5. Seleccione Crear solicitud de incorporación de cambios.

    Captura de pantalla de GitHub que muestra la página de creación de solicitudes de incorporación de cambios, con el botón para crear una solicitud de incorporación de cambios resaltado.

  1. En el explorador, vaya a Repositorios>Ramas.

    Observe que Azure DevOps muestra un banner que indica que hay cambios en la rama add-orders-queue. El banner ofrece crear una solicitud de incorporación de cambios para esos cambios.

    Captura de pantalla de Azure DevOps que muestra la lista de archivos del repositorio, incluido un texto que ofrece crear una solicitud de incorporación de cambios.

  2. Seleccione Crear una solicitud de incorporación de cambios.

  3. En la página para crear una solicitud de incorporación de cambios, observe que Azure DevOps usó automáticamente el mensaje de confirmación de Git como título de la solicitud de incorporación de cambios.

    Actualice la descripción al texto siguiente:

    Esta solicitud de incorporación de cambios agrega una nueva cola de Azure Storage para procesar pedidos y actualiza la configuración del sitio web para incluir la información de la cola y la cuenta de almacenamiento.

  4. Seleccione Crear.

    Captura de pantalla de Azure DevOps que muestra la página de creación de solicitudes de incorporación de cambios, con el botón para crear una solicitud de incorporación de cambios resaltado.

Revisión de la solicitud de incorporación de cambios

Normalmente, otra persona que no sea su autor revisa una solicitud de incorporación de cambios. En este ejemplo, simulará ser otro miembro del equipo y revisará su propia solicitud de incorporación de cambios.

  1. En la página de la solicitud de incorporación de cambios, seleccione la pestaña Archivo cambiado.

    Captura de pantalla de GitHub que muestra la pestaña de los archivos modificados en una solicitud de incorporación de cambios.

    GitHub muestra los archivos que se cambiaron en esta solicitud de incorporación de cambios. Observe que resaltan todas las líneas que han cambiado, por lo que puede ver fácilmente lo que debe revisar.

    Sugerencia

    Imagine que está revisando esto para su propio equipo. ¿Realizaría alguna sugerencia?

  2. En el archivo main.bicep que se cambió, mantenga el mouse sobre la línea 18 y seleccione el botón con el signo más (+).

    Captura de pantalla de GitHub que muestra los cambios en el archivo mani.bicep. El mouse mantiene el puntero sobre la línea 18 y el botón para agregar comentarios está resaltado.

  3. En el cuadro de comentario, escriba el texto siguiente: ¿Debe escribirse esto en mayúsculas?

  4. Seleccione Iniciar una revisión.

    Captura de pantalla de GitHub que muestra el campo de comentario, con el botón para iniciar una revisión resaltado

    Sugerencia

    GitHub no le permite aprobar sus propias solicitudes de incorporación de cambios. Aquí, comentará la solicitud de incorporación de cambios, pero no la aprobará. Cuando trabaje con las solicitudes de incorporación de cambios de su propio equipo, este es el punto en el que la aprobaría para indicar que ya se puede combinar.

  5. Seleccione Finish your review (Finalizar la revisión).

  6. En el panel de revisión que aparece, seleccione Submit review (Enviar revisión).

    Captura de pantalla de GitHub que muestra el panel para finalizar una revisión, con el botón para enviar una revisión resaltado

    GitHub le devuelve a la pestaña Conversación de la solicitud de incorporación de cambios.

  1. En la página de la solicitud de incorporación de cambios, seleccione la pestaña Archivos.

    Captura de pantalla de Azure DevOps que muestra los archivos modificados en la solicitud de incorporación de cambios.

    Azure DevOps muestra los archivos que se cambiaron en esta solicitud de incorporación de cambios. Observe que resaltan todas las líneas que han cambiado, por lo que puede ver fácilmente lo que debe revisar.

    Sugerencia

    Imagine que está revisando esto para su propio equipo. ¿Realizaría alguna sugerencia?

  2. En el archivo main.bicep que se cambió, mantenga el mouse sobre la línea 18 y seleccione el botón de comentarios.

    Captura de pantalla de Azure DevOps que muestra los cambios en el archivo mani.bicep. El mouse mantiene el puntero sobre la línea 18 y el botón para agregar comentarios está resaltado.

  3. En el cuadro de comentario, escriba el texto siguiente: ¿Debe escribirse esto en mayúsculas?

  4. Seleccione Comentario.

    Captura de pantalla de Azure DevOps que muestra el campo de comentarios, con el botón Comentario resaltado.

    El ancho de la ventana del explorador puede afectar a cómo se muestra el cuadro de diálogo de comentario. El comentario abrirá un cuadro de diálogo Discusión en lugar del comentario insertado, como se muestra en la captura de pantalla.

  5. Seleccione Aprobar.

    Captura de pantalla de Azure DevOps que muestra el botón Aprobar para la solicitud de incorporación de cambios.

    Después de seleccionar Aprobar, establezca los cambios de Establecer autocompletar en Completar. Usará esa característica más adelante en esta unidad.

Respuesta a la revisión de la solicitud de incorporación de cambios

Al crear o revisar una solicitud de incorporación de cambios, puede participar en una conversación sobre su contenido. Imagine que es el autor de este archivo y desea responder a un comentario del revisor.

  1. Responda a la revisión de la solicitud de incorporación de cambios con el siguiente comentario: No, las colas de almacenamiento deben tener nombres en minúsculas.

  2. Seleccione Comentario y, a continuación, seleccione Resolve conversation (Resolver conversación) para indicar que la discusión en la línea ha terminado.

    Captura de pantalla de GitHub que muestra la respuesta a un comentario, con los botones para escribir un comentario y resolver una conversación resaltados.

  1. En la página de la solicitud de incorporación de cambios, seleccione la pestaña Información general.

    Captura de pantalla de Azure DevOps en la que se muestra la pestaña Información general.

  2. Ahora, imagine que es el autor de este archivo. Responda a la revisión de la solicitud de incorporación de cambios con el siguiente comentario: No, las colas de almacenamiento deben tener nombres en minúsculas.

  3. Seleccione Responder y resolver para indicar que el debate ha terminado.

    Captura de pantalla de Azure DevOps que muestra la respuesta a un comentario, con el botón para responder y resolver resaltado.

Finalización de la solicitud de incorporación de cambios

El equipo de desarrollo de su sitio web ha confirmado que está listo para enviar los pedidos a la cola, por lo que está listo para completar y combinar la solicitud de cambios.

La solicitud de incorporación de cambios se ha aprobado. El equipo de desarrollo de su sitio web ha confirmado que está listo para enviar los pedidos a la cola, por lo que está listo para completar y combinar la solicitud de cambios.

  1. Seleccione Merge pull request (Combinar solicitud de incorporación de cambios).

    Captura de pantalla de GitHub que muestra una solicitud de incorporación de cambios con el botón para combinar resaltado.

  2. GitHub le pide que confirme la combinación. Cuando GitHub combina la solicitud de incorporación de cambios, crea una confirmación y genera automáticamente un mensaje de confirmación. Seleccione Confirm merge (Confirmar combinación).

    Captura de pantalla de GitHub que muestra una solicitud de incorporación de cambios con el botón para confirmar una combinación resaltado.

    La solicitud de incorporación de cambios se combina y la nueva característica ahora está en la rama principal del repositorio.

  3. Es una buena práctica eliminar las ramas de características cuando haya terminado con ellas. Eliminar las ramas ayuda a evitar la confusión de los miembros del equipo en un futuro sobre qué trabajo aún está en curso. Seleccione Eliminar rama.

    Captura de pantalla de GitHub que muestra una solicitud de incorporación de cambios con el botón para eliminar una rama resaltado.

  1. Seleccione Complete.

    Captura de pantalla de Azure DevOps que muestra el botón Completo para una solicitud de incorporación de cambios.

  2. En Completar solicitud de incorporación de cambios, use la configuración predeterminada. Seleccione Completar la fusión mediante combinación.

    Captura de pantalla de Azure DevOps que muestra el panel de finalización de la solicitud de incorporación de cambios, con el botón para completar una combinación resaltado.

    La solicitud de incorporación de cambios se combina y la nueva característica ahora está en la rama principal del repositorio.

    Azure DevOps eliminó automáticamente la rama de características cuando se combinó la solicitud de incorporación de cambios. Es una buena práctica eliminar las ramas de características cuando haya terminado con ellas. Eliminar las ramas ayuda a evitar la confusión de los miembros del equipo en un futuro sobre qué trabajo aún está en curso.

Comprobación de los cambios

Después de combinar una solicitud de incorporación de cambios, es recomendable confirmar que los cambios se combinaron correctamente.

  1. Vaya a Código.

  2. Vaya al archivo deploy/main.bicep y, después, al archivo deploy/modules/appService.bicep.

    Captura de pantalla de GitHub que muestra la lista de archivos del repositorio después de combinar la solicitud de incorporación de cambios.

    Observe que la cola y los demás cambios ahora están en los archivos.

  1. Vaya a Repositorios>Archivos.

  2. Vaya al archivo deploy/main.bicep y, después, al archivo deploy/modules/appService.bicep.

    Observe que la cola y los demás cambios ahora están en los archivos.