Page MenuHomePhabricator
Create Task
Maniphest T179593

Cumin: upload generated documentation to doc.w.o
Closed, ResolvedPublic
Actions

Description

Cumin generates it's configuration with Sphinx as part of running tox, in particular tox -e sphinx.
The generated documentation is in /home/jenkins/workspace/tox-jessie/doc/build/html when run as part of CI.

It will be nice to have it uploaded to doc.wikimedia.org.

Ideally I would like to have:

  • the documentation for the latest tag (vX.Y.Z)
  • [optional] keep the documentation of previous tags available while going forward
  • [optional] generate the documentation for the master branch. It's usage will be mostly to check the generated documentation of new features and updates to the documentation itself, although for that would be more useful to be able to check it in the CR before merging.

Details

SubjectRepoBranchLines +/-
Fix castor deleting /home/jenkins/workspace on Nodepoolintegration/configmaster+5 -1
Generate cumin doc solely for the master branchintegration/configmaster+3 -0
Add link to Cumin documentationintegration/docrootmaster+1 -0
Fix publish jobs when triggered from a tagintegration/configmaster+44 -3
Publish doc for cuminintegration/configmaster+20 -8
Customize query in gerrit

Event Timeline

Volans created this task.Nov 2 2017, 3:55 PM
Restricted Application added a subscriber: Aklapper. · View Herald TranscriptNov 2 2017, 3:55 PM
hashar added a project: Release-Engineering-Team (Kanban).Nov 2 2017, 3:56 PM
gerritbot subscribed.Nov 3 2017, 10:01 AM

Change 388403 had a related patch set uploaded (by Hashar; owner: Hashar):
[integration/config@master] Publish doc for cumin

https://gerrit.wikimedia.org/r/388403

gerritbot added a project: Patch-For-Review.Nov 3 2017, 10:01 AM
gerritbot added a comment.Nov 3 2017, 11:14 AM

Change 388403 merged by jenkins-bot:
[integration/config@master] Publish doc for cumin

https://gerrit.wikimedia.org/r/388403

Stashbot subscribed.Nov 3 2017, 11:17 AM

Mentioned in SAL (#wikimedia-releng) [2017-11-03T11:17:21Z] <hashar> generate doc for cumin ( T179593 ) : contint1001$ zuul enqueue --trigger gerrit --pipeline postmerge --project operations/software/cumin --change 388261,2

Stashbot added a comment.Nov 3 2017, 12:38 PM

Mentioned in SAL (#wikimedia-releng) [2017-11-03T12:38:56Z] <hashar> T179593 generate doc for cumin@v1.2.2 : contint1001$ zuul enqueue-ref --trigger gerrit --pipeline publish --project operations/software/cumin --ref refs/tags/v1.2.2 --newrev f7453873ff7c242743a22b119fc5e2171321c38b

hashar added a comment.Nov 3 2017, 1:06 PM

I have triggered the job against the last merged change https://gerrit.wikimedia.org/r/#/c/388261/
Build: https://integration.wikimedia.org/ci/job/cumin-tox-publish/1/console
Something got generated at https://doc.wikimedia.org/cumin/master/

Tags are broken though.

gerritbot added a comment.Nov 3 2017, 1:13 PM

Change 388441 had a related patch set uploaded (by Hashar; owner: Hashar):
[integration/config@master] Fix publish jobs when triggered from a tag

https://gerrit.wikimedia.org/r/388441

gerritbot added a comment.Nov 3 2017, 1:31 PM

Change 388441 merged by jenkins-bot:
[integration/config@master] Fix publish jobs when triggered from a tag

https://gerrit.wikimedia.org/r/388441

hashar closed this task as Resolved.Nov 3 2017, 1:34 PM
hashar claimed this task.

I have used a different job to handle the tags.

Build: https://integration.wikimedia.org/ci/job/cumin-tox-tag-publish/1/console
Doc: https://doc.wikimedia.org/cumin/v1.2.2/

gerritbot added a comment.Nov 3 2017, 1:54 PM

Change 388445 had a related patch set uploaded (by Volans; owner: Volans):
[integration/docroot@master] Add link to Cumin documentation

https://gerrit.wikimedia.org/r/388445

gerritbot added a comment.Nov 3 2017, 2:06 PM

Change 388445 merged by jenkins-bot:
[integration/docroot@master] Add link to Cumin documentation

https://gerrit.wikimedia.org/r/388445

gerritbot added a comment.Nov 3 2017, 3:18 PM

Change 388458 had a related patch set uploaded (by Hashar; owner: Hashar):
[integration/config@master] Generate cumin doc solely for the master branch

https://gerrit.wikimedia.org/r/388458

gerritbot added a comment.Nov 3 2017, 3:22 PM

Change 388458 merged by jenkins-bot:
[integration/config@master] Generate cumin doc solely for the master branch

https://gerrit.wikimedia.org/r/388458

gerritbot added a comment.Nov 3 2017, 10:11 PM

Change 388668 had a related patch set uploaded (by Hashar; owner: Hashar):
[integration/config@master] Fix castor deleting /home/jenkins/workspace on Nodepool

https://gerrit.wikimedia.org/r/388668

gerritbot added a comment.Nov 3 2017, 10:20 PM

Change 388668 merged by jenkins-bot:
[integration/config@master] Fix castor deleting /home/jenkins/workspace on Nodepool

https://gerrit.wikimedia.org/r/388668

• Phabricator_maintenance edited projects, added RelEng-Archive-FY201718-Q2; removed Release-Engineering-Team (Kanban).Dec 21 2017, 6:55 PM
Aklapper edited projects, added Cumin; removed SRE-tools.May 10 2023, 11:15 AM
Maintenance_bot removed a project: Patch-For-Review.May 10 2023, 11:31 AM
Restricted Application added a project: Infrastructure-Foundations. · View Herald TranscriptMay 10 2023, 11:31 AM
Content licensed under Creative Commons Attribution-ShareAlike (CC BY-SA) 4.0 unless otherwise noted; code licensed under GNU General Public License (GPL) 2.0 or later and other open source licenses. By using this site, you agree to the Terms of Use, Privacy Policy, and Code of Conduct. · Wikimedia Foundation · Privacy Policy · Code of Conduct · Terms of Use · Disclaimer · CC-BY-SA · GPL