Deployment: Docker Compose on DigitalOcean Droplet
This wiki entry describes a deployment process to a DigitalOcean droplet using Python 3.5.
Log into DigitalOcean and create or use an existing droplet running Ubuntu 16.04.
Make sure you:
- Use an SSH key
- Give the droplet a descriptive name
SSH into the droplet:
ssh root@<ip>
You will be asked to update the root password.
It is recommended to create a user with restricted permissions. (For now, please refer to this guide.)
Install Node.js:
cd ~
curl -sL https://deb.nodesource.com/setup_8.x -o nodesource_setup.sh
bash nodesource_setup.sh
apt-get install nodejs
nodejs -v
npm -v
apt-get install build-essential
rm nodesource_setup.sh
Install Docker:
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo apt-key add -
add-apt-repository "deb [arch=amd64] https://download.docker.com/linux/ubuntu $(lsb_release -cs) stable"
apt-get update
apt-cache policy docker-ce
apt-get install -y docker-ce
systemctl status docker
Install Docker Compose:
curl -L https://github.com/docker/compose/releases/download/1.18.0/docker-compose-`uname -s`-`uname -m` -o /usr/local/bin/docker-compose
chmod +x /usr/local/bin/docker-compose
docker-compose --version
Clone the GitHub repository in the home folder:
cd /home && git clone https://github.com/polyledger/polyledger.git
You will be prompted for a GitHub username and password/access token.
Install the web client dependencies and create a production build:
cd /home/polyledger/web_client
NPM_TOKEN=<NPM_TOKEN> npm install
npm run build
Create a environment variable file:
touch /home/polyledger/.env.production
nano /home/polyledger/.env.production
To generate a secret key, run this command in any shell:
python -c "import string, random; uni=string.ascii_letters+string.digits+string.punctuation; print(repr(''.join([random.SystemRandom().choice(uni) for i in range(random.randint(45,50))])))"
Now save these variables:
DJANGO_SETTINGS_MODULE=polyledger.settings.production
PYTHON_ENV=production
SECRET_KEY=<SECRET_KEY>
EMAIL_HOST_PASSWORD=<EMAIL_HOST_PASSWORD>
NPM_TOKEN=<NPM_TOKEN>
BITBUTTER_API_KEY=<BITBUTTER_API_KEY>
BITBUTTER_API_SECRET=<BITBUTTER_API_SECRET>
BITBUTTER_BASE_URI=<BITBUTTER_BASE_URI>
BITBUTTER_PARTNERSHIP_ID=<BITBUTTER_PARTNERSHIP_ID>
BITBUTTER_PARTNER_ID=<BITBUTTER_PARTNER_ID>
Build the Docker images and start the services:
docker-compose -f production.yml build
docker-compose -f production.yml up
First we need to copy the container ID of the polyledger_server image:
docker ps
Now run the createsuperuser command in the polyledger_server container:
docker exec -it <CONTAINER_ID> python manage.py createsuperuser
You will be prompted to create an admin user.
Email address: [email protected]
First name: Satoshi
Last name: Nakamoto
Password:
Password (again):
Superuser created successfully.
Navigate to http://<SERVER_IP>/admin/login/ in your browser and login with the credentials you just created.
Currently you have to add coins with their symbol and name to fetch prices for them. This will be simplified in the future.
Once you have added some coins, move onto the next step.
The easiest way would be to stop Docker Compose with CTRL + C and then restart:
docker-compose -f production.yml up
Log into CloudFlare and create a DNS A record for the server's IP using the "portfolio" subdomain. This enables DNS routing and enables HTTPS.
Before anyone can sign up on the app, their email has be to whitelisted in the admin interface. Make sure you add the email to the whitelist before signing up or you will receive a "Forbidden" error.
Make sure you add the site domain in the admin interface so Django knows the domain.
Now you can start testing the portfolio app. Log out of the admin interface and navigate to https://portfolio.polyledger.com/signup in your browser.