From c631625e575543ad9e1d4e51e01e7ab738dbc50b Mon Sep 17 00:00:00 2001
From: Corrie Sloot <corrie.sloot@ciceronetech.com>
Date: Mon, 23 Aug 2021 14:53:54 -0400
Subject: [PATCH 1/2] add minikube c2d install instructions

---
 content/tutorials/compute-to-data-minikube.md | 155 ++++++++++++++++++
 content/tutorials/compute-to-data.md          |  17 +-
 data/sidebars/tutorials.yml                   |   2 +
 3 files changed, 160 insertions(+), 14 deletions(-)
 create mode 100644 content/tutorials/compute-to-data-minikube.md

diff --git a/content/tutorials/compute-to-data-minikube.md b/content/tutorials/compute-to-data-minikube.md
new file mode 100644
index 000000000..24f727c46
--- /dev/null
+++ b/content/tutorials/compute-to-data-minikube.md
@@ -0,0 +1,155 @@
+---
+title: Minikube Compute-to-Data Environment
+description: 
+---
+
+## Requirements
+
+- functioning internet-accessable provider service
+- machine capable of running compute (e.g. we used a machine with 8 CPUs, 16 GB Ram, 100GB SSD and fast internet connection)
+- Ubuntu 20.04
+
+## Install Docker and Git
+
+```bash
+sudo apt update
+sudo apt install git docker.io
+sudo usermod -aG docker $USER && newgrp docker
+```
+
+## Install Minikube
+
+```bash
+wget -q --show-progress https://github.com/kubernetes/minikube/releases/download/v1.22.0/minikube_1.22.0-0_amd64.deb
+sudo dpkg -i minikube_1.22.0-0_amd64.deb
+```
+
+## Download and Configure Operator Service
+
+```bash
+git clone https://github.com/oceanprotocol/operator-service.git
+```
+
+Edit `operator-service/kubernetes/postgres-configmap.yaml`. Change `POSTGRES_PASSWORD` to nice long random password.
+
+Edit `operator-service/kubernetes/deployment.yaml`. Optionally change:
+- `ALGO_POD_TIMEOUT`
+- add `requests_cpu`
+- add `requests_memory`
+- add `limits_cpu`
+- add `limits_memory`
+
+```yaml
+...
+    spec:
+      containers:
+      - env:
+        - name: requests_cpu
+          value: "4"
+        - name: requests_memory
+          value: "8Gi"
+        - name: limits_cpu
+          value: "8"
+        - name: limits_memory
+          value: "15Gi"
+        - name: ALGO_POD_TIMEOUT
+          value: "3600"
+...
+```
+
+## Download and Configure Operator Engine
+
+```bash
+git clone https://github.com/oceanprotocol/operator-engine.git
+```
+
+Check the [README](https://github.com/oceanprotocol/operator-engine#customize-your-operator-engine-deployment) section of operator engine to customize your deployment.
+
+At a minimum you should add your IPFS URLs or AWS settings, and add (or remove) notification URLs.
+
+## Install kubectl
+
+```bash
+curl -LO "https://dl.k8s.io/release/$(curl -L -s https://dl.k8s.io/release/stable.txt)/bin/linux/amd64/kubectl"
+curl -LO "https://dl.k8s.io/$(curl -L -s https://dl.k8s.io/release/stable.txt)/bin/linux/amd64/kubectl.sha256"
+echo "$(<kubectl.sha256) kubectl" | sha256sum --check
+
+sudo install -o root -g root -m 0755 kubectl /usr/local/bin/kubectl
+```
+
+## Start Minikube
+
+First command is imporant, and solves a [PersistentVolumeClaims problem](https://github.com/kubernetes/minikube/issues/7828). 
+
+```bash
+minikube config set kubernetes-version v1.16.0
+minikube start --cni=calico --driver=docker --container-runtime=docker
+```
+
+Wait untill all the defaults are running (1/1).
+
+```bash
+watch kubectl get pods --all-namespaces
+```
+
+## Create namespaces
+
+```bash
+kubectl create ns ocean-operator
+kubectl create ns ocean-compute
+```
+
+## Deploy Operator Service
+
+```bash
+kubectl config set-context --current --namespace ocean-operator
+kubectl create -f operator-service/kubernetes/postgres-configmap.yaml
+kubectl create -f operator-service/kubernetes/postgres-storage.yaml
+kubectl create -f operator-service/kubernetes/postgres-deployment.yaml
+kubectl create -f operator-service/kubernetes/postgresql-service.yaml
+kubectl apply  -f operator-service/kubernetes/deployment.yaml
+```
+
+## Deploy Operator Engine
+
+```bash
+kubectl config set-context --current --namespace ocean-compute
+kubectl apply  -f operator-engine/kubernetes/sa.yml
+kubectl apply  -f operator-engine/kubernetes/binding.yml
+kubectl apply  -f operator-engine/kubernetes/operator.yml
+kubectl create -f operator-service/kubernetes/postgres-configmap.yaml
+```
+
+## Expose Operator Service
+
+```bash
+kubectl expose deployment operator-api --namespace=ocean-operator --port=8050
+```
+
+Run a port forward or create your ingress service and setup DNS and certificates (not covered here):
+
+```bash
+kubectl -n ocean-operator port-forward svc/operator-api 8050
+```
+
+Alternatively you could use another method to communicate between the C2D Environment and the provider, such as an SSH tunnel.
+
+## Initialize database
+
+If your minikube is running on compute.example.com:
+
+```bash
+curl -X POST "https://compute.example.com/api/v1/operator/pgsqlinit" -H  "accept: application/json"
+```
+
+## Update Provider
+
+Update your provider service by updating the `operator_service.url` value in `config.ini`
+
+```ini
+operator_service.url = https://compute.example.com/
+```
+
+Restart your provider service.
+
+[See example video](https://vimeo.com/580934725)
diff --git a/content/tutorials/compute-to-data.md b/content/tutorials/compute-to-data.md
index 0b6601770..06db06fe7 100644
--- a/content/tutorials/compute-to-data.md
+++ b/content/tutorials/compute-to-data.md
@@ -17,7 +17,7 @@ ocean/
 Then you need the following parts:
 
 - working [Barge](https://github.com/oceanprotocol/barge). For this setup, we will asume the Barge is installed in /ocean/barge/
-- a working Kubernetes (K8s) cluster (Minikube is a good start)
+- a working Kubernetes (K8s) cluster ([Minikube](../compute-to-data-minikube/) is a good start)
 - a working `kubectl` connected to the K8s cluster
 - one folder (/ocean/operator-service/), in which we will download the following:
   - [postgres-configmap.yaml](https://raw.githubusercontent.com/oceanprotocol/operator-service/main/kubernetes/postgres-configmap.yaml)
@@ -45,9 +45,9 @@ Check the [README](https://github.com/oceanprotocol/operator-engine#customize-yo
 
 ## Storage class
 
-For minikube, you can use 'standard' class.
+For minikube, you can use the default 'standard' class.
 
-For AWS , please make sure that your class allocates volumes in the same region and zone in which you are running your pods.
+For AWS, please make sure that your class allocates volumes in the same region and zone in which you are running your pods.
 
 We created our own 'standard' class in AWS:
 
@@ -71,17 +71,6 @@ reclaimPolicy: Delete
 volumeBindingMode: Immediate
 ```
 
-Or we can use this for minikube:
-
-```yaml
-apiVersion: storage.k8s.io/v1
-kind: StorageClass
-metadata:
-  name: standard
-provisioner: docker.io/hostpath
-reclaimPolicy: Retain
-```
-
 For more information, please visit https://kubernetes.io/docs/concepts/storage/storage-classes/
 
 ## Create namespaces
diff --git a/data/sidebars/tutorials.yml b/data/sidebars/tutorials.yml
index 7d430ee71..71dcd00e6 100644
--- a/data/sidebars/tutorials.yml
+++ b/data/sidebars/tutorials.yml
@@ -41,6 +41,8 @@
       link: /tutorials/compute-to-data-algorithms/
     - title: Run a Compute-to-Data Environment
       link: /tutorials/compute-to-data/
+    - title: Minikube Compute-to-Data Environment
+      link: /tutorials/compute-to-data-minikube/
 
 - group: Storage Setup
   items:

From 81cb3f9585c60db02daff9170190e79aaaf00d9a Mon Sep 17 00:00:00 2001
From: Corrie Sloot <corrie.sloot@ciceronetech.com>
Date: Mon, 23 Aug 2021 16:18:46 -0400
Subject: [PATCH 2/2] add minikube c2d install instructions

---
 content/tutorials/compute-to-data-minikube.md | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/content/tutorials/compute-to-data-minikube.md b/content/tutorials/compute-to-data-minikube.md
index 24f727c46..e5fc74453 100644
--- a/content/tutorials/compute-to-data-minikube.md
+++ b/content/tutorials/compute-to-data-minikube.md
@@ -33,6 +33,7 @@ git clone https://github.com/oceanprotocol/operator-service.git
 Edit `operator-service/kubernetes/postgres-configmap.yaml`. Change `POSTGRES_PASSWORD` to nice long random password.
 
 Edit `operator-service/kubernetes/deployment.yaml`. Optionally change:
+
 - `ALGO_POD_TIMEOUT`
 - add `requests_cpu`
 - add `requests_memory`
@@ -152,4 +153,4 @@ operator_service.url = https://compute.example.com/
 
 Restart your provider service.
 
-[See example video](https://vimeo.com/580934725)
+[Watch the explanatory video for more details](https://vimeo.com/580934725)