Running Open edX in production with Docker
France Université Numérique
Open edX Conference — Montréal, Canada — May 2018
Outline
- Introduction - 20 minutes
- Coding Dojo - 60 minutes
- Conclusion - 10 minutes
Introduction
📦
Container-native developmentDevelop, build, test & deploy on the same container
Push ready-to-run Docker images to a registryinstead of
pushing code to a code repository
🤓
containerizing applications meansdevelopers take responsibility
🍻
inviting edx-configuration and devstack inside edx-platform
Meet Arnold
- Packaged as a Docker image
- Ansible with openshift_raw
- OC (OpenShift CLI client)
🐳 Docker images
| github.com/openfun/fun-platform | Native Docker image of edxapp |
| github.com/openfun/openshift-docker | Docker images adapted to OpenShift for related services (nginx, elasticsearch, etc.) |
| github.com/openfun/richie | Native Docker image of Richie, a CMS for Open edX based on DjangoCMS |
Built on CircleCI and pushed to Docker Hub
🍱 Configuration management
- Multi-customer, multi-environment
- Built on Ansible
- Flexible defaults / overrides
- Make extensive use of variable precedence
- Credentials are encrypted with Ansible vault and pushed to OpenShift secrets
🏭 Generate OpenShift objects
Using Jinja templates and Ansible playbook tasks:
- Routes
- Services (SVC)
- Deployment Configurations (DC)
- Endpoints (EP)
- Jobs (e.g. collectstatic, migrate,...)
- Volumes (PVC) 💾
- Configmaps 📁
- Secrets 🙈
Blue/Green deployments
🔒 SSL certificates
- SSL certificates with Let's Encrypt
- ACME protocol (Automated Certificate Management Environment)
- using https://github.com/tnozicka/openshift-acme
Environments
| Environment | Orchestrator | Databases | Routes |
| Development | Local MiniShift | Container |
https://development-example-lms.192.168.99.100.nip.io https://development-example-cms.192.168.99.100.nip.io |
| Feature | OpenShift dev | Container |
https://feature-example-lms--feature-description.dev.openfun.fr https://feature-example-cms--feature-description.dev.openfun.fr |
| Staging | OpenShift dev | Cluster dev |
https://staging-example-lms.dev.openfun.fr https://staging-example-cms.dev.openfun.fr |
| PreProduction | OpenShift dev | Cluster dev |
https://preproduction-example-lms.dev.openfun.fr https://preproduction-example-cms.dev.openfun.fr |
| Production | OpenShift prod | Cluster prod |
https://www.example.com https://studio.example.com |
Coding Dojo
- All skill levels are welcome
- Teams of 3 to 4 persons
- At least 1 person who knows Docker per team
- At least 1 person who knows Ansible per team
- Call us when you need help
git clone git@github.com:openfun/arnold.git
git checkout openedx-con
and follow the readme...
Conclusion
🚧 Todo list
- current routes and blue/green switch
- load SQL dump for development/feature envs
- refactor settings override mechanism
- github issues...
Thank you!
Get in touch:
Running Open edX in production with Docker
France Université Numérique
Open edX Conference
— Montréal, Canada
— May 2018