This is a cloud-init config file to create a local development environment using multipass. Copied from the one I've created for development on govuk, but stripped of govuk specific tooling.

Create a multipass instance:

./bin/create-multipass-instance

---

NHS Dev

bin/create-nhs-multipass-instance

# Get the IP of the new instance and add to /etc/hosts
# Be sure to remove any old entry in /etc/hosts
echo "$(multipass info nhs-dev | grep IPv4 | cut -c17-) nhs-dev" | sudo tee -a /etc/hosts

# Remove old entries from ~/.ssh/known_hosts
ssh-keygen -f '/home/chrisroos/.ssh/known_hosts' -R 'nhs-dev'

# Add the following to ~/.ssh/config
# The LocalForward config means that connecting to localhost:4000 will make requests to the Rails app in the multipass instance
Host nhs-dev
  ForwardAgent yes
  LocalForward 4000 localhost:4000

Setup Mavis

ssh nhs-dev

cd ~
git clone git@github.com:NHSDigital/manage-vaccinations-in-schools

cd ~/manage-vaccinations-in-schools
git checkout next

# Install dependencies
mise install

# Setup the app
bin/setup

Setup Mavis testing

ssh nhs-dev

cd ~
git clone git@github.com:NHSDigital/manage-vaccinations-in-schools-testing
cd ~/manage-vaccinations-in-schools-testing

# Install mise dependencies
mise install

# Install uv
curl -LsSf https://astral.sh/uv/install.sh | sh

# Update project environment
uv sync

# Configure .env
cp .env.generic .env
# Set http basic auth and password for qa.mavistesting.com

# Install playwright browsers with all required dependencies
uv run playwright install --with-deps

# Run smoke tests against qa
cd ~/manage-vaccinations-in-schools-testing
uv run pytest -m smoke

# Download and import gias data in mavis to run tests against local Rails app
cd ~/manage-vaccinations-in-schools
bin/mavis gias download
RAILS_ENV=end_to_end bin/mavis gias import

# Run smoke tests against local Rails app
cd ~/manage-vaccinations-in-schools
bin/e2e -m smoke