Skip to main content
Join the official 2020 Python Developers SurveyStart the survey!

Management of QHub on Cloud Infrastructure

Project description


Is a tool for initializing and maintaining the state of QHub deployments on Digital Ocean, Amazon Web Services, and Google Cloud Platform.


pip install qhub


QHub is entirely controlled from a configuration file.

To generate a configuration file follow these instructions.

mkdir <repository-name>
cd <repository-name>
qhub init <platform-name> # platform-name can be do, aws or gcp.

This generates a configuration file. Now modify the configuration according to your needs. Documentation on modify a configuration file is detailed here.

Initializing the Provider Template

The exact naming of the configuration file is needed to trigger the CI actions when the configuration is changed.

qhub render -c qhub-config.yaml -o ./ --force

After initialising the provider templates, follow the instructions in docs on deploying the infrastructure at <repository-name>/docs/ At this current moment some bootstrapping is required before github-actions can manage the infrastructure as code. All of these instructions are automated in scripts/ Note that you will need to set the environment variables in for this script to succeed. You will be prompted several times for use actions such as setting oauth provider and dns.


Terraform Module Dependencies

This project depends on the terraform modules repository:


The architecture diagrams for each cloud provider is in architecture folder. To generate them, just run the following command:

python <diagram_file>.py


QHub is BSD3 licensed


Creating a release:

  1. Increment the version number in qhub/VERSION
  2. Ensure that the version number in qhub/VERSION is used in pinning qhub in the github actions qhub/template/{{ cookiecutter.repo_directory }}/.github/workflows/qhub-config.yaml

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for qhub, version 0.1.19
Filename, size File type Python version Upload date Hashes
Filename, size qhub-0.1.19.tar.gz (29.6 kB) File type Source Python version None Upload date Hashes View

Supported by

Pingdom Pingdom Monitoring Google Google Object Storage and Download Analytics Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page