From be253944ceab266366d949d04961396eae683d81 Mon Sep 17 00:00:00 2001
From: Corrie Sloot <35015915+corrie-sloot@users.noreply.github.com>
Date: Wed, 1 Sep 2021 14:18:30 -0400
Subject: [PATCH] mPowered round7 (#736)

* add minikube c2d install instructions

* add minikube c2d install instructions

Co-authored-by: Corrie Sloot <corrie.sloot@ciceronetech.com>
---
 content/tutorials/compute-to-data-minikube.md | 156 ++++++++++++++++++
 content/tutorials/compute-to-data.md          |  17 +-
 data/sidebars/tutorials.yml                   |   2 +
 3 files changed, 161 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 00000000..e5fc7445
--- /dev/null
+++ b/content/tutorials/compute-to-data-minikube.md
@@ -0,0 +1,156 @@
+---
+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.
+
+[Watch the explanatory video for more details](https://vimeo.com/580934725)
diff --git a/content/tutorials/compute-to-data.md b/content/tutorials/compute-to-data.md
index 0b660177..06db06fe 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 7d430ee7..71dcd00e 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: