microsoft / oxa-tools

Open edX on Azure Tools
MIT License
38 stars 99 forks source link

Deploying your Open edX on Azure

This repo contains guides and tools designed to help you deploy and manage a highly available and scalable Open edX on Azure. If you have Azure account you can deploy Open edX via the Azure portal using the guidelines below. Please note that while you can use an Azure free account to get started depending on which configuration you choose you will likely be required to upgrade to a paid account.

Fully configurable deployment

The number of configuration options might be overwhelming, so some pre-defined/restricted deployment options for typical Open edX scenarios follow this.

Predefined deployment options

Below are a list of pre-defined/restricted deployment options based on typical deployment scenarios (i.e. dev/test, production etc.)

Deployment Type Description Environment Preferred
Minimal Single machine instance Development and Test
High availability instance A production stack comprising of various Azure components Production

Deploying single machine instance (for development and test)

Server Requirements

The following server requirements will be fine for supporting hundreds of registered students on a single server.

Note: This will run MySQL, Memcache, Mongo, Nginx, and all of the Open edX services (LMS, Studio, Forums, ORA, etc) on a single server. In production configurations we recommend that these services run on different servers and that a load balancer be used for redundancy. Setting up production configurations is beyond the scope of this README.

Installation Instructions

Execute onebox.sh on any Ubuntu 16 machine.

Common parameter argument options: pick a cell from each column. The first row is what happens when no additional parameter arguments are provided.

--role or -r or
--stack or -s
--branches or -b credential parameter arguments --msft-oauth
fullstack (default) edge (default)
(oxa/dev.fic branches)
randomly generated (default) off (default)
devstack ginkgo
(edx repositories and
open-release/ginkgo.1 tag)
--default-password or -d
anyString
(set all passwords to anyString)
prod
(uses login.live)
  release
(oxa/release.fic branches)
   
  stable
(oxa/master.fic branches)
   
  ficus
(edx repositories and
open-release/ficus.1 tag)
   
  edit onebox.sh to specify custom
remote urls and branches directly
edit onebox.sh to specify custom
usernames and passwords directly
 

For example: sudo onebox.sh OR sudo bash onebox.sh -r devstack -b stable -d hokiePokiePass11 --msft-oauth prod

What's been tested: server edition on azure, desktop edition in virtualbox VM, docker containers with systemd. Please open an "issue" in Github if you encounter any problems.

Deploying high availability instance (for production-like environments)

The deployment of high availability has the architecture shown below. This architecture is designed to be a scalable and highly available Open edX solution.

laas_architecture

Figure 2: High Availability Architecture

Detailed guide of deploying high availability instance including deployment pre-requisites, installation steps and other configuration are mentioned in the Deployment Guide