Use list tables
Reformat overlong table into a list-table to make it easier to edit. The change contains no wording changes besides giving titles to the list-tables. Fix formatting for setup-devstack-source-dirs so that the variable does not get displayed with a grey bar at https://docs.openstack.org/devstack/latest/zuul_roles.html#role-setup-devstack-source-dirs Change-Id: I7378d46c507b1d86f1d5319655a55f2a8c5a8f60
This commit is contained in:
Andreas Jaeger
parent
8dd89e52d0
commit
d3a2fcf485
@ -180,123 +180,147 @@ the same or a similar behaviour in Zuul v3 jobs. For localrc settings,
|
|||||||
devstack-gate defined a default value. In ansible jobs the default is either the
|
devstack-gate defined a default value. In ansible jobs the default is either the
|
||||||
value defined in the parent job, or the default from DevStack, if any.
|
value defined in the parent job, or the default from DevStack, if any.
|
||||||
|
|
||||||
============================================== ============= ==================
|
.. list-table:: **DevStack Gate Flags**
|
||||||
DevStack gate flag Repo New implementation
|
:widths: 20 10 60
|
||||||
============================================== ============= ==================
|
:header-rows: 1
|
||||||
OVERRIDE_ZUUL_BRANCH zuul override-checkout:
|
|
||||||
[branch]
|
* - DevStack gate flag
|
||||||
in the job definition.
|
- Repo
|
||||||
DEVSTACK_GATE_NET_OVERLAY zuul-jobs A bridge called
|
- New implementation
|
||||||
br-infra is set up for
|
* - OVERRIDE_ZUUL_BRANCH
|
||||||
all jobs that inherit
|
- zuul
|
||||||
from multinode with
|
- override-checkout: [branch] in the job definition.
|
||||||
a dedicated `bridge role <https://zuul-ci.org/docs/zuul-jobs/general-roles.html#role-multi-node-bridge>`_.
|
* - DEVSTACK_GATE_NET_OVERLAY
|
||||||
DEVSTACK_GATE_FEATURE_MATRIX devstack-gate ``test_matrix_features``
|
- zuul-jobs
|
||||||
variable of the
|
- A bridge called br-infra is set up for all jobs that inherit
|
||||||
test-matrix role in
|
from multinode with a dedicated `bridge role
|
||||||
devstack-gate. This
|
<https://zuul-ci.org/docs/zuul-jobs/general-roles.html#role-multi-node-bridge>`_.
|
||||||
is a temporary
|
* - DEVSTACK_GATE_FEATURE_MATRIX
|
||||||
solution, feature
|
- devstack-gate
|
||||||
matrix will go away.
|
- ``test_matrix_features`` variable of the test-matrix role in
|
||||||
In the future services
|
devstack-gate. This is a temporary solution, feature matrix
|
||||||
will be defined in
|
will go away. In the future services will be defined in jobs
|
||||||
jobs only.
|
only.
|
||||||
DEVSTACK_CINDER_VOLUME_CLEAR devstack *CINDER_VOLUME_CLEAR: true/false*
|
* - DEVSTACK_CINDER_VOLUME_CLEAR
|
||||||
in devstack_localrc
|
- devstack
|
||||||
in the job vars.
|
- *CINDER_VOLUME_CLEAR: true/false* in devstack_localrc in the
|
||||||
DEVSTACK_GATE_NEUTRON devstack True by default. To
|
job vars.
|
||||||
disable, disable all
|
* - DEVSTACK_GATE_NEUTRON
|
||||||
neutron services in
|
- devstack
|
||||||
devstack_services in
|
- True by default. To disable, disable all neutron services in
|
||||||
the job definition.
|
devstack_services in the job definition.
|
||||||
DEVSTACK_GATE_CONFIGDRIVE devstack *FORCE_CONFIG_DRIVE: true/false*
|
* - DEVSTACK_GATE_CONFIGDRIVE
|
||||||
in devstack_localrc
|
- devstack
|
||||||
in the job vars.
|
- *FORCE_CONFIG_DRIVE: true/false* in devstack_localrc in the job
|
||||||
DEVSTACK_GATE_INSTALL_TESTONLY devstack *INSTALL_TESTONLY_PACKAGES: true/false*
|
vars.
|
||||||
in devstack_localrc
|
* - DEVSTACK_GATE_INSTALL_TESTONLY
|
||||||
in the job vars.
|
- devstack
|
||||||
DEVSTACK_GATE_VIRT_DRIVER devstack *VIRT_DRIVER: [virt driver]*
|
- *INSTALL_TESTONLY_PACKAGES: true/false* in devstack_localrc in
|
||||||
in devstack_localrc
|
|
||||||
in the job vars.
|
|
||||||
DEVSTACK_GATE_LIBVIRT_TYPE devstack *LIBVIRT_TYPE: [libvirt type]*
|
|
||||||
in devstack_localrc
|
|
||||||
in the job vars.
|
|
||||||
DEVSTACK_GATE_TEMPEST devstack Defined by the job
|
|
||||||
tempest that is used. The
|
|
||||||
``devstack`` job only
|
|
||||||
runs devstack.
|
|
||||||
The ``devstack-tempest``
|
|
||||||
one triggers a Tempest
|
|
||||||
run as well.
|
|
||||||
DEVSTACK_GATE_TEMPEST_FULL tempest *tox_envlist: full*
|
|
||||||
in the job vars.
|
|
||||||
DEVSTACK_GATE_TEMPEST_ALL tempest *tox_envlist: all*
|
|
||||||
in the job vars.
|
|
||||||
DEVSTACK_GATE_TEMPEST_ALL_PLUGINS tempest *tox_envlist: all-plugin*
|
|
||||||
in the job vars.
|
|
||||||
DEVSTACK_GATE_TEMPEST_SCENARIOS tempest *tox_envlist: scenario*
|
|
||||||
in the job vars.
|
|
||||||
TEMPEST_CONCURRENCY tempest *tempest_concurrency: [value]*
|
|
||||||
in the job vars. This
|
|
||||||
is available only on
|
|
||||||
jobs that inherit from
|
|
||||||
``devstack-tempest``
|
|
||||||
down.
|
|
||||||
DEVSTACK_GATE_TEMPEST_NOTESTS tempest *tox_envlist: venv-tempest*
|
|
||||||
in the job vars. This
|
|
||||||
will create Tempest
|
|
||||||
virtual environment
|
|
||||||
but run no tests.
|
|
||||||
DEVSTACK_GATE_SMOKE_SERIAL tempest *tox_envlist: smoke-serial*
|
|
||||||
in the job vars.
|
|
||||||
DEVSTACK_GATE_TEMPEST_DISABLE_TENANT_ISOLATION tempest *tox_envlist: full-serial*
|
|
||||||
in the job vars.
|
|
||||||
*TEMPEST_ALLOW_TENANT_ISOLATION: false*
|
|
||||||
in devstack_localrc in
|
|
||||||
the job vars.
|
the job vars.
|
||||||
============================================== ============= ==================
|
* - DEVSTACK_GATE_VIRT_DRIVER
|
||||||
|
- devstack
|
||||||
|
- *VIRT_DRIVER: [virt driver]* in devstack_localrc in the job
|
||||||
|
vars.
|
||||||
|
* - DEVSTACK_GATE_LIBVIRT_TYPE
|
||||||
|
- devstack
|
||||||
|
- *LIBVIRT_TYPE: [libvirt type]* in devstack_localrc in the job
|
||||||
|
vars.
|
||||||
|
* - DEVSTACK_GATE_TEMPEST
|
||||||
|
- devstack and tempest
|
||||||
|
- Defined by the job that is used. The ``devstack`` job only runs
|
||||||
|
devstack. The ``devstack-tempest`` one triggers a Tempest run
|
||||||
|
as well.
|
||||||
|
* - DEVSTACK_GATE_TEMPEST_FULL
|
||||||
|
- tempest
|
||||||
|
- *tox_envlist: full* in the job vars.
|
||||||
|
* - DEVSTACK_GATE_TEMPEST_ALL
|
||||||
|
- tempest
|
||||||
|
- *tox_envlist: all* in the job vars.
|
||||||
|
* - DEVSTACK_GATE_TEMPEST_ALL_PLUGINS
|
||||||
|
- tempest
|
||||||
|
- *tox_envlist: all-plugin* in the job vars.
|
||||||
|
* - DEVSTACK_GATE_TEMPEST_SCENARIOS
|
||||||
|
- tempest
|
||||||
|
- *tox_envlist: scenario* in the job vars.
|
||||||
|
* - TEMPEST_CONCURRENCY
|
||||||
|
- tempest
|
||||||
|
- *tempest_concurrency: [value]* in the job vars. This is
|
||||||
|
available only on jobs that inherit from ``devstack-tempest``
|
||||||
|
down.
|
||||||
|
* - DEVSTACK_GATE_TEMPEST_NOTESTS
|
||||||
|
- tempest
|
||||||
|
- *tox_envlist: venv-tempest* in the job vars. This will create
|
||||||
|
Tempest virtual environment but run no tests.
|
||||||
|
* - DEVSTACK_GATE_SMOKE_SERIAL
|
||||||
|
- tempest
|
||||||
|
- *tox_envlist: smoke-serial* in the job vars.
|
||||||
|
* - DEVSTACK_GATE_TEMPEST_DISABLE_TENANT_ISOLATION
|
||||||
|
- tempest
|
||||||
|
- *tox_envlist: full-serial* in the job vars.
|
||||||
|
*TEMPEST_ALLOW_TENANT_ISOLATION: false* in devstack_localrc in
|
||||||
|
the job vars.
|
||||||
|
|
||||||
|
|
||||||
The following flags have not been migrated yet or are legacy and won't be
|
The following flags have not been migrated yet or are legacy and won't be
|
||||||
migrated at all.
|
migrated at all.
|
||||||
|
|
||||||
===================================== ====== ==========================
|
.. list-table:: **Not Migrated DevStack Gate Flags**
|
||||||
DevStack gate flag Status Details
|
:widths: 20 10 60
|
||||||
===================================== ====== ==========================
|
:header-rows: 1
|
||||||
DEVSTACK_GATE_TOPOLOGY WIP The topology depends on the base
|
|
||||||
job that is used and more
|
* - DevStack gate flag
|
||||||
specifically on the nodeset
|
- Status
|
||||||
attached to it. The new job
|
- Details
|
||||||
format allows project to define
|
* - DEVSTACK_GATE_TOPOLOGY
|
||||||
the variables to be passed to
|
- WIP
|
||||||
every node/node-group that exists
|
- The topology depends on the base job that is used and more
|
||||||
in the topology. Named topologies
|
specifically on the nodeset attached to it. The new job format
|
||||||
that include the nodeset and the
|
allows project to define the variables to be passed to every
|
||||||
matching variables can be defined
|
node/node-group that exists in the topology. Named topologies
|
||||||
in the form of base jobs.
|
that include the nodeset and the matching variables can be
|
||||||
DEVSTACK_GATE_GRENADE TBD Grenade Zuul V3 jobs will be
|
defined in the form of base jobs.
|
||||||
hosted in the grenade repo.
|
* - DEVSTACK_GATE_GRENADE
|
||||||
GRENADE_BASE_BRANCH TBD Grenade Zuul V3 jobs will be
|
- TBD
|
||||||
hosted in the grenade repo.
|
- Grenade Zuul V3 jobs will be hosted in the grenade repo.
|
||||||
DEVSTACK_GATE_NEUTRON_DVR TBD Depends on multinode support.
|
* - GRENADE_BASE_BRANCH
|
||||||
DEVSTACK_GATE_EXERCISES TBD Can be done on request.
|
- TBD
|
||||||
DEVSTACK_GATE_IRONIC TBD This will probably be implemented
|
- Grenade Zuul V3 jobs will be hosted in the grenade repo.
|
||||||
on ironic side.
|
* - DEVSTACK_GATE_NEUTRON_DVR
|
||||||
DEVSTACK_GATE_IRONIC_DRIVER TBD This will probably be implemented
|
- TBD
|
||||||
on ironic side.
|
- Depends on multinode support.
|
||||||
DEVSTACK_GATE_IRONIC_BUILD_RAMDISK TBD This will probably be implemented
|
* - DEVSTACK_GATE_EXERCISES
|
||||||
on ironic side.
|
- TBD
|
||||||
DEVSTACK_GATE_POSTGRES Legacy This flag exists in d-g but the
|
- Can be done on request.
|
||||||
only thing that it does is
|
* - DEVSTACK_GATE_IRONIC
|
||||||
capture postgres logs. This is
|
- TBD
|
||||||
already supported by the roles in
|
- This will probably be implemented on ironic side.
|
||||||
post, so the flag is useless in
|
* - DEVSTACK_GATE_IRONIC_DRIVER
|
||||||
the new jobs. postgres itself can
|
- TBD
|
||||||
be enabled via the
|
- This will probably be implemented on ironic side.
|
||||||
devstack_service job variable.
|
* - DEVSTACK_GATE_IRONIC_BUILD_RAMDISK
|
||||||
DEVSTACK_GATE_ZEROMQ Legacy This has no effect in d-g.
|
- TBD
|
||||||
DEVSTACK_GATE_MQ_DRIVER Legacy This has no effect in d-g.
|
- This will probably be implemented on ironic side.
|
||||||
DEVSTACK_GATE_TEMPEST_STRESS_ARGS Legacy Stress is not in Tempest anymore.
|
* - DEVSTACK_GATE_POSTGRES
|
||||||
DEVSTACK_GATE_TEMPEST_HEAT_SLOW Legacy This is not used anywhere.
|
- Legacy
|
||||||
DEVSTACK_GATE_CELLS Legacy This has no effect in d-g.
|
- This flag exists in d-g but the only thing that it does is
|
||||||
DEVSTACK_GATE_NOVA_API_METADATA_SPLIT Legacy This has no effect in d-g.
|
capture postgres logs. This is already supported by the roles
|
||||||
===================================== ====== ==========================
|
in post, so the flag is useless in the new jobs. postgres
|
||||||
|
itself can be enabled via the devstack_service job variable.
|
||||||
|
* - DEVSTACK_GATE_ZEROMQ
|
||||||
|
- Legacy
|
||||||
|
- This has no effect in d-g.
|
||||||
|
* - DEVSTACK_GATE_MQ_DRIVER
|
||||||
|
- Legacy
|
||||||
|
- This has no effect in d-g.
|
||||||
|
* - DEVSTACK_GATE_TEMPEST_STRESS_ARGS
|
||||||
|
- Legacy
|
||||||
|
- Stress is not in Tempest anymore.
|
||||||
|
* - DEVSTACK_GATE_TEMPEST_HEAT_SLOW
|
||||||
|
- Legacy
|
||||||
|
- This is not used anywhere.
|
||||||
|
* - DEVSTACK_GATE_CELLS
|
||||||
|
- Legacy
|
||||||
|
- This has no effect in d-g.
|
||||||
|
* - DEVSTACK_GATE_NOVA_API_METADATA_SPLIT
|
||||||
|
- Legacy
|
||||||
|
- This has no effect in d-g.
|
||||||
|
|||||||
@ -10,7 +10,7 @@ into it.
|
|||||||
|
|
||||||
The devstack base directory.
|
The devstack base directory.
|
||||||
|
|
||||||
.. zuul:rolevar:: devstack_sources_branch
|
.. zuul:rolevar:: devstack_sources_branch
|
||||||
:default: None
|
:default: None
|
||||||
|
|
||||||
The target branch to be setup (where available).
|
The target branch to be setup (where available).
|
||||||
|
|||||||
Loading…
Reference in New Issue
Block a user