Page MenuHomePhabricator

Research and document how to set up auto-updating of Toolforge tools from a GitHub repository
Closed, ResolvedPublic

Description

The popularity and familiarity of GitHub as a code hosting and collaboration platform cannot be understated when considering the visibility and approachability of projects hosted there — and indeed, many of the tools on Toolforge have their repositories either primarily hosted at GitHub, or mirrored there. This setup is even documented in the Toolforge help pages in wikitech.org.

However, the workflow with this setup remains somewhat cumbersome, requiring the tool author to log in to Toolforge and manually pull any new changes to the repos in order for the tool to get the newest features and fixes.

This task is about investigating the technical options for implementing an auto-update setup where the tool in Toolforge fetches updates whenever they're available, without any human intervention, and documenting them in an approachable and way, so that tool authors can easily adopt this workflow if indeed it is more convenient to them.

Event Timeline

Restricted Application added a subscriber: Aklapper. · View Herald TranscriptMay 19 2019, 9:01 PM
waldyrious triaged this task as Normal priority.May 19 2019, 9:02 PM
waldyrious closed this task as Resolved.May 19 2019, 9:07 PM

Done. Various approaches were investigated and experimented with, and the simplest one was documented thoroughly, in a step-by-step guide, in Help:Toolforge/Auto-update a tool from GitHub. Links to the new guide were added to Help:Toolforge#Using Github or other external service and Help:Toolforge/How to, for discoverability.

Thanks @Chicocvenancio, @zhuyifei1999 and @bd808 for the technical advice and discussions, assistance in various steps of the process, and review of the final text (and patience!).