Github hooks support about docs.ubuntu.com HOT 3 CLOSED

The shape of the solution

There are going to be a number of steps in getting this done. I think these steps are of sufficient size that we should split them out into separate issues to be worked on independently:

• Update the docs.ubuntu.com project, including:
  • A library for reading the configuration file and pulling documentation sets into a build directory
  • Symlinks from the templates & static directories to the latest version of the built documentation
  • A manage.py script to kick off the build
• Update the spec to:
  • Use Python 3 (documentation-builder needs python >= 3.5)
  • Run the ./manage.py build job on a cron schedule
  • Store the build directory in a shared location, e.g. using an nfs charm
• Mirror GitHub projects into Launchpad - we may have to pull from there instead

from docs.ubuntu.com.

I've now split this out into a number of issues, which should probably be done more-or-less in this order:

1. #65: Methods for auto-updating an individual set of documentation from the source repository
2. #64: Upgrade deployed environment to Python 3
3. #66: Web-hook for triggering a new build of a documentation set
4. Now we can do a release
5. #63: Mirror documentation repositories into Launchpad
6. #62: Implement shared filesystem in deployed environment (nice-to-have)

from docs.ubuntu.com.

After discussing this, we have decided it's not feasible. This is because it would require a persistent file-based storage layer in production, and we don't have a good solution for that right now.

The best hope for trying to address similar problems is now the kubernetes deployments plan.

from docs.ubuntu.com.