cmem-plugin-git

Read files from a git repository and commit files back into one.

This is a plugin for eccenca Corporate Memory. You can install it with the cmemc command line client like this:

cmemc admin workspace python install cmem-plugin-git

Tasks

• List Git files lists what a repository holds at one revision, without transferring any file content.
• Download Git files reads the selected files and hands them to the next task in the workflow.
• Upload Git files commits the files of the preceding task into a folder of a repository and pushes them.

All three talk to a repository over HTTP(S) with an access token, work on the objects of the repository rather than on a checkout, and therefore transfer only what they were asked for. Git LFS content, SSH remotes, merge and pull requests, tags and repository history are out of scope. A file uploaded into a path the repository tracks with Git LFS is committed as ordinary content rather than as an LFS pointer.

Access rights

The tasks speak the git HTTP protocol only and never call a forge API, so the token needs repository access and nothing else.

A public repository needs no token at all. The user name sent alongside the token is ignored by GitHub and checked by GitLab, so it defaults to gitlab-ci-token, which GitLab accepts for a repository token. On GitLab the token's role has to allow pushing to the target branch as well, which a protected branch restricts to maintainers by default. Upload Git files offers a Check connection action that asks the server for a write handshake without pushing anything, so an insufficient token shows up while the task is being configured.