zuul/doc/source
James E. Blair 1f026bd49c Finish circular dependency refactor
This change completes the circular dependency refactor.

The principal change is that queue items may now include
more than one change simultaneously in the case of circular
dependencies.

In dependent pipelines, the two-phase reporting process is
simplified because it happens during processing of a single
item.

In independent pipelines, non-live items are still used for
linear depnedencies, but multi-change items are used for
circular dependencies.

Previously changes were enqueued recursively and then
bundles were made out of the resulting items.  Since we now
need to enqueue entire cycles in one queue item, the
dependency graph generation is performed at the start of
enqueing the first change in a cycle.

Some tests exercise situations where Zuul is processing
events for old patchsets of changes.  The new change query
sequence mentioned in the previous paragraph necessitates
more accurate information about out-of-date patchsets than
the previous sequence, therefore the Gerrit driver has been
updated to query and return more data about non-current
patchsets.

This change is not backwards compatible with the existing
ZK schema, and will require Zuul systems delete all pipeline
states during the upgrade.  A later change will implement
a helper command for this.

All backwards compatability handling for the last several
model_api versions which were added to prepare for this
upgrade have been removed.  In general, all model data
structures involving frozen jobs are now indexed by the
frozen job's uuid and no longer include the job name since
a job name no longer uniquely identifies a job in a buildset
(either the uuid or the (job name, change) tuple must be
used to identify it).

Job deduplication is simplified and now only needs to
consider jobs within the same buildset.

The fake github driver had a bug (fakegithub.py line 694) where
it did not correctly increment the check run counter, so our
tests that verified that we closed out obsolete check runs
when re-enqueing were not valid.  This has been corrected, and
in doing so, has necessitated some changes around quiet dequeing
when we re-enqueue a change.

The reporting in several drivers has been updated to support
reporting information about multiple changes in a queue item.

Change-Id: I0b9e4d3f9936b1e66a08142fc36866269dc287f1
Depends-On: https://review.opendev.org/907627
2024-02-09 07:39:40 -08:00
..
_static Refresh self-keysig expiration on my OpenPGP key 2022-03-15 13:31:55 +00:00
_templates Add a version selector to docs 2021-12-16 11:21:40 -08:00
config Merge "Add narrative documentation for pipeline window" 2023-08-30 01:28:46 +00:00
developer Finish circular dependency refactor 2024-02-09 07:39:40 -08:00
drivers Merge "Use a seeded PRNG when setting timer triggers" 2023-12-13 10:38:41 +00:00
examples gitlab doc - update the reference pipelines 2024-01-24 10:34:15 +00:00
howtos docs: remove orphaned howto pages 2022-11-11 10:53:49 +11:00
images Update Matrix instructions 2021-08-21 07:27:17 -07:00
tutorials Replace docker by podman for quick-start 2023-05-22 06:54:41 -07:00
about.rst Reorganize docs 2021-12-15 15:25:31 -08:00
admin.rst Add an upgrading document 2022-11-07 09:01:07 -08:00
authentication.rst Unpin JWT and use integer IAT values 2022-11-15 13:52:53 -08:00
client.rst Document backing up and restoring project keys 2023-05-31 20:18:28 +00:00
components.rst Update docs to say large installations can need multiple schedulers 2022-03-02 10:19:38 +01:00
concepts.rst Add narrative documentation for pipeline window 2023-08-29 15:44:32 -07:00
conf.py Correct tagged version docs build 2022-03-21 10:22:13 -07:00
configuration.rst Document backing up and restoring project keys 2023-05-31 20:18:28 +00:00
gating.rst Add narrative documentation for pipeline window 2023-08-29 15:44:32 -07:00
glossary.rst Add narrative documentation for pipeline window 2023-08-29 15:44:32 -07:00
governance.rst Re-elect James Blair as project lead 2024-01-08 07:30:13 -08:00
index.rst Reorganize docs 2021-12-15 15:25:31 -08:00
installation.rst Document backing up and restoring project keys 2023-05-31 20:18:28 +00:00
job-content.rst Merge "Add Zuul job variable to indicate a job will retry" 2023-07-29 18:13:41 +00:00
monitoring.rst Add pipeline queue stats 2023-08-29 15:49:52 -07:00
operation.rst Document backing up and restoring project keys 2023-05-31 20:18:28 +00:00
project-config.rst Add configuration support for negative regex 2023-08-28 15:03:58 -07:00
releasenotes.rst Reorganize docs 2021-12-15 15:25:31 -08:00
rest-api.rst Reorganize docs 2021-12-15 15:25:31 -08:00
tenants.rst Add support for limiting dependency processing 2023-09-07 11:01:29 -07:00
tracing.rst Add tracing tutorial 2022-09-19 08:42:28 +02:00
troubleshooting.rst Better document service command-line switches 2022-02-11 14:48:41 +00:00
upgrading.rst Add an upgrading document 2022-11-07 09:01:07 -08:00
vulnerabilities.rst Drop SKS Keyserver links from vulnerabilities doc 2022-03-15 13:24:48 +00:00