neo4j-helm

KO | EN

gitlite — search

#javascript #hacktoberfest #ai #typescript #golang #android #machine-learning #docker #windows #awesome #vue #pytorch #mcp #open-source

(★ 89)

Helm Charts for running Neo4j on Kubernetes [DEPRECATED]

File Explorer

Download Latest Version (.zip)

- config.yml
- - bug_report.md
- - main.yml
- - cluster.yaml
  - single-instance-restore.yaml
  - standalone.yaml
- - fabric-configmap.yaml
  - instructions.txt
  - standalone-fabric.yaml
- anti-affinity-rules.yaml
- basic-cluster-with-replica.yaml
- cluster-custom-labels-annotations.yaml
- cluster-restore.yaml
- quickstart-standalone.yaml
- single-instance-restore-azure.yaml
- single-instance-restore.yaml
- standalone-custom-memory-config.yaml
- standalone-graph-data-science.yaml
- - antora.yml
- docs.yml
- package-lock.json
- package.json
- server.js
- - test-script.yaml
  - tester.yaml
- _helpers.tpl
- common-configmap.yaml
- core-configmap.yaml
- core-dns.yaml
- core-statefulset.yaml
- discovery-lb.yaml
- NOTES.txt
- pod-init-script.yaml
- poddisruptionbudget.yaml
- readreplicas-configmap.yaml
- readreplicas-dns.yaml
- readreplicas-hpa.yaml
- readreplicas-statefulset.yaml
- secret.yaml
- service-account.yaml
- - backup.sh
  - Chart.yaml
  - Dockerfile
  - README-BACKUP.md
  - values.yaml
- - Dockerfile
  - README-build.md
- - EXTERNAL-EXPOSURE.md
  - load-balancer.yaml
- - custom-core-configmap.yaml
  - EXTERNAL-EXPOSURE.md
  - load-balancer.yaml
- - Dockerfile
  - README-RESTORE.md
  - restore.sh
- - exfil-logs.sh
  - README-ROLLING-UPGRADE.md
  - rolling-upgrade.sh
- - alloc-static-ips.sh
  - Dockerfile
  - exfil-logs.sh
  - provision-k8s.sh
  - README-test.md
- Makefile
- USER-GUIDE.md
.gitignore
.helmignore
_config.yml
Chart.yaml
index.yaml
LICENSE.txt
OWNERS
README.md
values.yaml

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

[![CircleCI](https://circleci.com/gh/neo4j-contrib/neo4j-helm.svg?style=svg)](https://circleci.com/gh/neo4j-contrib/neo4j-helm)

# DEPRECATED
From version 4.3, Neo4j publishes a productized and supported version of Helm Charts, which have been written using the experience generated by the neo4j-helm Labs project. The new repository is here: https://github.com/neo4j/helm-charts.

For Neo4j standalone, productized Helm charts are available for Neo4j 4.3 and above.<br /> 
For Neo4j Causal Cluster, productized Helm charts are available for Neo4j 4.4 and above.

That is the recommended way to run Neo4j in Kubernetes. <br/> 
Full details are in the [Kubernetes section of the Neo4j operations manual](https://neo4j.com/docs/operations-manual/current/kubernetes/)

The neo4j-helm Labs Helm charts described here will keep being updated for 4.4.x , but updates will stop from the next major release 5.0
# Neo4j-Helm

This repository contains a Helm chart that starts Neo4j >= 4.0 Enterprise Edition clusters in Kubernetes.

[Full Documentation can be found here](https://neo4j.com/labs/neo4j-helm/1.0.0/)

## Quick Start

Check the [releases page](https://github.com/neo4j-contrib/neo4j-helm/releases) and copy the URL of the tgz package.   Make sure to note the correct version of Neo4j.

### Standalone (single server)

```bash
$ helm install mygraph RELEASE_URL --set core.standalone=true --set acceptLicenseAgreement=yes --set neo4jPassword=mySecretPassword
```

### Casual Cluster (3 core, 0 read replicas)

```bash
$ helm install mygraph RELEASE_URL --set acceptLicenseAgreement=yes --set neo4jPassword=mySecretPassword
```

When you're done:  `helm uninstall mygraph`.

## Documentation

The [User Guide](https://neo4j.com/labs/neo4j-helm/1.0.0/) contains all the documentation for this helm chart.

The [Neo4j Community Site](https://community.neo4j.com/c/neo4j-graph-platform/cloud/76) is a great place to go for
discussion and questions about Neo4j & Kubernetes.

Additional instructions, general documentation, and operational facets are covered in the following
articles:

- [Architectural Documentation describing how the helm chart is put together](https://docs.google.com/presentation/d/14ziuwTzB6O7cp7fq0mA1lxWwZpwnJ9G4pZiwuLxBK70/edit?usp=sharing)
- [External exposure of Neo4j clusters on Kubernetes](tools/external-exposure/EXTERNAL-EXPOSURE.md) - how to use
tools like Neo4j Browser and cypher-shell from clients originating outside of Kubernetes
- [Neo4j Considerations in Orchestration Environments](https://medium.com/neo4j/neo4j-considerations-in-orchestration-environments-584db747dca5) which covers
how the smart-client routing protocol that Neo4j uses interacts with Kubernetes networking.  Make sure to read this if you are trying to expose the Neo4j database outside
of Kubernetes
- [How to Backup Neo4j Running in Kubernetes](https://medium.com/neo4j/how-to-backup-neo4j-running-in-kubernetes-3697761f229a)
- [How to Restore Neo4j Backups on Kubernetes](https://medium.com/google-cloud/how-to-restore-neo4j-backups-on-kubernetes-and-gke-6841aa1e3961)

## Helm Testing

This chart contains a standard set of [helm chart tests](https://helm.sh/docs/topics/chart_tests/), which 
can be run after a deploy is ready, like this:

```
helm test mygraph
```

## Local Testing & Development

### Template Expansion

To see what helm will actually deploy based on the templates:

```
helm template --name-template tester --set acceptLicenseAgreement=yes --set neo4jPassword=mySecretPassword . > expanded.yaml
```

### Full-Cycle Test

The following mini-script will provision a test cluster, monitor it for rollout, test it,
report test results, and teardown / destroy PVCs.

#### Provision K8S Cluster

Please use the `tools/test/provision-k8s.sh`, and customize your Google Cloud
project ID.

#### Standalone

Standalone forms faster so we can manually lower the liveness/readiness timeouts.

```
export NAME=a
export NAMESPACE=default
helm install $NAME . -f deployment-scenarios/ci/standalone.yaml && \
kubectl rollout status --namespace $NAMESPACE StatefulSet/$NAME-neo4j-core --watch && \
helm test $NAME --logs | tee testlog.txt
helm uninstall $NAME
sleep 20
for idx in 0 1 2 ; do
  kubectl delete pvc datadir-$NAME-neo4j-core-$idx ;
done
```

#### Causal Cluster

```
export NAME=a
export NAMESPACE=default
helm install $NAME . -f deployment-scenarios/ci/cluster.yaml && \
kubectl rollout status --namespace $NAMESPACE StatefulSet/$NAME-neo4j-core --watch && \
helm test $NAME --logs | tee testlog.txt
helm uninstall $NAME
sleep 20
for idx in 0 1 2 ; do
  kubectl delete pvc datadir-$NAME-neo4j-core-$idx ;
done
```

## Internal Tooling

This repo contains internal tooling containers for backup, restore, and test of
the helm chart.

### Building the Containers

If you want to push your own docker containers, make sure that the registry in 
the Makefile is set to somewhere you have permissions on.

```
cd tools
make docker_build
make docker_push
```

neo4j-helm

File Explorer

Today's picks

Was this content helpful?

Recent Feedback

neo4j-helm

File Explorer

Today's picks

Was this content helpful?

Recent Feedback

Download README