[GRASS-git] [OSGeo/grass-addons] abbdb3: cronjobs: script to retrieve and unpack manual art...

[Markus Neteler]

  Branch: refs/heads/grass8
  Home:   https://github.com/OSGeo/grass-addons
  Commit: abbdb350e6c443969a92a65d84c72cc1e8da770c
      https://github.com/OSGeo/grass-addons/commit/abbdb350e6c443969a92a65d84c72cc1e8da770c
  Author: Markus Neteler <neteler at osgeo.org>
  Date:   2025-08-03 (Sun, 03 Aug 2025)

  Changed paths:
    M utils/cronjobs_osgeo_lxd/cron_job_list_grass
    A utils/cronjobs_osgeo_lxd/fetch_unpack_manual_GHA.sh
    A utils/cronjobs_osgeo_lxd/gh_cli_download_artifact.sh

  Log Message:
  -----------
  cronjobs: script to retrieve and unpack manual artifacts from GitHub (#1447)

* cronjobs: new script to retrieve manual artifacts from GitHub on OSGeo servers

The mkdocs based manual pages (currently the GRASS 8.5 main branch) are generated as a ZIP file through the GitHub Actions.
This ZIP file needs then to be transferred and unpacked in the related directories on grass.osgeo.org/ and download.osgeo.org/grass/.

This script downloads the latest "mkdocs-site" ZIP artifact from the "documentation.yml" workflow runs.

How this script works:
- the person to execute this script needs to generate a new read-only token: https://github.com/settings/personal-access-tokens
- the person to execute this script on the GRASS/OSGeo servers needs to `cd` to the repo; login via gh auth login using the token
- CAVEAT: these tokens expire after three months! - unsolved problem at time
- in this script:
  - the last successful workflow run is identified via GH CLI
  - artifacts for this run are looked up
  - the artifact is downloaded as ZIP file (takes a moment)

Eventually the ZIP archive needs to be unpacked in the right server directory (done by another script).

* fix REPO_LOCAL path to that needed on grass.osgeo.org

* add fetch_unpack_manual_GHA.sh and related crontab entry

* fix script locations

---------

Co-authored-by: Edouard Choinière <27212526+echoix at users.noreply.github.com>



To unsubscribe from these emails, change your notification settings at https://github.com/OSGeo/grass-addons/settings/notifications