Skip to content
Snippets Groups Projects

Upload generated documentation to our webserver

This merge requests adds a create_docs task to our .gitlab-ci.yml. The task will generate docs using sphinx and then push the results to our web server using rsync.

The job uses 3 variables, but only two of them are exposed in the CI configuration:

create_docs:
(...)
  variables:
    docs_upload_host: hosted-024-173.rz.uni-augsburg.de # hostname of target web server
    docs_path_component: icartt # if your path/URL should contain a stub, different than the (Gitlab) project name.

The third variable is docs_ssh_key which is private an thus has to be configured as a masked variable using the Gitlab Web UI.

The proposed task fetches the current projects version using poetry version -s, e.g. for the current HEAD it would upload to: https://mbees.med.uni-augsburg.de/docs/icartt/2.0.0-rc1/

You may find some internal documentation on how to set it up on https://mbees.med.uni-augsburg.de/dokuwiki/doku.php?id=it:services:documentationhosting

Merge request reports

Checking pipeline status.

Merged by Christoph KnoteChristoph Knote 2 years ago (Apr 28, 2022 11:43am UTC)

Loading

Pipeline #149 passed

Pipeline passed for ec21b3b7 on master

Activity

Filter activity
  • Approvals
  • Assignees & reviewers
  • Comments (from bots)
  • Comments (from users)
  • Commits & branches
  • Edits
  • Labels
  • Lock status
  • Mentions
  • Merge request status
  • Tracking
Please register or sign in to reply
Loading