+ @startuml

+ 

+ hide footbox

+ title Example of a Pull Request Approved Workflow for a Distgit

+ 

+ actor Human

+ participant src.fp.org

+ participant Zuul

+ participant Koji

+ 

+ Human -> src.fp.org : Flag the PR with "gateit"

+ 

+ activate src.fp.org

+ src.fp.org -> Zuul : Notify (webhook)

+ activate "Zuul"

+ 

+ == gate pipeline ==

+ note over Zuul

+   The gate pipeline triggers gate's jobs

+   only whether the PR CI status is success.

+ end note

+ Zuul -> Zuul : noop job

+ Zuul -> src.fp.org : Return CI Status

+ Zuul -> src.fp.org : Merge the Pull Request

+ deactivate Zuul

+ note over src.fp.org

+   CI Status is success on check and gate

+   so Zuul requests the merge of the Pull Request.

+ end note

+ == End of gate pipeline ==

+ 

+ src.fp.org -> Zuul : Notify Pull Request merged

+ 

+ == promote pipeline ==

+ activate Zuul

+ group job rpm-build run

+   Zuul -> Zuul : Starts rpm-build

+   Zuul -> Koji : Request a Koji build

+   Koji -> Zuul : Notify build result

+ end

+ Zuul -> src.fp.org : Notify build result

+ == End of promote pipeline ==

+ 

+ @enduml

+ @startuml

+ 

+ hide footbox

+ title Example of a Pull Request Created/Updated Workflow for a Distgit

+ 

+ actor Human

+ participant src.fp.org

+ participant Zuul

+ participant Nodepool

+ participant Koji

+ 

+ Human -> src.fp.org : Open/Update/Recheck a PR

+ 

+ activate src.fp.org

+ src.fp.org -> Zuul : Notify (webhook)

+ activate Zuul

+ 

+ == check pipeline ==

+ group job rpm-scratch-build run

+   Zuul -> Nodepool : Starts rpm-scratch-build exec

+   activate Nodepool

+   Nodepool -> Koji : Request scratch build

+   activate Koji

+   Koji -> Koji : Exec scratch build

+   Koji -> Nodepool : Result build result

+   Nodepool -> Koji : Fetch artifacts (rpms)

+   deactivate Koji

+ end

+ Zuul -> Nodepool : Fetch result and artifacts

+ deactivate Nodepool

+ Zuul -> Zuul : Store result and artifacts

+ activate Nodepool

+ group job rpm-lint and rpm-rpminspect runs

+   Zuul -> Nodepool : Starts rpm-lint and rpm-rpminspect exec

+   Nodepool -> Nodepool : Fetch artifacts (rpms) form store

+ end

+ note right

+   Jobs re-use previously built artifacts

+   (rpms) from rpm-scratch-build parent job.

+   Jobs are executed in // on different VMs

+   or containers.

+ end note

+ Zuul -> Nodepool : Fetch results and artifacts

+ deactivate Nodepool

+ Zuul -> Zuul : Store result and artifacts

+ Zuul -> src.fp.org : Return CI status via the API

+ Zuul -> src.fp.org : Return logs/artifacts links as comment via the API

+ deactivate Zuul

+ deactivate src.fp.org

+ == End of check pipeline ==

+ 

+ @enduml