diff --git a/learn/on-premise/extensions/mb-install.md b/learn/on-premise/extensions/mb-install.md index 09f6f83c2..115fd6b44 100644 --- a/learn/on-premise/extensions/mb-install.md +++ b/learn/on-premise/extensions/mb-install.md @@ -23,18 +23,21 @@ kubectl version - Downnload helm package from the given link shared by WaveMaker support team. ```bash -helm command //TODO +cat | 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 @@ -48,27 +51,44 @@ kubectl create ns mockingbird - Login to docker with JSON Key provided by WaveMaker support ```bash -//TODO command +cat | 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 diff --git a/learn/on-premise/extensions/mb-integrate.md b/learn/on-premise/extensions/mb-integrate.md index 2cfee30bf..fbfdcad99 100644 --- a/learn/on-premise/extensions/mb-integrate.md +++ b/learn/on-premise/extensions/mb-integrate.md @@ -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] ``` diff --git a/learn/on-premise/extensions/mb-persistentvolumes.md b/learn/on-premise/extensions/mb-persistentvolumes.md index ff7db8f73..807c40494 100644 --- a/learn/on-premise/extensions/mb-persistentvolumes.md +++ b/learn/on-premise/extensions/mb-persistentvolumes.md @@ -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 @@ -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 diff --git a/learn/on-premise/extensions/mb-upgrade.md b/learn/on-premise/extensions/mb-upgrade.md index 67f8895f7..23544c890 100644 --- a/learn/on-premise/extensions/mb-upgrade.md +++ b/learn/on-premise/extensions/mb-upgrade.md @@ -13,7 +13,7 @@ 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 @@ -21,5 +21,5 @@ helm upgrade mockingbird [HELM-PATCH-PACKAGE] -n mockingbird --reuse-values" - 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 ```