Arvados on Minikube

This page documents setting up and running the Arvados on Kubernetes Helm chart on Minikube.

Prerequisites

Install tooling

Install kubectl:

• Follow the instructions at https://kubernetes.io/docs/tasks/tools/install-kubectl/

Install helm:

• Follow the instructions at https://docs.helm.sh/using_helm/#installing-helm

Install Minikube

Follow the instructions at https://kubernetes.io/docs/setup/minikube/

Test the connection:

$ kubectl get nodes

Test helm by running

$ helm ls

There should be no errors. The command will return nothing.

Clone the repository

Clone the repository and nagivate to the arvados-k8s/charts/arvados directory:

$ git clone https://github.com/arvados/arvados-k8s.git
$ cd arvados-k8s/charts/arvados

Start the Arvados cluster

All Arvados services will be accessible on Minikube’s IP address. This will be a local IP address, you can see what it is by running

$ minikube ip
192.168.39.15

Generate self-signed SSL certificates for the Arvados services:

$ ./cert-gen.sh `minikube ip`

The values.yaml file contains a number of variables that can be modified. At a minimum, review and/or modify the values for

  adminUserEmail
  adminUserPassword
  superUserSecret
  anonymousUserSecret

Now start the Arvados cluster:

$ helm install arvados . --set externalIP=`minikube ip`

And update the Kubernetes services to have the Minikube IP as their ‘external’ IP:

$ ./minikube-external-ip.sh

At this point, you can use kubectl to see the Arvados cluster boot:

$ kubectl get pods
$ kubectl get svc

After a few minutes, you can access Arvados Workbench at the Minikube IP address:

• https://<MINIKUBE IP>

with the username and password specified in the values.yaml file.

Alternatively, use the Arvados cli tools or SDKs. First set the environment variables:

$ export ARVADOS_API_TOKEN=<superUserSecret from values.yaml>
$ export ARVADOS_API_HOST=<MINIKUBE IP>:444
$ export ARVADOS_API_HOST_INSECURE=true

Test access with:

$ arv user current

Reload

If you make changes to the Helm chart (e.g. to values.yaml), you can reload Arvados with

$ helm upgrade arvados .

Shut down

$ helm del arvados

---

Previous: Set up Docker