Update the deprecation policy to indicate that zuul-jobs is no
longer tested with EOL platforms. Also explicitly switch the minimum
Python 3 documented to 3.6, and add a note to the tox-py34 and
tox-py35 jobs mentioning that they're no longer directly tested.
Move those jobs to the deprecated jobs list as well, to help
reinforce the point that their continued use is not recommended.
Change-Id: I2edbf8ea010caf7a7641e0d88f360965fc0b96ab
We're not actually following this. Let's either update
the docs to reflect on how os specific tasks are handled
or update the roles to follow the guidelines.
Change-Id: I9b987efaf597acd34cbcacccd37415dd205a7fba
Several roles are setting facts that are expected to be consumed by
roles following them; generally things like the path to installed
tools, etc.
Add a section to policy about this behaviour in general, noting it
should use the cachable flags to persist the values.
Add specific documentation notes in an "Output Variable" section for
roles currently implementing this behaviour.
Change-Id: I05657fec198176c7d7345e84293f4902c81fa30c
We have to be careful about avoiding outer loop loop_var conflicts in
ansible. Because the zuul-jobs roles are meant to be reconsumed
elsewhere we should not use 'item' loopvars and instead set them to
something a bit more unique.
We use a zj_ prefix to try and be unique to this repo and document this
convention.
Change-Id: I20b9327a914890e9eafcb2b36dc8c23fb472bc8f
In order to see more consistency and good practices in zuul-jobs,
suggest some guidelines regarding OS and containers support, and
dealing with roles dependencies.
Change-Id: Iad001766a56833094ac8703fca11559265b6f914
Add a general note on testing, and specifically on how to use test
roles for testing trusted roles in the gate.
Change-Id: Idf84bc56effbb21f7b7a82703f398fb203c3694b
This captures some discussion over the scoping of variable names
during some recent role development. It tries to provide some
guidelines to prefixing of global variable names in roles and
"module-like" roles.
Since "deprecation.rst" is now holding a few different things, it
makes more sense as "policy.rst".
Reorganise to be nested in one more level, and add a contents section
to help find sections easier.
Change-Id: I0d551eefd33744ffa23418d0780769a7e52fe9cf