Github Action to install and enable the Tutor plugin tutor-contrib-k8s-deploy-tasks. This plugin manages Kubernetes-specific deployment tasks that must be run from within tutor. For example, manage.py as well as manipulations to Open edX's python source files.
This action was originally created for Cookiecutter Tutor Open edX Production Devops Tools but it should also work with your own custom workflows.
name: Example workflow
on: workflow_dispatch
jobs:
build:
runs-on: ubuntu-latest
steps:
# required antecedent
- uses: actions/checkout
# required antecedent
- name: Configure AWS credentials
uses: aws-actions/configure-aws-credentials
with:
aws-access-key-id: ${{ secrets.THE_NAME_OF_YOUR_AWS_ACCESS_KEY_ID }}
aws-secret-access-key: ${{ secrets.THE_NAME_OF_YOUR_AWS_SECRET_ACCESS_KEY }}
aws-region: us-east-2
# install and configure tutor and kubectl
- name: Configure Github workflow environment
uses: openedx-actions/tutor-k8s-init@v1
#
# ... steps to deploy your Open edX instance to k8s ...
#
# This action.
# tutor-plugin-version is an optional input. default is 'latest'
# note that this plugin is installed from the Github repo. The version
# refers to the repo branch.
- name: Enable tutor plugin
uses: openedx-actions/tutor-plugin-enable-k8s-deploy-tasks@v1
with:
tutor-plugin-version: "15.0.0"
#
# ... more steps to deploy your Open edX instance to k8s ...
#Pull requests are welcome! Please note that this repository uses semantic release for automated processessing of commits and pull requests, and package publication for new releases. Please note the following about your commit message:
- pull requests can be approved and merged by any two authorized core committers
- only the 'next' branch can be merged to main. Thus, your Pull Request should be created from the 'next' branch
- we use Angular commit message format. See below
- use the imperative, present tense: "change" not "changed" nor "changes"
- don't capitalize the first letter
- no dot (.) at the end
| Branch | Description |
|---|---|
| main | commits are prohibited. Only accepts automated merges via Github Actions |
| next | this is the branch that I (Lawrence) primarly use for normal code maintenance |
| next-major | special use, in the unlikely event that we ever bump beyond version 1.x.x |
| beta | if you're working on something large then merge here before doing anything in 'next' |
| alph | if you're doing some really big then start here |
An example:
git commit -m "fix: fix bug in the yadda yadda step"Your commit message should be prefixed with one of the following:
| Prefix | Description |
|---|---|
| build | changes that affect the build system or external dependencies (example - scopes: gulp, broccoli, npm) |
| ci | changes to our CI configuration files and scripts (examples: Github Actions, CircleCi, SauceLabs) |
| docs | documentation only changes |
| feat | a new feature |
| fix | a bug fix |
| perf | a code change that improves performance |
| refactor | a code change that neither fixes a bug nor adds a feature |
| test | adding missing tests or correcting existing tests |
More generally, less is more: don't use two words where one will suffice. Simple words are better than fancy words.
