Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
37 changes: 37 additions & 0 deletions dev/breeze/doc/08_ci_tasks.rst
Original file line number Diff line number Diff line change
Expand Up @@ -226,6 +226,43 @@ These are all available flags of ``approve-workflow-runs`` command:
:width: 100%
:alt: Breeze ci approve-workflow-runs

Moving a pull request between project CI and fork CI
----------------------------------------------------

A maintainer moves a single pull request to project CI with the ``use project ci`` label, and back
to fork CI with ``use fork ci`` (AIP-120). The fork CI monitor reacts to the labels only on its next
run, so a fork ``CI passed`` success posted before ``use project ci`` was added still lets the pull
request merge until then, and the label alone does not start project CI. ``use-project-ci`` does both
in order, with your own ``gh`` credentials: it sets a fork ``CI passed`` success on the head commit
to ``pending`` first, then adds ``use project ci`` (removing ``use fork ci``), and closes and reopens
the pull request to start project CI (``--no-restart`` leaves that to the author's next push). A
``CI passed`` success that project CI earned is kept.

.. code-block:: bash

breeze ci use-project-ci 12345

These are all available flags of ``use-project-ci`` command:

.. image:: ./images/output_ci_use-project-ci.svg
:target: https://raw.githubusercontent.com/apache/airflow/main/dev/breeze/images/output_ci_use-project-ci.svg
:width: 100%
:alt: Breeze ci use-project-ci

``use-fork-ci`` labels the pull request ``use fork ci`` instead of ``use project ci``. The monitor
gates it on its next run, and fork CI runs on the author's next push to their fork.

.. code-block:: bash

breeze ci use-fork-ci 12345

These are all available flags of ``use-fork-ci`` command:

.. image:: ./images/output_ci_use-fork-ci.svg
:target: https://raw.githubusercontent.com/apache/airflow/main/dev/breeze/images/output_ci_use-fork-ci.svg
:width: 100%
:alt: Breeze ci use-fork-ci

-----

Next step: Follow the `Release management tasks <09_release_management_tasks.rst>`_ guide to learn how
Expand Down
28 changes: 20 additions & 8 deletions dev/breeze/doc/images/output_ci.svg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
2 changes: 1 addition & 1 deletion dev/breeze/doc/images/output_ci.txt
Original file line number Diff line number Diff line change
@@ -1 +1 @@
bc527ecfffabbbd21bdcf1fbbfe25bc5
920b300247600a80acaf9e57075149bb
Loading
Loading