Commit Graph

125 Commits

Author SHA1 Message Date
Dr. Jens Harbott de83f11f69 Fixes for tox4
- Replace long deprecated whitelist_externals with allowlist_externals.
- Drop basepython option that is no longer needed.
- Invoke bash scripts with explicit bash command instead of allowlisting
  every single script.

Change-Id: I2b70ebb3b1ee94ad75e46295d788312c5e183748
2023-01-04 20:01:46 +01:00
Andreas Jaeger f7c73f8c69 Update for openstack-doc-tools 2.0
With the new release, we can remove some hacks ;)

Change-Id: Ifccb5879e62531495f2c8b470dace294e991ca58
2019-08-22 13:31:49 +02:00
Andreas Jaeger 1d08a657f6 Simplify publishdocs et al
We don't have different content for build and publish, so can cleanup
our scripts and remove any special handling.

Remove also usage of www-index.html.

Change-Id: If1a9d9a2dddbf7cdf9fd4c01d22530f2cd181907
2019-08-16 16:46:43 +02:00
Andreas Jaeger c1cc9cae1f Cleanup jobs and config
Use promote jobs for all publishing jobs, they work fine.

We don't use checkbuild/checklang anymore, remove it.

Keep checkbuild job until we have renamed training-guides to use the new
job.

Change-Id: I882fd90f07987358cd55e3a04a8f7ad0c746ce80
2019-08-16 16:19:56 +02:00
Andreas Jaeger 99920e8a49 Use opendev-tox-docs job
Switch our docs job to use opendev-tox-docs job as base so that we can
publish later the content from gate directly (via promote queue) and do
not need to rebuild in post again.

Use the new promote-openstack-manuals job as first step in using promote
publishing. The other publish jobs will be replaced separately.

Use for building now publishdocs/publishlang so that we have exactly
the same content in check and gate - and in the published website.
For this, update tox.ini and publish script.

Also, do not publish project-data.

Depends-On: https://review.opendev.org/676489
Change-Id: I91f22173a4a6ed421f339833c486a31fd319dba3
2019-08-15 21:45:02 +02:00
Andreas Jaeger 741d59c459 Switch output to publish-docs/html
Publishing to a top-level directory has a few challenges with some new
infra scripts. Let's keep those simple and change from publish-docs to
publish-docs/html.

Depends-On: https://review.opendev.org/676489
Change-Id: I94b7bf915c0fdad0e9e2f5dd81846f45dc99194a
2019-08-15 06:46:46 +02:00
Andreas Jaeger 19db787551 Cleanup after api-quick-start import
Remove extra whitespace, line wrap overlong lines, convert too long
table to list-table, remove all setup.cfg files since we don't need them
anymore.

Change-Id: Icb0dc37c21927ecc6de163ae1b0245aea9b9c202
2019-07-17 11:08:28 +02:00
Andreas Jaeger a95821b542 Import api-quick-start
Import the api-quick-start from api-site repository so that it gets
published on docs.openstack.org.

Change-Id: Ic709ee736dda780fb71048a27158838a5806048e
2019-07-16 16:48:32 +02:00
Vieri 460f6eeea2 Update min tox version to 2.0
The commands used by constraints need at least tox 2.0.  Update to
reflect reality, which should help with local running of constraints
targets.

Change-Id: Ib020170f365fa264e4aebb556a4901e5233336e4
2018-11-02 06:44:12 +00:00
Doug Hellmann 4390a71381 switch the build to use python3
Update the build to use python3 as part of the python3-first goal.

Change-Id: Ia94e4ed3881aa6a9c3d2da3303d76d4136876ce9
Signed-off-by: Doug Hellmann <doug@doughellmann.com>
2018-06-28 15:31:10 -04:00
Andreas Jaeger 21edbc931f Fix ZUUL_REFNAME
Set up the variables the same way the post job is set up:
Pass them in via environment in job definition.

Pass ZUUL_ environment variables through to jobs.

Note ZUUL_REFNAME is not set, use ZUUL_BRANCH instead.

Change-Id: I5863a05384c9a48445d5ce52ccc508519c7c00f8
2017-11-23 17:16:14 +01:00
Andreas Jaeger 9f40d75a78 Remove checkniceness
We do not need this tox environment anymore, remove it.

Also, update documentation for jobs with Zuul v3.

Change-Id: I226835ad57af775a77e4719c5dcf7d13010ebd76
2017-10-27 10:13:19 +00:00
Doug Hellmann adefde9826 make checkniceness an alias for linters in tox
The parent patch added a linters environment as an alias for
checkniceness. This makes linters the "real" environment and
checkniceness the alias.

Change-Id: I9778abf3315e62f9db2a8d98dfb4bc5e9e2e869d
Signed-off-by: Doug Hellmann <doug@doughellmann.com>
2017-10-09 10:04:06 -04:00
Andreas Jaeger 8439442601 Prepare for Zuul v3
As part of migration to zuul v3, replace checkniceness by linters tox
target to use a more "common" target accross OpenStack.

Remove the msgfmt check, this is now done in the translation sync
scripts, so no need to run it again here.

Change-Id: Ie50dba2c1eb7cbb2ce4d3ddf5b35dddaf355cb7f
2017-10-07 19:25:23 +02:00
Doug Hellmann dcd0ce9584 use whereto to test redirect rules
Add a file containing the tests for all of the redirect rules and set
up whereto to run during the check. The test file is a template, just
like the htaccess file, to ensure we auto-generate the rules for all
of the various project redirects.

Fix a few issues with the template generator that ended up producing
duplicate or useless rules.

Change-Id: I0d306149dc33f64d44d9482fab02101bd1f6d7f5
Signed-off-by: Doug Hellmann <doug@doughellmann.com>
2017-08-25 18:56:14 -04:00
Andreas Jaeger 639f235b23 Cleanup tox.ini
Remove targets and files that are not used anymore.

Change-Id: I48c44a1cf86db86e11e574cfc68696a0c1070504
2017-07-21 20:25:56 +02:00
Andreas Jaeger 33e278602f Update RST building
No need for build-install-guides-rst.sh, move to build-all-rst.sh.
Simplify build-all-rst.sh since we now do not have versioned or draft
docs anymore.

Change-Id: I213eff811d83ddfb1da3bb15dd8c99adeec93eb9
2017-07-21 20:25:56 +02:00
Andreas Jaeger aa0743a8e4 Remove obsolete comments and usage
We do not build and translate docbook XML anymore, so do not need
Generatedocbook anymore. Remove the now obsolete comment and also the
sitepackages usage that was only needed for these.

Change-Id: I383a09b557f67bf490f9bfa4b9e30ebe416d95ac
2017-04-02 18:22:41 +02:00
Anne Gentle e83d3baffc Does not build PDF by default with tox -e docs
* Will build PDF by default when using publish though.

Change-Id: I3fc45c4ff657a394316a0bc5d71b2260507b80b3
2017-03-01 20:20:27 +09:00
Jenkins ab4eeb9c52 Merge "tox: Disable doc8 checks for autogenerated tables" 2017-03-01 03:56:11 +00:00
Andreas Jaeger b06db69322 Document bindep usage
We use bindep to install our requirements, explain how to use it.

Also, add the bindep tox environment.

See also
https://docs.openstack.org/infra/manual/drivers.html#package-requirements

Change-Id: Ief208e5649223d9d3577ee0a30afdc7db35a86a9
2017-02-24 18:38:46 +00:00
Stephen Finucane 90e9b4cf67 tox: Disable doc8 checks for autogenerated tables
There are some doc8 rules which would be valuable for these
autogenerated files (like whitespace checks), however, some others do
not make any sense (mainly line length). As it does not appear to be
possible to use wildcards for the 'ignore-path-errors' setting, so we
must disable all checks on the files themselves.

Change-Id: I0adc353d1f1c975ae788a8e38d9c9b12168b23e5
Signed-off-by: Stephen Finucane <sfinucan@redhat.com>
2017-02-22 09:40:58 -05:00
Andreas Jaeger d4f58113f9 Test that glossary is sorted
Test that glossary entries are sorted and fail the niceness test if not.

Sort those entries that were not sorted.

Change-Id: I40eec5e6132bd79899456de505406ac2fa4ca32f
2016-11-14 16:43:19 +01:00
Matthew Kassawara 26ade188b3 [networking] Reorganize deployment examples
Major reorganization and rewriting of deployment examples to
use "building blocks" that enable the audience to begin with
a simple architecture and add complexity as necessary. Also
reduces duplication of content.

Configuration and commands reference Mitaka to ease backporting
to Mitaka. After merge, I will submit another patch to update
the configuration and commands for Newton.

Macvtap content needs a significant rewrite to integrate
better with the deployment examples. Will address in Ocata.

Change-Id: I2ae95d726aa053a0f30507a3e68907ac56296e6b
backport: mitaka
2016-10-06 12:32:20 -06:00
gengchc2 c4ced7f919 Update flake8 ignore list
In hacking > 0.10.0, there is no E123 and E125, so this commit to
delete them.

Change-Id: I21ed6315821d3dbf98b03042225251c400147cd4
2016-09-28 10:48:08 +08:00
xianming mao 6ce13e315c Modify the config message in tox.ini
There have no direction openstack/common in this project,so
we can delete it.

And the H803 has been deprecated,so we can delete it either.
More details:https://github.com/openstack-dev/hacking/blob/master/setup.cfg

Change-Id: If9bbdad02f836128909525f09c0f77ac0a6effd2
2016-09-25 16:28:39 +08:00
Andreas Jaeger e161549f04 Do not delete releasenotes before building
With the options given to sphinx, we regenerate releasenotes , there's
no need to rm -rf the content before - it will only break a proposed
way to translate the content.

Change-Id: I17d72f3561c25c0d7dd7f1c9ec09c57c1e8df798
2016-09-19 09:19:21 +02:00
Andreas Jaeger 4339c071bb Update for openstack-doc-tools 1.0.0
Require the new release and remove openstack-doc-test from
checkniceness, this was only needed for docbook XML files.
The command does not exist anymore.

Change-Id: I88c39f3c85935300c0377c028997f5009969b373
2016-08-22 18:10:19 +02:00
KATO Tomoyuki b80b303178 remove unused path from checkniceness ignore-path
Change-Id: I7366882be2c45eece3608bc7bb1c00507822b559
2016-07-21 23:52:54 +09:00
Andreas Jaeger 5fe5fedd48 Revert "Add zuul-cloner-test environment"
Testing was done successfully.

This reverts commit d50faa7acd.

Change-Id: Ifa339785f1e9d73ee45ffb91faad90f5db2d4143
2016-07-17 14:06:27 +00:00
Andreas Jaeger d50faa7acd Add zuul-cloner-test environment
This is needed for some OpenStack CI testing, it will be removed once
the job is working correctly.

Related Change: I7343d54185a896b847d6340532bdab22465e98f0
Change-Id: Ib6d45031866790ee73000cf514e1263a7e8dff69
2016-07-15 08:17:43 +02:00
KATO Tomoyuki 31b31410f9 Factor out Install Guide for Debian with debconf
To simplify the build tool chain,
factor out Install Guide for Debian with debconf.
Continueously, keep Install Guide for Debian without debconf
in the doc/install-guide directory. Also, use the contents
at doc/install-guide as possible for consistency.

On the following patches, clean up doc/install-guide sources
to cleanup the contents and build tool chains.

Change-Id: I8df6b3b382137d08d60f85bc41bcd98ac1f4eb47
2016-05-19 17:37:53 +09:00
KATO Tomoyuki 07396af70a Remove work around for fix released problem
Change-Id: I7478cc99adec8c1f421c043fd2daaba6ef4ca913
2016-05-05 19:59:27 +09:00
Andreas Jaeger 48b407ef99 Cleanup tox environment
Since we do not build DocBook XML anymore, we have removed the jobs for
this and thus can remove the support for these also from tox.ini.

checksyntax, checklinks and checkdeletions are DocBook XML only targets,
so remove them.

Change-Id: Iaa663c03fd6e2976208e20ba03dbab4d8d82b2ce
Depends-On: I9f5944eb9db06fe2ff9088f22048c198b2921237
2016-05-02 10:05:41 +02:00
Andreas Jaeger ed100316b4 Convert glossary to RST
We do not need the DocBook XML glossary anymore, since we do not build
any DocBook guides that use it.

Add instead the RST version of the document to git.
Adjust scripts to not build or publish the glossary anymore.

Change-Id: Id4bfef7666690e6d08291f664751db7a4d4d5983
2016-05-02 09:20:30 +02:00
Andreas Jaeger 6a01aa42d1 Prepare releasenotes for publishing
Move release notes into releasenotes and add tox target so that
infra scripts will publish them to
docs.openstack.org/releasenotes/openstack-manuals

Infra change: Icbe135e37c78e0a3a1c6d3243f7128c0b881325d

Note that the directory layout here is this way on purpose - we want to
reuse the same jobs other repos use, just the difference is we're not
using reno for this.

Change-Id: I00a53d8b3d9bef28b480be22af2e6647fa26448a
2016-03-18 12:46:15 +01:00
zhangguoqing ee6853461a [install-guides] make pipeline configuration actual one line
"pipeline" must be only one line in ceilometer-swift.rst, which it
easy to misguide deployer to four lines before this patch set.

Change-Id: I2c2af5d026b335394660780913c9bbb2392e3b7c
2016-03-17 22:52:18 +08:00
KATO Tomoyuki f6ce6bd328 Rename common-rst to common
Keep the sync target repo path "common-rst" as of now.

Change-Id: I552d2c0a422c4824632b11fa273629004b889306
2016-02-11 21:18:59 +09:00
Matthew Kassawara 6e74e65392 [network] Preparation for Liberty/Mitaka updates
Prepare the networking guide for Liberty/Mitaka updates as
follows:

1) Change "legacy" to "classic" to provide a more positive
   connotation of such scenarios. Legacy should refer to
   nova-network.
2) Replace underscore with hyphen in filenames to meet
   conventions.
3) Replace :doc: with :ref: to minimize impact of future
   file renames.

Change-Id: I95bdd84b4a01cd9cbd06cad66821ad810295394f
backport: Liberty
2016-01-14 06:58:29 -07:00
chenghang fb75840d3c Fix typo in tox.ini
tox.ini Line:133
lineos -> linenos

Change-Id: If2b19b065bec2c1b6ee9e30ffb75fa03e9bcb0a9
2015-12-31 10:51:11 +00:00
Andreas Jaeger cbeb4d5c5b Revert "Add reno for release-notes"
As discussed via email, let's do this on a smaller scale.

This reverts commit 9432a6da0c.

Change-Id: I27e9cd06c5d69917abe452e873873683e10c282a
2015-11-10 14:49:13 +00:00
Andreas Jaeger 9432a6da0c Add reno for release-notes
Add renote to automatically generate release notes - the same way other
OpenStack projects do it.
For details see
http://lists.openstack.org/pipermail/openstack-dev/2015-November/078301.html

Change-Id: Iac8f34ae3490b7788c989b17be3e6a616e65c676
2015-11-07 17:34:29 +01:00
Christian Berendt 08b31a9c18 tox: add a generic environment to build a RST guide
With this environment it is possible to build a single RST guide with
the following common: tox -e build -- NAME

E.g. to build the contributor guide run the following command:

tox -e build -- contributor-guide

Change-Id: I94cf504eece14b2b8d2734cb5b4c16a1b409026f
2015-10-08 19:30:11 +02:00
Andreas Jaeger 34823b69ff Enhance generatepot-rst for reuse
Enhance file so that it can be used by other documentation repos as
well.
Update invocation of it.

Change-Id: I93a6d8ccb8c314c0961b87a239462183712cdd26
2015-10-06 20:11:17 +02:00
Andreas Jaeger 8750c28ab1 Set giturl for openstackdocstheme 1.2.3
Also whitelist conf.py by flake8.

Co-Authored-By: Bernd Bausch <berndbausch@gmail.com>
Change-Id: I9899fde4586a44aa4dd4e48402a3f25933bebc4a
2015-10-06 13:45:57 +02:00
Christian Berendt 721139f880 Add environments to build install guides individually
Change-Id: I0741098b99c4d05cb38cf38a604f549f21a49916
2015-09-16 19:36:20 +02:00
Andreas Jaeger 0c8798bf2d Add linkcheck for RST
Check RST files for valid links.

This is a separte target for now to evaluate how useful it is.
Whitelist build.opensuse.org URL for user-guide.
Remove also checklang from default tox invocation since it's not needed
to run by default.

Change-Id: I6c275518b9e55ab3b6bcea52894ea851924bee94
2015-08-25 06:29:37 +02:00
Sam Stoelinga 27abd34177 Add advanced SR-IOV section to networking guide
Co-Authored-By: Moshe Levi <moshele@mellanox.com>

Closes-bug: #1476242

Change-Id: Idf85af2153da2ce51383542f4c2616c62b56bafb
2015-08-22 01:23:49 +08:00
Andreas Jaeger 0a4e814f50 Gate at RST line length of 79 chars
With this patch, the RST files have no line longer than 79 chars -
as discussed on the docs mailing list - and we
can gate on it. Previously this limit was 100 chars.

Change-Id: I23f550db81e9264649d0444f5f1ba1be0d6d343d
2015-06-20 21:17:26 +02:00
Jenkins 6621f65d32 Merge "[install-guide-rst] Set up conditionals for distros" 2015-06-18 07:26:59 +00:00