Skip to main content

Création de demandes de tirage empilées

Créez une pile de demandes de tirage dépendantes à l’aide de l’extension gh stack dans GitHub CLI ou directement sur GitHub.

Remarque

Cette fonctionnalité est disponible en préversion publique et peut être modifiée.

Créez des demandes de tirage empilées avec l’extension gh stack dans GitHub CLI ou sur le GitHub site web.

Remarque

Les demandes de tirage empilées nécessitent que toutes les branches se soient dans le même référentiel. Les piles inter-fourche ne sont pas prises en charge.

Création d’une pile avec GitHub CLI

  1. Initialiser une pile. Cela crée et extrait la première branche au-dessus de votre branche de jonction.

    Shell
    gh stack init auth-layer
    
  2. Écrivez du code pour la première couche, puis mettez en scène et validez vos modifications.

    Shell
    git add .
    git commit -m "helpful-commit-message"
    
  3. Ajoutez une branche pour l’unité logique suivante de travail. La nouvelle branche est créée en haut de la branche actuelle.

    Shell
    gh stack add BRANCH-NAME
    
  4. Écrivez du code et validez sur la nouvelle branche. Répétez pour chaque couche supplémentaire.

  5. Envoyez toutes les branches au référentiel distant et créez les demandes de tirage empilées sur GitHub.

    Shell
    gh stack submit
    

    Chaque demande de tirage est créée avec la branche de base correcte, de sorte que les réviseurs voient uniquement les différences pour cette couche, et les demandes de tirage sont automatiquement liées en tant que pile.

Création d’une pile à partir du GitHub site web

Vous pouvez créer une pile sans l’interface CLI en définissant la branche de base de chaque demande de tirage sur la branche située en dessous.

  1. Créez la première demande de tirage comme vous le feriez normalement. En règle générale, votre base cible main.

  2. Créez la requête de tirage suivante et définissez sa branche de base sur la branche de la première demande de tirage. Sélectionnez l’option Créer une pile pour lier les deux demandes de tirage en tant que pile.

    Une fois créée, la pile affiche les demandes de tirage liées.

    • Une icône de pile en haut de la demande de tirage affiche un nombre indiquant la couche que vous affichez.
    • Une carte de pile s’affiche dans la zone de fusion. Il affiche chaque demande de tirage dans la pile et son état, et vous permet d’accéder à n’importe quelle couche en un clic.
  3. Répétez pour chaque demande de tirage supplémentaire, ciblant la branche de la demande de tirage avant celle-ci.

Transformer des demandes de tirage existantes en pile

Si vous avez déjà ouvert des demandes de tirage dont les branches s’alignent, où chaque branche de base de la demande de tirage est la branche de base de la demande de tirage sous celle-ci, GitHub reconnaît la chaîne et affiche une bannière de recommandation pour les transformer en pile.

  1. Sur l’une des demandes de tirage éligibles, sélectionnez la bannière pour ouvrir une boîte de dialogue qui affiche un aperçu de la pile, répertoriant chaque demande de tirage dans l’ordre de haut en bas.

  2. Passez en revue l’aperçu et confirmez pour lier les demandes de tirage ensemble dans une pile.

Une fois que vous avez confirmé, la carte de pile s’affiche dans l’en-tête de chaque demande de tirage.

Ajouter à une pile existante à partir du GitHub site web

Pour ajouter une nouvelle demande de tirage à une pile qui existe déjà :

  1. Ouvrez une demande de tirage dans la pile, cliquez dans l’en-tête, puis cliquez sur Ajouter à la pile.

  2. La branche de base est automatiquement définie sur la tête de la demande de tirage supérieure. Sélectionnez la branche de tête de votre nouvelle demande de tirage et sélectionnez Créer une demande de tirage.

  3. Sélectionnez Ajouter à la pile pour créer la demande de tirage.

La nouvelle demande de tirage est ajoutée au début de la pile.

Lectures complémentaires