Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
36 changes: 28 additions & 8 deletions learn/on-premise/extensions/mb-install.md
Original file line number Diff line number Diff line change
Expand Up @@ -23,18 +23,21 @@ kubectl version
- Downnload helm package from the given link shared by WaveMaker support team.

```bash
helm command //TODO
cat <Service-Account-File> | helm registry login -u _json_key_base64 --password-stdin https://us-east4-docker.pkg.dev
```
```bash
helm pull oci://us-east4-docker.pkg.dev/api-mock-server-332212/mockingbird/helm-charts/api-mock-server --version [MOCKINGBIRD-VERSION]
```


### Check sha1sum

- Verify SHA1SUM of downloaded file with the SHA1SUM given by WaveMaker support

```bash
sha1sum command //TODO
sha1sum api-mock-server-[MOCKINGBIRD-VERSION].tgz
```


### Namespace creation

- Create a new namespace
Expand All @@ -48,27 +51,44 @@ kubectl create ns mockingbird
- Login to docker with JSON Key provided by WaveMaker support

```bash
//TODO command
cat <Service-Account> | docker login -u _json_key_base64 --password-stdin https://us-east4-docker.pkg.dev
```

### Create K8s secrets

- Create image pull secrets after replacing Directory-Path-to-CONFIG-JSON path //TODO
- Create image pull secrets after replacing Directory-Path-to-CONFIG-JSON path, by default path is $HOME/.docker/config.json

```bash Command
kubectl create secret generic mb-image-pull-secret --from-file=.dockerconfigjson=[Directory-Path-to-CONFIG-JSON]/config.json --type=kubernetes.io/dockerconfigjson -n mockingbird
```

- Create SSL cert secret with CERT_PRIVATE_KEY_FILE and CERT_FILE replaced with path values.

```bash
kubectl create secret tls mb-ssl-secret --key ${CERT_PRIVATE_KEY_FILE} --cert ${CERT_FILE}
kubectl create secret tls mb-ssl-secret --key ${CERT_PRIVATE_KEY_FILE} --cert ${CERT_FILE} -n mockingbird
```

### Create one time setup values yaml

- Create values yaml file with this code snippet and replace the MOCKINGBIRD-DOMAIN and MOCKINGBIRD-STATIC-IP

one-time-setup-values.yaml

```yaml
global:
domainName: [MOCKINGBIRD-DOMAIN]
apimock-ingress-nginx:
controller:
service:
loadBalancerIP: [MOCKINGBIRD-STATIC-IP]
```

#### Install Helm Chart

- Run helm command to install chart for MockingBird Platform by replacing HELM-PACKAGE and MOCKINGBIRD-DOMAIN
- Run helm command to install chart for MockingBird Platform by replacing HELM-PACKAGE

```bash
helm install mockingbird [HELM-PACKAGE] -n mockingbird --set "global.domainName=[MOCKINGBIRD-DOMAIN]" --set "apimock-ingress-nginx.controller.service.loadBalancerIP=[MOCKINGBIRD-STATIC-IP]"
helm install mockingbird [HELM-PACKAGE] -n mockingbird -f one-time-setup-values.yaml
```

### Map domain to Static IP reserved for MockingBird
Expand Down
2 changes: 1 addition & 1 deletion learn/on-premise/extensions/mb-integrate.md
Original file line number Diff line number Diff line change
Expand Up @@ -13,5 +13,5 @@ Integrate Mockingbird with WME Platform
- Example ["1.2.3.4/32", "1.2.3.5/24"]

```bash
apimock-ingress-nginx.controller.service.loadBalancerSourceRanges: [WHITELIST-IP-RANGE] --reuse-values
helm upgrade mockingbird [HELM-PACKAGE] -n mockingbird --set apimock-ingress-nginx.controller.service.loadBalancerSourceRanges: [WHITELIST-IP-RANGE]
```
202 changes: 100 additions & 102 deletions learn/on-premise/extensions/mb-persistentvolumes.md
Original file line number Diff line number Diff line change
Expand Up @@ -35,17 +35,16 @@ Make sure these storage disks are at same region as K8s cluster.

storageclass.yaml

```bash
apiVersion: storage.k8s.io/v1
kind: StorageClass
metadata:
name: mockingbird-sc
parameters:
type: pd-standard
provisioner: kubernetes.io/gce-pd
allowVolumeExpansion: true
reclaimPolicy: Retain
volumeBindingMode: WaitForFirstConsumer
```yaml
apiVersion: storage.k8s.io/v1
kind: StorageClass
metadata:
name: mockingbird-sc
parameters:
type: pd-standard
provisioner: kubernetes.io/gce-pd
allowVolumeExpansion: true
reclaimPolicy: Retain
```

- Create StorageClass with this command
Expand All @@ -60,97 +59,96 @@ kubectl apply -f storageclass.yaml -n mockingbird

servicestorage.yaml

```bash
apiVersion: v1
kind: PersistentVolume
metadata:
name: pv-k8s-mbe-redis-data
spec:
storageClassName: "mockingbird-sc"
capacity:
storage: 50Gi
accessModes:
- ReadWriteOnce
claimRef:
namespace: mockingbird
name: pv-claim-k8s-mbe-redis-data
gcePersistentDisk:
pdName: k8s-mbe-redis-data
---
apiVersion: v1
kind: PersistentVolumeClaim
metadata:
name: pv-claim-k8s-mbe-redis-data
namespace: mockingbird
spec:
storageClassName: "mockingbird-sc"
accessModes:
- ReadWriteOnce
resources:
requests:
storage: 50Gi
---

apiVersion: v1
kind: PersistentVolume
metadata:
name: pv-k8s-mbe-swagger-json-data
spec:
storageClassName: "mockingbird-sc"
capacity:
storage: 50Gi
accessModes:
- ReadWriteOnce
claimRef:
namespace: mockingbird
name: pv-claim-k8s-mbe-swagger-json-data
gcePersistentDisk:
pdName: k8s-mbe-swagger-json-data
---

apiVersion: v1
kind: PersistentVolumeClaim
metadata:
name: pv-claim-k8s-mbe-swagger-json-data
namespace: mockingbird
spec:
storageClassName: "mockingbird-sc"
accessModes:
- ReadWriteOnce
resources:
requests:
storage: 50Gi
---

apiVersion: v1
kind: PersistentVolume
metadata:
name: pv-k8s-mbe-tomcat-logs-data
spec:
storageClassName: "mockingbird-sc"
capacity:
storage: 50Gi
accessModes:
- ReadWriteOnce
claimRef:
namespace: mockingbird
name: pv-claim-k8s-mbe-tomcat-logs-data
gcePersistentDisk:
pdName: k8s-mbe-tomcat-logs-data
---

apiVersion: v1
kind: PersistentVolumeClaim
metadata:
name: pv-claim-k8s-mbe-tomcat-logs-data
namespace: mockingbird
spec:
storageClassName: "mockingbird-sc"
accessModes:
- ReadWriteOnce
resources:
requests:
storage: 50Gi
```yaml
apiVersion: v1
kind: PersistentVolume
metadata:
name: pv-k8s-mbe-redis-data
spec:
storageClassName: "mockingbird-sc"
capacity:
storage: 50Gi
accessModes:
- ReadWriteOnce
claimRef:
namespace: mockingbird
name: pv-claim-k8s-mbe-redis-data
gcePersistentDisk:
pdName: k8s-mbe-redis-data
---
apiVersion: v1
kind: PersistentVolumeClaim
metadata:
name: pv-claim-k8s-mbe-redis-data
namespace: mockingbird
spec:
storageClassName: "mockingbird-sc"
accessModes:
- ReadWriteOnce
resources:
requests:
storage: 50Gi
---
apiVersion: v1
kind: PersistentVolume
metadata:
name: pv-k8s-mbe-swagger-json-data
spec:
storageClassName: "mockingbird-sc"
capacity:
storage: 50Gi
accessModes:
- ReadWriteOnce
claimRef:
namespace: mockingbird
name: pv-claim-k8s-mbe-swagger-json-data
gcePersistentDisk:
pdName: k8s-mbe-swagger-json-data
---

apiVersion: v1
kind: PersistentVolumeClaim
metadata:
name: pv-claim-k8s-mbe-swagger-json-data
namespace: mockingbird
spec:
storageClassName: "mockingbird-sc"
accessModes:
- ReadWriteOnce
resources:
requests:
storage: 50Gi
---

apiVersion: v1
kind: PersistentVolume
metadata:
name: pv-k8s-mbe-tomcat-logs-data
spec:
storageClassName: "mockingbird-sc"
capacity:
storage: 50Gi
accessModes:
- ReadWriteOnce
claimRef:
namespace: mockingbird
name: pv-claim-k8s-mbe-tomcat-logs-data
gcePersistentDisk:
pdName: k8s-mbe-tomcat-logs-data
---

apiVersion: v1
kind: PersistentVolumeClaim
metadata:
name: pv-claim-k8s-mbe-tomcat-logs-data
namespace: mockingbird
spec:
storageClassName: "mockingbird-sc"
accessModes:
- ReadWriteOnce
resources:
requests:
storage: 50Gi
```

- Create PV's and PVC's with this command
Expand Down
4 changes: 2 additions & 2 deletions learn/on-premise/extensions/mb-upgrade.md
Original file line number Diff line number Diff line change
Expand Up @@ -13,13 +13,13 @@ sidebar_label: "Integrate MockingBird Platform with WME"
- Replace [HELM-PATCH-PACKAGE] with the helm package name of new release or patch release after download

```bash
helm upgrade mockingbird [HELM-PATCH-PACKAGE] -n mockingbird --reuse-values"
helm upgrade mockingbird [HELM-PATCH-PACKAGE] -n mockingbird -f one-time-setup-values.yaml
```

### RoleBack MockingBird setup

- Here is the command to rollback previously installed patch/upgrade

```bash
helm rollback mockingbird [HELM-PATCH-PACKAGE] -n mockingbird --reuse-values //TODO verify rollback command
helm rollback mockingbird -n mockingbird
```