cms-tdr-diff

A service to highlight changes between CMS paper/note versions.

Setup

Local development

In order to access the GitLab API, we need two tokens, one for talking to the API (called GITLAB_TOKEN), and another to trigger the pipelines (referred to as TRIGGER_TOKEN). You can create them as environment variables or add a new file services/server/.env:

GITLAB_TOKEN='my_api_token'
TRIGGER_TOKEN='my_trigger_token'

Then start the server:

cd services/server
python example.py

Now you can point your browser to http://0.0.0.0:8000 to see the JSON response.

cd services/client
npm run dev

The application should then be running at http://localhost:3000.

Running with docker-compose

We need to forward the secrets to docker. Doing this via creating secrets does not work in bare compose, so we need to write our secrets into files (the secrets directory is ignored by git):

mkdir secrets
echo ${GITLAB_TOKEN} > secrets/GITLAB_TOKEN
echo ${TRIGGER_TOKEN} > secrets/TRIGGER_TOKEN

And then start the containers:

docker-compose up -d --build

The frontend will be available at http://localhost:8080 and the backend at http://localhost:8000. To stop the service, run docker-compose down.

Running on minikube

brew install kubectl
brew install docker-machine-driver-hyperkit
sudo chown root:wheel /usr/local/opt/docker-machine-driver-hyperkit/bin/docker-machine-driver-hyperkit
sudo chmod u+s /usr/local/opt/docker-machine-driver-hyperkit/bin/docker-machine-driver-hyperkit
brew cask install minikube
minikube start --vm-driver=hyperkit
minikube dashboard

docker build -t clelange/starlette-nuxt-kubernetes-client ./services/client
docker build -t clelange/starlette-nuxt-kubernetes-server ./services/server

minikube addons enable ingress

https://alligator.io/vuejs/working-with-environment-variables/

Running on kubernetes

Connect a Front End to a Back End Using a Service

Backend

For now, need a token created at https://gitlab.cern.ch/clange/tdr-diff/-/settings/ci_cd#js-pipeline-triggers.