Montage

Quick start using Docker Compose

• Create a new API key and a new OAuth 2.0 client ID in the Credentials section of the Google Cloud APIs & Services. Make sure the client ID is restricted to http://localhost:8080.
• Enable APIs for YouTube, Google+, Maps.
• Create a settings file appengine/src/greenday_core/settings/local.py based on appengine/src/greenday_core/settings/local.py.sample and fill the API keys as per above.
• Create a settings file appengine/src/greenday_core/settings/test.py based on appengine/src/greenday_core/settings/test.py.sample and fill the API keys as per above.
• docker-compose build
• docker-compose up
• docker-compose exec montage grunt build
• Navigate to http://localhost:8080 for the app
• Navigate to http://localhost:8000 for the admin UI

Development using Docker Compose

docker-compose exec montage bash to get inside the running container. The Python virtual environment is automatically activated for you.

Backend

• python bin/manage.py shell and other Python / Django commands are available
• Editing the Python code from your code editor will automatically reflect in the running service
• npm run test:backend to run backend tests

Frontend

• grunt watch to watch code changes in JavaScript / HTML and rebuild the package
• npm run test:frontend to run unit tests

Deployment

Setting up DB access to QA and live databases

All connections to the Cloud SQL instances are made over SSL. You will need to set yourself up with a private key to access this.

1. Go to the project console and choose a database
2. Under "SSL" click "Create a client certificate"
3. Enter a name you can be identified by as the cert name
4. Download client-key.pem, client-cert.pem and ca-cert.pem (this is named server-ca when you download it from the console. You will need to rename it to ca-cert.pm when you store it locally) and save them in {project root}/keys/(qa|live)/.
5. Click "Restart and Close". This RESTARTS the SQL instance but is necessary for the certificate to be usable.
6. Test connection using ./bin/manage.py dbshell --settings=greenday_core.settings.(qa|live)

To QA

QA should mirror the develop branch. QA has a fixed version, called "qa".

1. Copy appengine/auth.json.example to appengine/auth.json
2. Run npm run full-deploy-qa

PS: At Meedan, a deployment to QA happens automatically when a push happens to develop. You can also call it from Jenkins (job montage-develop) or from Slack using Hubot: @hu deploy-montage-qa.

To Live

Live should mirror the master branch.

1. If the version needs changing then update file VERSION
2. Merge develop into master and push
3. Copy appengine/auth.json.example to appengine/auth.json
4. Run npm run full-deploy-live

PS: At Meedan, you can deploy from Jenkins (job montage-master) or from Slack using Hubot: @hu deploy-montage-live.