Deployment

This page is a work in progress, as we are currently working on migrating to this new deployment method.

Set up a new VPS server instance and access it via SSH

Adds a command to make OS updates quicker and more consistent¶

sudo echo "alias doupdates='sudo apt update && sudo apt dist-upgrade && sudo apt autoremove && sudo apt autoclean'" >> /etc/profile;source /etc/profile

Run the new `doupdates` command¶

doupdates

Automatically `cd` to the E12 folder when you log in¶

echo "cd /var/epilepsy12/" >> /etc/profile;source /etc/profile

Add other SSH users using their public keys from GitHub¶

ssh-import-id gh:eatyourpeas
ssh-import-id gh:pacharanero

Install Docker¶

curl -fsSL get.docker.com | bash

Optional: Install Zsh and Oh-my-zsh

Install Zsh and Oh-my-zsh¶

Two tools I find quite nice when spending a lot of time in the terminal are Zsh and oh-my-zsh. These give you additional features in the terminal, such as better tab completion and a terminal prompt which includes the Git branch you are currently using.

Note that if you escalate your privileges to root using sudo su or similar then the new root shell will not have Zsh set up, so you may need to install Zsh/Oh-my-zsh for both your user and the root user.

Install Zsh

sudo apt install zsh

Install oh-my-zsh

sh -c "$(curl -fsSL https://raw.githubusercontent.com/ohmyzsh/ohmyzsh/master/tools/install.sh)"

Optional: Change the ZSH_THEME from the default to my preferred "bira"

sed -i '/ZSH_THEME="robbyrussell"/c\ZSH_THEME="bira"' ~/.zshrc

Optional: Add some useful plugins for Git, Docker etc

sed -i '/plugins=(git)/c\plugins=(git git-extras wd docker docker-compose)' ~/.zshrc

You can also edit ~/.zshrc to customise

nano ~/.zshrc

Clone the Epilepsy12 repository¶

This command clones the repo into the /var/epilepsy12 folder, which we have chosen as the standard location for the E12 application.

git clone https://github.com/rcpch/rcpch-audit-engine.git /var/epilepsy12

cd into the new folder

cd /var/epilepsy12/

git checkout the branch you want to deploy

developmentstaginglive

git checkout development

git checkout staging

git checkout live

Useful commands¶

Outputs all the environment variables from within Docker Compose to the console, this can be useful for debugging deployments.

docker compose config