Crear una solicitud de incorporación de cambios

Crea una solicitud de incorporación de cambios para proponer cambios en un repositorio y colaborar con ellos. Estos cambios se proponen en una rama, lo cual garantiza que la rama predeterminada contenga únicamente trabajo finalizado y aprobado.

¿Quién puede utilizar esta característica?

Anyone with read access to a repository can create a pull request. Los miembros de una instancia de empresa con usuarios administrados solo pueden proponer cambios en los repositorios que formen parte de la empresa.

Platform navigation

En este artículo

Si deseas crear una rama nueva para tu solicitud de extracción y no tienes permisos de escritura para el repositorio, puedes bifurcarlo primero. Para obtener más información, vea «Crear una solicitud de extracción desde una bifurcación» y «Acerca de las bifurcaciones».

Puedes especificar en qué rama deseas fusionar tus cambios cuando creas tu solicitud de extracción. Las solicitudes de extracción solo se pueden abrir entre dos ramas que sean diferentes.

Nota: Para abrir una solicitud de incorporación de cambios en un repositorio público, debe tener acceso de escritura al encabezado de la rama de origen o, para los repositorios propiedad de una organización, debe ser miembro de la organización propietaria del repositorio para hacerlo.

Puedes vincular una solicitud de incorporación de cambios a una incidencia para mostrar que una corrección está en curso y para cerrar automáticamente la incidencia cuando un usuario fusione mediante combinación dicha solicitud. Para obtener más información, vea «Vincular una solicitud de cambios a una propuesta».

Cambiar el rango de la rama y el repositorio de destino

Predeterminadamente, las solicitudes de cambios se basan en la rama predeterminada del repositorio padre. Para obtener más información, vea «Acerca de las ramas».

Si el repositorio padre predeterminado no es el correcto, puedes cambiar tanto el repositorio padre como la rama con las listas desplegables. También puedes intercambiar tus ramas base y encabezado con las listas desplegables para establecer diferencias entre los puntos de referencia. Las referencias que aparecen aquí deben ser nombres de ramas en tu repositorio GitHub.

Captura de pantalla de una solicitud de incorporación de cambios. La lista desplegable para editar la rama de comparación se expande.

Al pensar en las ramas, recuerde que la rama base es donde se deben aplicar los cambios y la rama principal contiene lo que se quiere aplicar.

Cuando cambias el repositorio base, también puedes cambiar las notificaciones de la solicitud de extracción. Cualquier usuario que pueda subir al repositorio base recibirá una notificación por correo electrónico y verá la nueva solicitud de extracción en su tablero la próxima vez que inicie sesión.

Cuando cambies alguna información en el rango de la rama, las áreas de vista previa modificadas Confirmar y Campos se actualizarán para mostrar tu nuevo rango.

Tip

  • Usando la vista comparativa, puedes configurar comparaciones en todo el periodo. Para obtener más información, vea «Comparar confirmaciones».
  • Los mantenedores de proyecto pueden agregar una plantilla de solicitud de extracción para un repositorio. Las plantillas incluyen indicaciones para la información en el cuerpo de una solicitud de extracción. Para obtener más información, vea «Acerca de las plantillas de propuestas y solicitudes de extracción».

Crear una solicitud de extracción

  1. En GitHub, navegue hasta la página principal del repositorio.

  2. En el menú "Branch" (Rama), elige la rama que contiene tus confirmaciones.

    Captura de pantalla del menú desplegable de la rama en la página principal de un repositorio.

  3. Encima de la lista de archivos, en el banner amarillo, haz clic en Comparar y solicitud de incorporación de cambios para crear una solicitud de incorporación de cambios para la rama asociada.

    Captura de pantalla del banner de encima de la lista de archivos.

  4. Use el menú desplegable de la rama base para seleccionar la rama en la que quiera combinar los cambios y, después, use el menú desplegable de la rama de comparación para elegir la rama de tema en la que ha realizado los cambios.

  5. Escribe un título y una descripción para tu solicitud de extracción.

  6. Para crear una solicitud de incorporación de cambios que esté lista para revisión, haga clic en Crear solicitud de incorporación de cambios. Para crear un borrador de una solicitud de incorporación de cambios, use el menú desplegable y seleccione Crear solicitud de incorporación de cambios de borrador, y después haga clic en Solicitud de incorporación de cambios de borrador. Si eres miembro de una organización, es posible que tengas que solicitar acceso a borradores de solicitudes de incorporación de cambios de un propietario de la organización. Consulte "Acerca de las solicitudes de incorporación de cambios".

Sugerencia: Después de crear una solicitud de incorporación de cambios, puede pedir a una persona concreta que revise los cambios propuestos. Para obtener más información, vea «Solicitar una revisión de solicitud de extracción».

Una vez que se haya revisado la solicitud de incorporación de cambios, se puede combinar en el repositorio.

Para más información sobre GitHub CLI, consulta "Acerca del CLI de GitHub".

Para crear una solicitud de incorporación de cambios, use el subcomando gh pr create.

gh pr create

Para asignar una solicitud de incorporación de cambios a un individuo, use las marcas --assignee o -a. Puede usar @me para asignarse la solicitud de incorporación de cambios.

gh pr create --assignee "@octocat"

Para especificar la rama en la que quiere combinar la solicitud de incorporación de cambios, use las marcas --base o -B. Para especificar la rama que contiene confirmaciones para la solicitud de incorporación de cambios, use las marcas --head o -H.

gh pr create --base my-base-branch --head my-changed-branch

A fin de incluir un título y un cuerpo para la nueva solicitud de incorporación de cambios, use las marcas --title y --body.

gh pr create --title "The bug is fixed" --body "Everything works again"

Para marcar una solicitud de incorporación de cambios como borrador, use la marca --draft.

gh pr create --draft

Para agregar etiquetas o hitos a la nueva solicitud de incorporación de cambios, use las marcas --label y --milestone.

gh pr create --label "bug,help wanted" --milestone octocat-milestone

Para agregar la nueva solicitud de incorporación de cambios a un proyecto concreto, use la marca --project.

gh pr create --project octocat-project

Para asignar a un usuario o equipo como revisores, use la marca --reviewer.

gh pr create --reviewer monalisa,hubot  --reviewer myorg/team-name

Para crear la solicitud de incorporación de cambios en el explorador web predeterminado, use la marca --web.

gh pr create --web

  1. Haz en Vista previa de la solicitud de incorporación de cambios. GitHub Desktop abrirá un cuadro de diálogo de vista previa en el que se muestra la diferencia de los cambios entre la rama actual y la rama base.

    Captura de pantalla de la vista "Sin cambios locales". Un botón, con la etiqueta "Vista previa de solicitud de incorporación de cambios", está resaltado con un contorno naranja.

    Captura de pantalla de la vista "Sin cambios locales". Un botón, con la etiqueta "Vista previa de solicitud de incorporación de cambios", está resaltado con un contorno naranja.

    Como alternativa, para ir directamente a GitHub y crear la solicitud de incorporación de cambios, selecciona el icono desplegable y haz clic en Crear solicitud de incorporación de cambios.

  2. Confirma que la rama en el menú desplegable base: es en la que quieres combinar los cambios.

    Captura de pantalla de la ventana del diálogo "Abrir una solicitud de incorporación de cambios". Un botón con un icono desplegable, con la etiqueta "base: desarrollo", se resalta con un contorno naranja.

    GitHub Desktop avisará si la rama actual se puede combinar automáticamente en la rama base.

    Captura de pantalla de la ventana del diálogo "Abrir una solicitud de incorporación de cambios". Una etiqueta de estado que indica "No se puede combinar automáticamente" aparece resaltada con un contorno naranja.

  3. Haga clic en Crear solicitud de incorporación de cambios. GitHub Desktop abrirá tu buscador predeterminado para llevarte a GitHub.

  4. Escribe un título y una descripción para tu solicitud de extracción.

  5. Para crear una solicitud de incorporación de cambios que esté lista para revisión, haga clic en Crear solicitud de incorporación de cambios. Para crear un borrador de una solicitud de incorporación de cambios, use el menú desplegable y seleccione Crear solicitud de incorporación de cambios de borrador, y después haga clic en Solicitud de incorporación de cambios de borrador. Si eres miembro de una organización, es posible que tengas que solicitar acceso a borradores de solicitudes de incorporación de cambios de un propietario de la organización. Consulte "Acerca de las solicitudes de incorporación de cambios".

  1. Después de haber confirmado los cambios en la copia local del repositorio, haga clic en el icono Crear solicitud de incorporación de cambios.
    Captura de pantalla de la parte superior de la barra lateral "Control de código fuente". El icono de solicitud de incorporación de cambios está resaltado con un contorno naranja oscuro.
  2. Verifica que el repositorio y la rama local desde la que estás haciendo la fusión y la rama y repositorio remotos hacia los que estés haciendo la fusión sean correctos. Después, asigna un nombre y descripción a la solicitud de cambios.
    Captura de pantalla de la barra lateral "Solicitud de incorporación de cambios de GitHub" con un formulario para crear una solicitud de incorporación de cambios, incluidos los campos "Título" y "Descripción".
  3. Haga clic en Crear.

Para más información sobre cómo crear solicitudes de incorporación de cambios en GitHub Codespaces, consulta "Uso de GitHub Codespaces para las solicitudes de incorporación de cambios".

Realización de cambios en los archivos de la solicitud de cambios

Una vez que hayas abierto la solicitud de cambios, puedes seguir realizando cambios en los archivos agregando nuevas confirmaciones a la rama principal.

También puedes realizar cambios en los archivos del sitio web de GitHub.

  1. En GitHub, vaya a una solicitud de cambios en un repositorio.

  2. En la solicitud de incorporación de cambios, haz clic en Archivos cambiados.

    Captura de pantalla de las pestañas de una solicitud de incorporación de cambios. La pestaña "Archivos cambiados" está resaltada en naranja oscuro.

  3. Desplázate hacia abajo hasta el archivo al que deseas realizar cambios.

  4. Encima del archivo que deseas cambiar, haz clic en .

    Recorte de pantalla de las opciones situadas sobre un archivo en la pestaña "File changed". El botón "Show options" aparece resaltado con un rectángulo naranja.

  5. En el menú, haz clic en Edit file.

  6. Realiza los cambios en el editor y, al hacer "commit" del cambio, opta por volver a confirmar directamente con la rama principal.

Si formas parte de la versión preliminar pública de Copilot Workspace, al hacer clic en Edit en un archivo de la pestaña "Files changed", se abrirá el archivo en Copilot Workspace en GitHub. En Copilot Workspace, puedes seguir realizando cambios en el archivo, pero también realizar cambios en otros archivos del repositorio, agrupar los cambios en un solo commit y aprovechar la finalización de código de Copilot.

Puedes acceder a Copilot Workspace optando por editar un archivo individual o haciendo clic en Open in Workspace en la barra lateral derecha de la solicitud de cambios. Para obtener más información acerca de Copilot Workspace y cómo unirse a la versión preliminar pública, consulta "Uso de Copilot para ayudarte a trabajar con una solicitud de cambios."

Información adicional