README.md

Introduction

This is a flask application that leverages RabbitMQ and Celery to asynchronously create a Cheaha user account. Currently the project is being developed on an Openstack cluster.

Project Setup

To clone this repo use the command:

$ git clone https://gitlab.rc.uab.edu/mmoo97/flask_user_reg.git
$ cd flask_user_reg

Prerequisites

Setup a Virtual Environment

• Ensure you have created a virtual environment called venv setup running python3.
  • Note, this project requires a virtual environment running python3 (3.6.8 in this case).
    • Create this by navigating to you home directory via typing $ cd and entering the following commands:
      

    $ python3 -m venv ~/venv
    $ source ~/venv

    • Upon Activation, you should see the prompt update accordingly:

    [centos@ood ~]$              <------Old Prompt
    (venv) [centos@ood ~]$       <------New Prompt

    In this case, the env name is displayed as venv but would change to reflect whatever name you initialized it with in the previous step. Additionally, this example is running on the ood node provisioned via OpenStack.
• Ensure pip is installed.

  • Mac/Linux

    • Check if installed by typing $ pip
    • Install pip using $ python -m pip install --user --upgrade pip.

  • Windows

    • Check if installed using $ py
    • Install pip using $ py -m pip install --upgrade pip
      
      
• Ensure Flask and other dependencies are installed to you virtual environment using the following commands:

$ cd ~/your/repo/path/flask_user_reg
$ pip install -r requirements.txt

• Note, to install flask in your own $HOME use pip install --user Flask.