ol-openedx-git-auto-export 0.9.0

Setup github authentication for plugin

If you’re testing from a docker machine running devstack setup github authentication for plugin, you’ll need to generate SSH keys in that machine and add them to your Github account (https://help.github.com/articles/generating-a-new-ssh-key-and-adding-it-to-the-ssh-agent/ - https://help.github.com/articles/adding-a-new-ssh-key-to-your-github-account)

Studio/CMS UI settings

• Open studio admin at /admin/ol_openedx_git_auto_export/contentgitrepository/

• Add your course_id and in the GIT URL, add your OLX git repo. For example git@github.com:<GITHUB_USERNAME>/edx4edxlite.git.

• Make a change to the course content and publish.

  • When using Tutor, attach with the CMS container using tutor dev/local start cms and enter yes to the prompt to add the GitHub to known hosts.

  • You should see a new commit in your OLX repo.

  • Commit user should be the one that published the change.

  • If user is not available, it should be the default one set in GIT_EXPORT_DEFAULT_IDENT.

• Test commit count increase on your OLX repo.

Library v1 (Legacy Libraries)

Library Key Format: library-v1:org+library

Supported Operations:

• ✅ Auto-export on update: When you update/publish a library v1, changes are automatically exported to git

• ✅ Auto-repo creation: Library v1 does NOT have a creation signal in Open edX, so the GitHub repository is automatically created on the first library update signal

Setup for Library v1:

1. Enable the library feature flags in your config:

   "FEATURES": {
       "ENABLE_GIT_AUTO_LIBRARY_EXPORT": true,
       "ENABLE_AUTO_GITHUB_LIBRARY_REPO_CREATION": true
   }

2. Make changes to your library and publish

Library v2 (Content Libraries)

Library Key Format: lib:org:slug

Supported Operations:

• ✅ Auto-export on update: When you update a library v2, changes are automatically exported to git

• ✅ Auto-repo creation: When you create a new library v2, a GitHub repository can be automatically created

Setup for Library v2:

1. Enable the library feature flags in your config:

   "FEATURES": {
       "ENABLE_GIT_AUTO_LIBRARY_EXPORT": true,
       "ENABLE_AUTO_GITHUB_LIBRARY_REPO_CREATION": true
   }

2. When creating a new library v2, if ENABLE_AUTO_GITHUB_LIBRARY_REPO_CREATION is enabled, a GitHub repository will be created automatically

3. Updates to the library will be automatically exported to git

Important Notes:

• Library v1 does not emit a creation signal, so the GitHub repository is automatically created on the first library update

• Library v2 uses the new event architecture and supports both creation and update signals for immediate repository creation

• Both library types support automatic git export on updates once configured