ol-openedx-git-auto-export 0.7.1

A plugin that auto saves the course OLX to git when an author publishes it

Installation

For detailed installation instructions, please refer to the plugin installation guide.

Installation required in:

• Studio (CMS)

Configuration

• Enable the following FEATURES flags in the config file in Open edX. For any release after Juniper, that config file is /edx/etc/cms.yml. If you’re using private.py, you will need to enable these FEATURES in cms/envs/private.py.

  "FEATURES": {
      "ENABLE_EXPORT_GIT": true,
      "ENABLE_AUTO_GITHUB_REPO_CREATION": true  # Optional, to auto create github repo for new courses
  }
  # Set when ENABLE_AUTO_GITHUB_REPO_CREATION is true
  GITHUB_ORG_API_URL = "https://api.github.com/orgs/<GITHUB_ORG_NAME>"  # For GitHub Enterprise, change the URL accordingly
  GITHUB_ACCESS_TOKEN = "<GITHUB_PERSONAL_ACCESS_TOKEN>"  # Token must have 'repo - Full control of private repositories' permission

• Set your commit user in cms/envs/common.py, if you don’t want to use the default one

  GIT_EXPORT_DEFAULT_IDENT = {
      'name': 'STUDIO_EXPORT_TO_GIT',
      'email': '[e-mail]'
  }

• Restart the server using make studio-restart on Devstack or tutor dev/local restart openedx on Tutor.

• For Tutor installations, these values can also be managed through a custom tutor plugin.

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/coursegitrepository/

• Add your course_id and in the GIT URL, add your OLX git repo. For example [e-mail]:<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.