Global Names List Resolver User Interface

A web-based GUI for gn_list_resolver. The gn_list_resolver Ruby gem allows comparison of one scientfic names checklist to another.

Testing

• install docker
• install docker-compose
• run

docker-compose up
docker-compose run app rake

Development

We recommend to use docker-compose for development

To prepare the system (if you run it first time or there was an update in the code) go to the project's root and then

docker-compose down # if it is running

sudo chown -R `whoami` # for Linux only (Windows, Mac do it for you)

docker-compose build

Start it all:

docker-compose up

Point your browser to http://0.0.0.0:9292

For testing purposes you can use this csv file

To stop it run

docker-compose down

Testing deployment to production with minikube

Requirements:

Minikube and Kubectl >= v.1.6.0

Procedure

• Start minikube

minikube start
# to get inside
minikube ssh
# to see IP
minikube ip
# for this example lets assume the output to be 192.168.42.201

• Create namespace

kubectl create ns gn

• Create the project (from the project root)

kubectl create -f k8s/dev/
kubectl create -f k8s/pv-claims/
kubectl create -f k8s/

• Monitor the progress with

kubectl get -n gn pod

the output should look like

NAME                        READY     STATUS    RESTARTS   AGE
gnlist-2922274414-95zwd     0/1       Running   0          19s
gnlist-2922274414-npf2t     0/1       Running   0          19s
gnlist-2922274414-qpwsv     0/1       Running   0          19s
gnlist-db-503522788-113lt   1/1       Running   0          19s

to monitor the progress on a pod

kubectl logs -f -n gn gnlist-2922274414-95zwd

to get inside of a pod

kubectl exec -it -n gn gnlist-2922274414-95zwd bash

• To access the project via browser

When all pods are ready

NAME                        READY     STATUS    RESTARTS   AGE
gnlist-2922274414-95zwd     1/1       Running   0          3m
gnlist-2922274414-npf2t     1/1       Running   0          3m
gnlist-2922274414-qpwsv     1/1       Running   0          3m
gnlist-db-503522788-113lt   1/1       Running   0          3m

kubectl get -n gn services
# or
kubectl gen -n gn svc

NAME        CLUSTER-IP   EXTERNAL-IP   PORT(S)          AGE
gnlist      10.0.0.19    <nodes>       80:32741/TCP     5m
gnlist-db   10.0.0.109   <nodes>       5432:30586/TCP   5m

In this example the outside port that can be reached is 32741. If minikube ip returned 192.168.42.201 point your browser to http://192.168.42.201:32741

• To clean everything up

kubectl delete ns gn