ISB-CGC UI prototyping
This project uses Google App Engine, Python 2.7, Django 1.7.1, and MySQL 5.6
This app is set up to run and deploy on various Google Cloud Projects.
The system uses Vagrant to setup a consistent, platform independent development environment. To setup your development environment to run locally, you will need to install the following:
- Vagrant
- Oracle VirtualBox
If you are on Windows 8 or above, you will need to make sure you have version 5.0.9 or above to support the network interface. This may involve downloading a test build - PyCharm Pro (Recommended)
From there simply perform these steps.
- Copy the
sample.env
file to a file named.env
in the root directory - Fill out the
.env
file with the proper values
- For most development environments,
MYSQL_ROOT_PASSWORD
andDATABASE_PASSWORD
can be the same, andDATABASE_USER
can beroot
GCLOUD_PROJECT_ID
is available after creating a project in the Google Cloud DashboardGOOGLE_CLIENT_ID
andGOOGLE_CLIENT_SECRET
can also be obtained in the Google Cloud Dashboard by going to API & Auth > Credentials > Add New > OAuth 2.0 Client > Web Application- Be sure when developing locally that you have 127.0.0.1 in the list of allowed domains for the OAuth 2.0 key
PyCharm Pro can be used to run your server through Vagrant and the Google App Engine.
- Go to your PyCharm Settings (On Mac, Go to Preferences;
CMD+,
) - Select Project: ISB-CGC-Webapp > Project Interpreter
- Click the icon next to the Project Interpreter drop down at the top of the main area
- Click Add Remote
- Select Vagrant (if it asks to start the machine, say yes)
- Set the Python interpreter path to
/home/vagrant/www/shell/python-su.sh
and click Ok - Select Languages & Frameworks > Google App Engine
- Change the SDK directory to
/home/vagrant/google_appengine/
- Click Ok to save
- Go to Run > Edit Configurations
- If there is not an App Engine server Configuration, add one
- Set the host to
0.0.0.0
- Set Additional Options to
--skip_sdk_update_check --use_mtime_file_watcher=True --admin_host 0.0.0.0 /home/vagrant/www
- Optionally set PyCharm to run a browser at url
http://127.0.0.1:8080/
- Set the Python Interpreter to the Vagrant Machine (if it is not set to that already)
- Set the working directory to
\home\vagrant\www
- Click ok to save
- Update app.yaml at root from "runtime:custom" to 'runtime: python27' this is due to a google bug identified by CGC
You will also need to set the shell/python-su.sh file to be executable. You can do this in the vagrant machines command line with the command chmod +x /home/vagrant/www/shell/python-su.sh
To run your server in PyCharm:
- Make sure your Vagrant machine is running by going to Tools > Vagrant > Up
- Click on the Run or Debug icons in the toolbar
- Click Run or Debug button on the configuration dialog
- Click Continue Anyway to run the machine
Your server will start and the PyCharm console should show all the logs and output from the system. If you are running in debug, you can also use breakpoints to stop the execution and examine variables and code as it runs.
To add Python Libraries or Dependencies, you should add them to the requirements.txt file and they will automatically be pulled down when a new developer starts the system.
To update your existing python dependencies because of a change or to pull down additional libraries you need, SSH into the virtual machine and run pip install
. Through PyCharm, you can take the following steps.
- Click Tools > Start SSH session...
- Select the Vagrant VM Connection you set up
- Type
cd www; pip install -r requirements.txt --upgrade -t lib/
Or from the command line, you can do this by doing the following
- Open a terminal in the project directory
- Type
vagrant ssh
to login to the virtual machine - Change directory to the
www
directory (/home/vagrant/www/
is the full path) - Run
pip install -r requirements.txt --upgrade -t lib/