PromucFlow_constructor/deploy/helm

Appsmith

Appsmith is a JS-based internal tool development platform. Internal tools take a lot of time to build even though they involve the same UI components, data integrations, and user access management. Developers love Appsmith because it saves them hundreds of hours.

Build interactive web apps by using UI components like a table, form components, button, charts, rich text editor, map, tabs, modal, and many more.

API Support: CURL importer for REST APIs Database Support: PostgreSQL, MongoDB, MySQL, Redshift, Elastic Search, DynamoDB, Redis, & MSFT SQL Server.

TL;DR

---

helm repo add appsmith https://appsmithorg.github.io/appsmith

helm repo update

helm install appsmith/appsmith --generate-name

Introduction

---

This chart bootstrap an Appsmith deployment on a Kubernetes cluster using Helm package manager.

Prerequisites

---

• Install Helm package manager: https://helm.sh/docs/intro/install/
• Ensure kubectl is installed and configured to connect to your cluster

  • Install kubeclt: kubernetes.io/vi/docs/tasks/tools/install-kubectl/

  • Minikube: Setup Kubectl

  • Google Cloud Kubernetes: Configuring cluster access for kubectl

  • Aws EKS: Create a kubeconfig for Amazon EKS

  • Microk8s: Working with kubectl

• Ensure you have a default storage class running on your cluster. Please follow one of below guideline to enable your default storage class in case of no existing one
  • Minikube: Enable addon default-storageclass
  • Google Cloud Kubernetes: Setting up default storage class on GKE
  • AWS EKS: Create default storage class
  • Microk8s: Enable storage
• Kubernetes NGINX Ingress Controller should be enable on your cluster by default. Please make sure that you install the right version for your cluster
  • Minikube: Set up Ingress on Minikube with the NGINX Ingress Controller
  • Google Cloud Kubernetes: Ingress with NGINX controller on Google Kubernetes Engine
  • AWS EKS: Install NGINX Controller for AWS EKS
  • Microk8s: Add on: Ingress

Installing the Chart

---

To install the chart with the release appsmith

helm install appsmith/appsmith --generate-name

The command deploys Appsmith application on Kubernetes cluster in the default configuration. The Parameters section lists the parameters that can be configured during installation.

Uninstalling the Chart

---

To uninstall the appsmith release:

helm list
NAME                       NAMESPACE       REVISION        UPDATED                                 STATUS          CHART           APP VERSION
appsmith-1631069261        default         1               2021-09-09 11:24:40.152766 +0700 +07    deployed        appsmith-1.3.0  1.16.0

helm uninstall appsmith-1631069261

The command uninstalls the release and removes all Kubernetes resources associated with the chart

Parameters

Global parameters

Name	Description	Value
global.namespaceOverride	Override the namespace for resource deployed by the chart	""
global.storageClass	Global StorageClass for Persistent Volume(s)	""

Common parameters

Name	Description	Value
fullnameOverride	String to fully override appsmith.name template	""
containerName	Specify container's name running in the pods	"appsmith"
commonLabels	Labels to add to all deployed objects	{}
commonAnnotations	Annotations to add to all deployed objects	{}

Appsmith Image parameters

Name	Description	Value
image.registry	Appsmith image registry	index.docker.io
image.repository	Appsmith image repository	appsmith/appsmith-editor
image.tag	Appsmith image tag	latest
image.pullPolicy	Appsmith image pull policy	IfNotPresent

Appsmith deployment parameters

Name	Description	Value
strategyType	Appsmith deployment strategy type	RollingUpdate
schedulerName	Alternate scheduler	""
podAnnotations	Annotations for Appsmith pods	{}
podSecurityContext	Appsmith pods security context	{}
securityContext	Set security context	{}
resources.limit	The resources limits for the Appsmith container	{}
resources.requests	The requested resources for the Appsmith container	{}
nodeSelector	Node labels for pod assignment	{}
tolerations	Tolerations for pod assignment	[]
affinity	Affinity fod pod assignment	{}

Appsmith namespace parameters

Name	Description	Value
namespace.create	Enable creation of Namespace	true

Appsmith service account parameters

Name	Description	Value
serviceAccount.create	Enable creation of ServiceAccount for Appsmith pods	true
serviceAccount.name	Name of the created ServiceAccount . If not set, a name is generated using the appsmith.fullname template	""
serviceAccount.annotations	Additional service account annotations	{}

Traffic Exposure Parameters

Name	Description	Value
service.type	Appsmith service type	ClusterIP
service.port	Appsmith service port	80
service.portName	Appsmith service port name	appsmith
service.clusterIP	Appsmith service Cluster	""
service.loadBalancerIP	Appsmith service Load Balancer IP	""
service.loadBalancerSourceRanges	Appsmith service Load Balancer sources	[]
service.annotations	Additional custom annotations for Appsmith service	{}
ingress.enabled	Enable ingress record generation for Appsmith	false
ingress.hosts	An array of hosts to be covered with the ingress record	[]
ingress.tls	Enable TLS configuration for the hosts defined at ingress.hosts parameter	false
ingress.secrets	Custom TLS certificates as secrets	[]
ingress.certManager	Enable ingress to use TLS certificates provided by Cert Manager	false
ingress.certManagerTls	Specify TLS secret resources created by Cert Manager	[]

Persistence parameters

Name	Description	Value
persistence.enabled	Enable persistence using Persistent Volume Claims	true
persistence.storageClass	Persistent Volume storage class	""
persistence.localStorage	Enable persistent volume using local storage	false
persistence.storagePath	Local storage path	/tmp/hostpath_pv
persistence.localCluster	Local running cluster to provide storage space	[minikube]
persistence.accessModes	Persistent Volume access modes	[ReadWriteOnce]
persistence.size	Persistent Volume size	10Gi
storageClass.enabled	Enable Storage Class configuration	false
storageClass.defaultClass	Create default Storage Class	false
storageClass.bindingMode	Binding mode for Persistent Volume Claims using Storage Class	Immediate
storageClass.allowVolumeExpansion	Allow expansion of Persistent Volume Claims using Storage Class	true
storageClass.reclaimPolicy	Configure the retention of the dynamically created Persistent Volume	Delete
storageClass.provisioner	Storage Class provisioner	""
storageClass.annotations	Additional storage class annotations	{}
storageClass.mountOptions	Mount options used by Persistent Volumes	{}
storageClass.parameters	Storage Class parameters	{}

Auto update chart's image

Name	Description	Value
autoupdate.enabled	Enable auto update Helm chart's image	true
autoupdate.scheduler	Schedule time to run cron job to update image	"0 * * * *"

Specify each parameter using --set key=value[,key=value] argument to helm install. For example:

helm install appsmith \
--set persistence.storageClass=appsmith-pv \
	deploy/helm

The above command deploys Appsmith application and configure application to use storage class name appsmith-pv

Alternatively, a YAML file that specifies the values for the parameters can be provided while installing the chart. For example,

helm install -f values.yaml appsmith/appsmith --generate-name

Tip: You can use the default values.yaml

Troubleshooting

If at any time you encounter an error during the installation process, reach out to support@appsmith.com or join our Discord Server

If you know the error and would like to reinstall Appsmith, simply delete the installation folder and the templates folder and execute the script again