This repository contains a Helm Chart that can be used to deploy MarkLogic on a Kubernetes cluster. Below is a brief description of how to easily create a MarkLogic StatefulSet for development and testing. See MarkLogic Server on Kubernetes for detailed documentation about running this.
Helm and Kubectl must be installed locally in order to use this chart.
For production environments, it is recommend to use a managed Kubenetes service such as AWS EKS. The eksctl command line tool can be used to bring up a Kubernetes cluster on EKS. Please refer to Using eksctl to Provision a Kubernetes Cluster on EKS for detailed steps.
For non-production deployments, please see MiniKube Setup Guide to create the Kubernetes cluster locally.
This Helm chart supports Kubernetes 1.23 or later.
This Helm chart has been tested on EKS (Elastic Kubernetes Service on AWS) and AKS (Azure Kubernetes Service), nevertheless it is expected to work on GKE (Google Kubernetes Engine) and RedHat OpenShift.
This Helm chart supports MarkLogic starting release 10.0-10-2.
This below example Helm Chart installation will create a single-node MarkLogic cluster with a "Default" group. A 20GB persistent volume, 2 vCPUs, and 4GB of RAM will be allocated for the pod.
- Add MarkLogic Repo to Helm
helm repo add marklogic https://marklogic.github.io/marklogic-kubernetes/
- Create a Kubernetes namespace:
kubectl create namespace marklogic
- When installing the Helm Chart, if a secret is not provided, the MarkLogic admin credentials will be generated automatically. To create a secret to specify custom admin credentials including the username, password and wallet-password, use the following command (substituting the desired values):
kubectl create secret generic ml-admin-secrets \
--from-literal=username='' \
--from-literal=password='' \
--from-literal=wallet-password='' \
--namespace=marklogic
Refer to the official Kubernetes documentation for detailed steps on how to create a secret.
- Create a
values.yaml
file to customize the settings. Specify the number of pods (one MarkLogic host in this case), add the secret name for the admin credentials (if not using the automatically generated one), and specify the resources that should be allocated to each MarkLiogic pod.
Note: Please ensure to use the latest MarkLogic Docker image for the new implementation as specified in the values.yaml file below. Refer to https://hub.docker.com/r/progressofficial/marklogic-db/tags for the latest image available.
# Create a single MarkLogic pod
replicaCount: 1
# Marklogic image parameters
# using the latest image 11.3.1-ubi-rootless-2.1.0
image:
repository: progressofficial/marklogic-db
tag: 11.3.1-ubi-rootless-2.1.0
pullPolicy: IfNotPresent
# Set the admin credentials secret. Leave this out or set to blank "" to use the automatically generated secret.
auth:
secretName: "ml-admin-secrets"
# Configure compute resources
resources:
requests:
cpu: 2000m
memory: 4000Mi
limits:
cpu: 2000m
memory: 4000Mi
# Configure the persistent volume
persistence:
enabled: true
size: 20Gi
- Install the MarkLogic Helm Chart with the above custom settings. The rest of the settings will default to the values as listed below in the Parameters section.
helm install my-release marklogic/marklogic --values values.yaml --namespace=marklogic
Once the installation is complete and the pod is in a running state, the MarkLogic admin UI can be accessed using the port-forwarding command as below:
kubectl port-forward my-release-marklogic-0 8000:8000 8001:8001 --namespace=marklogic
Please refer Official Documentation for more options on accessing MarkLogic server in a Kubernetes cluster.
If using the automatically generated admin credentials, use the following steps to extract the admin username, password and wallet-password from a secret:
- Run the below command to fetch all of the secret names:
kubectl get secrets
The MarkLogic admin secret name will be in the format RELEASE_NAME-marklogic-admin
(my-release-marklogic-admin
for the example above).
- Using the secret name from step 1 to get MarkLogic admin credentials, retrieve the values using the following commands:
kubectl get secret my-release-marklogic-admin -o jsonpath='{.data.username}' | base64 --decode
kubectl get secret my-release-marklogic-admin -o jsonpath='{.data.password}' | base64 --decode
kubectl get secret my-release-marklogic-admin -o jsonpath='{.data.wallet-password}' | base64 --decode
To configure other settings, add them to the values.yaml
file. See Parameters section for more information about these settings.
Following table lists all the parameters supported by the latest MarkLogic Helm chart:
Name | Description | Default Value |
---|---|---|
replicaCount |
Number of MarkLogic Nodes | 1 |
updateStrategy.type |
Update strategy for MarkLogic pods | OnDelete |
terminationGracePeriod |
Seconds the MarkLogic Pod terminate gracefully | 120 |
clusterDomain |
Domain for the Kubernetes cluster | cluster.local |
allowLongHostnames |
Allow deployment with hostname over 64 characters | false |
useLegacyHostnames |
Use the lagecy hostnames that is used before 1.1.0 version. | false |
podAnnotations |
Pod Annotations | {} |
group.name |
Group name for joining MarkLogic cluster | Default |
group.enableXdqpSsl |
SSL encryption for XDQP | true |
bootstrapHostName |
Host name of MarkLogic bootstrap host (to join a cluster) | "" |
image.repository |
Repository for MarkLogic image | progressofficial/marklogic-db |
image.tag |
Image tag for MarkLogic image | 11.3.0-ubi-rootless |
image.pullPolicy |
Image pull policy for MarkLogic image | IfNotPresent |
initContainers.configureGroup.image |
Image for configureGroup InitContainer | curlimages/curl:8.8.0 |
initContainers.configureGroup.pullPolicy |
Pull policy for configureGroup InitContainer | IfNotPresent |
initContainers.utilContainer.image |
Image for copyCerts and volume permission change for root to rootless upgrade InitContainer | redhat/ubi9:9.4 |
initContainers.utilContainer.pullPolicy |
Pull policy for copyCerts and volume permission change for root to rootless upgrade InitContainer | IfNotPresent |
imagePullSecrets |
Registry secret names as an array | [] |
hugepages.enabled |
Parameter to enable Hugepage on MarkLogic | false |
hugepages.mountPath |
Mountpath for Hugepages | /dev/hugepages |
resources |
The resource requests and limits for MarkLogic container | {} |
nameOverride |
String to override the app name | "" |
fullnameOverride |
String to completely replace the generated name | "" |
auth.secretName |
Kubernetes Secret name for MarkLogic Admin credentials | "" |
auth.adminUsername |
Username for default MarkLogic Administrator | "" |
auth.adminPassword |
Password for default MarkLogic Administrator | "" |
auth.walletPassword |
Password for wallet | "" |
tls.enableOnDefaultAppServers |
Parameter to enalbe TLS on Default App Servers (8000, 8001, 8002) | false |
tls.certSecretNames |
Names of the secrets that contain the named certificate | [] |
tls.caSecretName |
Name of the secret that contain the CA certificate | "" |
enableConverters |
Parameter to Install converters for the client if they are not already installed. | false |
license.key |
Set MarkLogic license key installed | "" |
license.licensee |
Set MarkLogic licensee information | "" |
affinity |
Affinity for MarkLogic pods assignment | {} |
topologySpreadConstraints |
POD Topology Spread Constraints to spread Pods across cluster | [] |
nodeSelector |
Node labels for MarkLogic pods assignment | {} |
persistence.enabled |
Parameter to enable MarkLogic data persistence using Persistence Volume Claim (PVC). If set to false, EmptyDir will be used. | true |
persistence.storageClass |
Storage class for MarkLogic data volume, leave empty to use the default storage class | "" |
persistence.size |
Size of storage request for MarkLogic data volume | 10Gi |
persistence.annotations |
Annotations for Persistence Volume Claim (PVC) | {} |
persistence.accessModes |
Access mode for persistence volume | ["ReadWriteOnce"] |
additionalVolumeClaimTemplates |
List of additional volumeClaimTemplates to each MarkLogic container | [] |
additionalVolumes |
List of additional volumes to add to the MarkLogic containers | [] |
additionalVolumeMounts |
List of mount points for the additional volumes to add to the MarkLogic containers | [] |
additionalContainerPorts |
List of ports in addition to the defaults exposed at the container level (Note: This does not typically need to be updated. Use service.additionalPorts to expose app server ports.) |
[] |
service.annotations |
Annotations for MarkLogic service | {} |
service.type |
Default service type | ClusterIP |
service.additionalPorts |
List of ports in addition to the defaults exposed at the service level | [] |
serviceAccount.create |
Parameter to enable creating a service account for a MarkLogic Pod | true |
serviceAccount.annotations |
Annotations for MarkLogic service account | {} |
serviceAccount.name |
Name of the serviceAccount | "" |
priorityClassName |
Name of a PriortyClass defined to set pod priority | "" |
networkPolicy.enabled |
Parameter to enable network policy | false |
networkPolicy.customRules |
Placeholder to specify selectors | {} |
networkPolicy.ports |
Parameter to specify the ports where traffic is allowed | [{port:8000, endPort: 8020, protocol: TCP}] |
podSecurityContext.enabled |
Parameter to enable security context for pod running MarkLogic containers | true |
podSecurityContext.fsGroup |
Parameter to specify the group id for mounted data volume | 2 |
podSecurityContext.fsGroupChangePolicy |
Parameter to specify how the volume ownership should be changed when a pod's volumes needs to be updated with an fsGroup | OnRootMismatch |
containerSecurityContext.enabled |
Parameter to enable security context for MarkLogic containers | true |
containerSecurityContext.runAsUser |
User ID to run the entrypoint of the container process | 1000 |
containerSecurityContext.runAsNonRoot |
Indicates that the container must run as a non-root user | true |
containerSecurityContext.allowPrivilegeEscalation |
Controls whether a process can gain more privileges than its parent process | false |
livenessProbe.enabled |
Parameter to enable the liveness probe | true |
livenessProbe.initialDelaySeconds |
Initial delay seconds for liveness probe | 300 |
livenessProbe.periodSeconds |
Period seconds for liveness probe | 10 |
livenessProbe.timeoutSeconds |
Timeout seconds for liveness probe | 5 |
livenessProbe.failureThreshold |
Failure threshold for liveness probe | 15 |
livenessProbe.successThreshold |
Success threshold for liveness probe | 1 |
readinessProbe.enabled |
Parameter to enable the readiness probe | true |
readinessProbe.initialDelaySeconds |
Initial delay seconds for readiness probe | 10 |
readinessProbe.periodSeconds |
Period seconds for readiness probe | 10 |
readinessProbe.timeoutSeconds |
Timeout seconds for readiness probe | 5 |
readinessProbe.failureThreshold |
Failure threshold for readiness probe | 3 |
readinessProbe.successThreshold |
Success threshold for readiness probe | 1 |
logCollection.enabled |
Parameter to enable cluster wide log collection of Marklogic server logs | false |
logCollection.image |
Image repository and tag for fluent-bit container | fluent/fluent-bit:3.1.1 |
logCollection.resources.requests.cpu |
The requested cpu resource for the fluent-bit container | 100m |
logCollection.resources.requests.memory |
The requested memory resource for the fluent-bit container | 128Mi |
logCollection.resources.limits.cpu |
The cpu resource limit for the fluent-bit container | 100m |
logCollection.resources.limits.memory |
The memory resource limit for the fluent-bit container | 128Mi |
logCollection.files.errorLogs |
Parameter to enable collection of MarkLogics error logs when log collection is enabled | true |
logCollection.files.accessLogs |
Parameter to enable collection of MarkLogics access logs when log collection is enabled | true |
logCollection.files.requestLogs |
Parameter to enable collection of MarkLogics request logs when log collection is enabled | true |
logCollection.files.crashLogs |
Parameter to enable collection of MarkLogics crash logs when log collection is enabled | true |
logCollection.files.auditLogs |
Parameter to enable collection of MarkLogics audit logs when log collection is enabled | true |
logCollection.outputs |
Configure desired output for fluent-bit | "" |
haproxy.enabled |
Parameter to enable the HAProxy Load Balancer for MarkLogic Server | false |
haproxy.existingConfigmap |
Name of an existing configmap with configuration for HAProxy | marklogic-haproxy |
haproxy.replicaCount |
Number of HAProxy Deployment | 2 |
haproxy.restartWhenUpgrade.enabled |
Automatically roll Deployments for every helm upgrade | true |
haproxy.stats.enabled |
Parameter to enable the stats page for HAProxy | false |
haproxy.stats.port |
Port for stats page | 1024 |
haproxy.stats.auth.enabled |
Parameter to enable the basic auth for stats page | false |
haproxy.stats.auth.username |
Username for stats page | "" |
haproxy.stats.auth.password |
Password for stats page | "" |
haproxy.service.type |
The service type of the HAproxy | ClusterIP |
haproxy.pathbased.enabled |
Parameter to enable path based routing on the HAProxy Load Balancer for MarkLogic | false |
haproxy.frontendPort |
Listening port in the Front-End section of the HAProxy when using Path based routing | 443 |
haproxy.defaultAppServers.appservices.path |
Path used to expose MarkLogic App-Services App-Server | "" |
haproxy.defaultAppServers.admin.path |
Path used to expose MarkLogic Admin App-Server | "" |
haproxy.defaultAppServers.manage.path |
Path used to expose the MarkLogic Manage App-Server | "" |
haproxy.additionalAppServers |
List of additional HTTP Ports configuration for HAproxy | [] |
haproxy.tcpports.enabled |
Parameter to enable TCP port routing on HAProxy | false |
haproxy.tcpports |
TCP Ports and load balancing type configuration for HAproxy | [] |
haproxy.timemout.client |
Timeout client measures inactivity during periods that we would expect the client to be speaking | 600s |
haproxy.timeout.connect |
Timeout connect configures the time that HAProxy will wait for a TCP connection to a backend server to be established | 600s |
haproxy.timeout.server |
Timeout server measures inactivity when we’d expect the backend server to be speaking | 600s |
haproxy.tls.enabled |
Parameter to enable TLS for HAProxy | false |
haproxy.tls.secretName |
Name of the secret that stores the certificate | "" |
haproxy.tls.certFileName |
The name of the certificate file in the secret | "" |
haproxy.nodeSelector |
Node labels for HAProxy pods assignment | {} |
haproxy.affinity |
Affinity for HAProxy pods assignment | {} |
haproxy.resources.requests.cpu |
The requested cpu resource for the HAProxy container | 250m |
haproxy.resources.requests.memory |
The requested memory resource for the HAProxy container | 128Mi |
haproxy.resources.limits.cpu |
The cpu resource limit for the HAProxy container | 250m |
haproxy.resources.limits.memory |
The memory resource limit for the HAProxy container | 128Mi |
ingress.enabled |
Enable an ingress resource for the MarkLogic cluster | false |
ingress.className |
Defines which ingress controller will implement the resource | "" |
ingress.labels |
Additional ingress labels | {} |
ingress.annotations |
Additional ingress annotations | {} |
ingress.hosts |
List of ingress hosts | [] |
ingress.additionalHost |
List of ingress additional hosts | [] |
- If the hostname is greater than 64 characters there will be issues with certificates. It is highly recommended to use hostname shorter than 64 characters or use SANs for hostnames in the certificates. If you still choose to use hostname greater than 64 characters, set "allowLongHostnames" to true.
- The latest released version of fluent/fluent-bit:3.1.1 has known high and critical security vulnerabilities. If you decide to enable the log collection feature, choose and deploy the fluent-bit or an alternate image with no vulnerabilities as per your requirements.
- The security context “allowPrivilegeEscalation” is set to false by default in the values.yaml file. This should not be changed when running the MarkLogic container with default rootless image. If you choose to use an image with root privileges, set "allowPrivilegeEscalation" to true.
- Known Issues and Limitations for the MarkLogic Server Docker image can be viewed using the link: https://github.com/marklogic/marklogic-docker?tab=readme-ov-file#Known-Issues-and-Limitations.
- Path-based routing and Ingress features are only supported with MarkLogic 11.1 and higher.