Creación de pull requests apiladas

Cree pull requests apiladas con la extensión gh stack en GitHub CLI o en el sitio web GitHub.

Creación de una pila con GitHub CLI

1. Inicialice una pila. Esto crea y hace checkout de la primera rama a partir de tu rama troncal.

   Shell

   gh stack init BRANCH-NAME
   

2. Escriba código para la primera capa y, a continuación, prepare y confirme los cambios.

   Shell

   git add .
   git commit -m "helpful-commit-message"
   

3. Agregue una rama para la siguiente unidad lógica de trabajo. La nueva rama se crea sobre la actual.

   Shell

   gh stack add BRANCH-NAME
   

4. Escriba código y haga commit en la nueva rama. Repita para cada capa adicional.

5. Haga push de todas las ramas al repositorio remoto y cree las pull requests en pila en GitHub.

   Shell

   gh stack submit
   

   Cada pull request se crea con la rama base correcta, por lo que los revisores solo ven la diferencia de esa capa y los pull requests se vinculan automáticamente como una pila.

Creación de un stack desde el GitHub sitio web

Puede crear una pila sin la CLI estableciendo la rama base de cada pull request en la rama debajo de ella.

1. Cree la primera pull request como lo haría normalmente. Normalmente, la base apuntaría a main.

2. Cree la siguiente solicitud de incorporación de cambios y establezca su rama base en la rama de la primera solicitud de incorporación de cambios. Seleccione la opción Create stack para vincular las dos pull requests como una stack.

   Una vez creada, la pila muestra las solicitudes de incorporación de cambios vinculadas entre sí.

   • Un icono de pila en la parte superior de la pull request muestra un número que indica qué capa está viendo.
   • Aparece un mapa de pila en el cuadro de fusión. Muestra cada pull request de la pila y su estado, y le permite navegar a cualquier nivel con un solo clic.

3. Repita este proceso para cada solicitud de incorporación de cambios adicional, con destino a la rama de la solicitud de incorporación de cambios anterior.

Convertir pull requests existentes en una serie

Si ya tiene pull requests abiertas cuyas ramas se alinean, donde la rama base de cada pull request es la rama de origen de la pull request de debajo, GitHub reconoce la cadena y muestra un banner de recomendación para convertirlas en una pila.

1. En cualquiera de las solicitudes de incorporación de cambios aptas, seleccione el banner para abrir un cuadro de diálogo que muestra una vista previa de la pila, enumerando cada solicitud de incorporación de cambios en orden de arriba a abajo.

2. Revise la versión preliminar y confirme la vinculación de las pull requests en una pila de PR apiladas.

Una vez que confirme, el stack map aparece en el encabezado de cada pull request.

Agregar a una pila existente desde el sitio web GitHub

Para agregar una nueva pull request a una pila que ya existe:

1. Abra cualquier pull request de la pila, haga clic en en el encabezado y, a continuación, haga clic en Agregar a la pila.

2. La rama base se establece automáticamente en el HEAD de la primera solicitud de extracción. Seleccione la rama principal de la nueva solicitud de incorporación de cambios y seleccione Crear solicitud de incorporación de cambios.

3. Seleccione Agregar al conjunto para crear la solicitud de extracción.

La nueva pull request se agrega a la parte superior de la pila.

Lectura adicional

• Comandos de la CLI para pull requests apiladas