search

debops / debops-playbooks

Ansible playbooks used by DebOps project
GNU General Public License v3.0
489 stars 88 forks source link

Proposed role: debops.rtfd #319

Open ypid opened 8 years ago

ypid commented 8 years ago

As it seems to me that we now hit the build time limit on readthedocs.org I would suggest we write a role to self host our own read-the-docs service. Anyone wants to do it? This is kind of urgent.

Ref: https://read-the-docs.readthedocs.io/en/latest/install.html Obsoletes proposal: debops.sphinx Related to: https://github.com/debops/docs/issues/147

drybjed commented 8 years ago

Sounds like the role could be based on the debops.netbox role which deploys Python application using virtualenv.

ypid commented 7 years ago

I have just been playing with GitLab and this could also be solved with using GitLab CI. The docs get build currently during CI anyway (Travis CI). Using GitLab artifacts and GitLab Pages, it is pretty easy to set it up so that in the test stage the docs get build and only if that succeeds, the docs get deployed. I actually quite like this approach. Also because then the docs are only build once. No redundant builds and we already have the roles for GitLab :)

Example: https://gitlab.com/ypid/hc (Check the coverage report)