-
Notifications
You must be signed in to change notification settings - Fork 11
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Feat/nwaku #47
Open
calinah
wants to merge
9
commits into
main
Choose a base branch
from
feat/nwaku
base: main
Could not load branches
Branch not found: {{ refName }}
Loading
Could not load tags
Nothing to show
Loading
Are you sure you want to change the base?
Some commits from the old base branch may be removed from the timeline,
and old review comments may become outdated.
Open
Feat/nwaku #47
Changes from all commits
Commits
Show all changes
9 commits
Select commit
Hold shift + click to select a range
566b970
feat(nwaku): wip nwaku v2
calinah be1e1d3
feat(nwaku): working wakunode2
calinah f774b48
feat(nwaku): fixing readinessProbe
calinah 2999920
feat(nwaku): added support for nodekey & dashboard
calinah 46d1769
feat(nwaku): updated README
calinah 0c8e6a5
feat(nwaku): updated based on PR review
calinah 314308a
feat(nwaku): updated jwt key secret file name
calinah 71477d0
feat(nwaku): updated jwt key secret file name
calinah 0c9c6ba
feat(nwaku): rm-ing unneeded flag
calinah File filter
Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,23 @@ | ||
# Patterns to ignore when building packages. | ||
# This supports shell glob matching, relative path matching, and | ||
# negation (prefixed with !). Only one pattern per line. | ||
.DS_Store | ||
# Common VCS dirs | ||
.git/ | ||
.gitignore | ||
.bzr/ | ||
.bzrignore | ||
.hg/ | ||
.hgignore | ||
.svn/ | ||
# Common backup files | ||
*.swp | ||
*.bak | ||
*.tmp | ||
*.orig | ||
*~ | ||
# Various IDEs | ||
.project | ||
.idea/ | ||
*.tmproj | ||
.vscode/ |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,24 @@ | ||
apiVersion: v2 | ||
name: nwaku | ||
description: Deploy and scale [Waku v2 Node](https://github.com/waku-org/nwaku) inside Kubernetes with ease | ||
|
||
# A chart can be either an 'application' or a 'library' chart. | ||
# | ||
# Application charts are a collection of templates that can be packaged into versioned archives | ||
# to be deployed. | ||
# | ||
# Library charts provide useful utilities or functions for the chart developer. They're included as | ||
# a dependency of application charts to inject those utilities and functions into the rendering | ||
# pipeline. Library charts do not define any templates and therefore cannot be deployed. | ||
type: application | ||
|
||
# This is the chart version. This version number should be incremented each time you make changes | ||
# to the chart and its templates, including the app version. | ||
# Versions are expected to follow Semantic Versioning (https://semver.org/) | ||
version: 0.1.0 | ||
|
||
# This is the version number of the application being deployed. This version number should be | ||
# incremented each time you make changes to the application. Versions are not expected to | ||
# follow Semantic Versioning. They should reflect the version the application is using. | ||
# It is recommended to use it with quotes. | ||
appVersion: "v0.14.0" |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,115 @@ | ||
# Nwaku Helm Chart | ||
|
||
Deploy and scale [Waku v2 Node](https://github.com/waku-org/nwaku) inside Kubernetes with ease | ||
|
||
[![License](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](https://opensource.org/licenses/Apache-2.0) ![Version: 0.1.0](https://img.shields.io/badge/Version-0.1.0-informational?style=flat-square) ![Type: application](https://img.shields.io/badge/Type-application-informational?style=flat-square) ![AppVersion: v0.14.0](https://img.shields.io/badge/AppVersion-v0.14.0-informational?style=flat-square) | ||
|
||
## Features | ||
|
||
- Actively maintained by [GraphOps](https://graphops.xyz) [and contributors](https://github.com/graphops/helm-charts/graphs/contributors) | ||
- Strong security defaults (non-root execution, ready-only root filesystem, drops all capabilities) | ||
- Readiness checks to ensure traffic only hits `Pod`s that are healthy and ready to serve requests | ||
- Support for `ServiceMonitor`s to configure Prometheus to scrape metrics ([prometheus-operator](https://github.com/prometheus-operator/prometheus-operator)) | ||
- Support for configuring Grafana dashboards for nwaku ([grafana](https://github.com/grafana/helm-charts/tree/main/charts/grafana)) | ||
- Support for exposing a NodePort to enable inbound P2P dials for better peering | ||
|
||
## Quickstart | ||
|
||
To install the chart with the release name `my-release`: | ||
|
||
```console | ||
$ helm repo add graphops http://graphops.github.io/helm-charts | ||
$ helm install my-release graphops/nwaku | ||
``` | ||
|
||
Once the release is installed, nwaku will begin syncing. You can use `kubectl logs` to monitor the sync status. See the Values section to install Prometheus `ServiceMonitor`s and a Grafana dashboard. | ||
|
||
## JSON-RPC | ||
|
||
### Built-in JSON-RPC | ||
|
||
You can access JSON-RPC via the stateful node `Service` (`<release-name>-nwaku`) on port `8545` by default. | ||
|
||
## Enabling inbound P2P dials | ||
|
||
By default, your nwaku node will not have an internet-accessible port for P2P traffic. This makes it harder for your node to establish a strong set of peers because you cannot accept inbound P2P dials. To change this behaviour, you can set `nwaku.p2pNodePort.enabled` to `true`. This will make your node accessible via the Internet using a `Service` of type `NodePort`. When using `nwaku.p2pNodePort.enabled`, the exposed IP address on your nwaku ENR record will be the "External IP" of the Node where the Pod is running. When using this mode, `nwaku.replicaCount` will be locked to `1`. | ||
|
||
```yaml | ||
# values.yaml | ||
|
||
nwaku: | ||
p2pNodePort: | ||
enabled: true | ||
port: 31000 # Must be globally unique and available on the host | ||
``` | ||
|
||
You can monitor progress by following the logs of the `nwaku` container: `kubectl logs --since 1m -f release-name-nwaku-0` | ||
|
||
## Upgrading | ||
|
||
We recommend that you pin the version of the Chart that you deploy. You can use the `--version` flag with `helm install` and `helm upgrade` to specify a chart version constraint. | ||
|
||
This project uses [Semantic Versioning](https://semver.org/). Changes to the version of the application (the `appVersion`) that the Chart deploys will generally result in a patch version bump for the Chart. Breaking changes to the Chart or its `values.yaml` interface will be reflected with a major version bump. | ||
|
||
We do not recommend that you upgrade the application by overriding `image.tag`. Instead, use the version of the Chart that is built for your desired `appVersion`. | ||
|
||
## Values | ||
|
||
| Key | Description | Type | Default | | ||
|-----|-------------|------|---------| | ||
| fullnameOverride | | string | `""` | | ||
| grafana.dashboards | Enable creation of Grafana dashboards. [Grafana chart](https://github.com/grafana/helm-charts/tree/main/charts/grafana#grafana-helm-chart) must be configured to search this namespace, see `sidecar.dashboards.searchNamespace` | bool | `false` | | ||
| grafana.dashboardsConfigMapLabel | Must match `sidecar.dashboards.label` value for the [Grafana chart](https://github.com/grafana/helm-charts/tree/main/charts/grafana#grafana-helm-chart) | string | `"grafana_dashboard"` | | ||
| grafana.dashboardsConfigMapLabelValue | Must match `sidecar.dashboards.labelValue` value for the [Grafana chart](https://github.com/grafana/helm-charts/tree/main/charts/grafana#grafana-helm-chart) | string | `"1"` | | ||
| image.pullPolicy | | string | `"IfNotPresent"` | | ||
| image.repository | Image for nwaku | string | `"statusteam/nim-waku"` | | ||
| image.tag | Overrides the image tag | string | Chart.appVersion | | ||
| imagePullSecrets | Pull secrets required to fetch the Image | list | `[]` | | ||
| nameOverride | | string | `""` | | ||
| nwaku.affinity | | object | `{}` | | ||
| nwaku.affinityPresets.antiAffinityByHostname | Configure anti-affinity rules to prevent multiple instances on the same host | bool | `true` | | ||
| nwaku.extraArgs | Additional CLI arguments | list | `[]` | | ||
| nwaku.extraLabels | Extra labels to attach to the Pod for matching against | object | `{}` | | ||
| nwaku.initChownData.enabled | Init container to set the correct permissions to access data directories | bool | `true` | | ||
| nwaku.initChownData.image.pullPolicy | Container pull policy | string | `"IfNotPresent"` | | ||
| nwaku.initChownData.image.repository | Container repository | string | `"busybox"` | | ||
| nwaku.initChownData.image.tag | Container tag | string | `"1.34.0"` | | ||
| nwaku.nodeSelector | | object | `{}` | | ||
| nwaku.nodekey | Key to use to maintain consistent addressing between restarts https://github.com/waku-org/nwaku/blob/master/docs/operators/how-to/configure-key.md#generate-and-configure-a-node-key | object | `{"existingSecret":{"key":"","name":""},"fromLiteral":""}` | | ||
| nwaku.nodekey.existingSecret | Load the key from an existing Kubernetes Secret. Takes precedence over `fromLiteral` if set. | object | `{"key":"","name":""}` | | ||
| nwaku.nodekey.existingSecret.key | Data key for the NodeKey in the Secret | string | `""` | | ||
| nwaku.nodekey.existingSecret.name | Name of the Secret resource in the same namespace | string | `""` | | ||
| nwaku.nodekey.fromLiteral | Use this literal value for the NodeKey | string | `""` | | ||
| nwaku.p2pNodePort.enabled | Expose P2P port via NodePort | bool | `false` | | ||
| nwaku.p2pNodePort.initContainer.image.pullPolicy | Container pull policy | string | `"IfNotPresent"` | | ||
| nwaku.p2pNodePort.initContainer.image.repository | Container image to fetch nodeport information | string | `"lachlanevenson/k8s-kubectl"` | | ||
| nwaku.p2pNodePort.initContainer.image.tag | Container tag | string | `"v1.21.3"` | | ||
| nwaku.p2pNodePort.port | NodePort to be used. Must be unique. | int | `31000` | | ||
| nwaku.podAnnotations | Annotations for the `Pod` | object | `{}` | | ||
| nwaku.podSecurityContext | Pod-wide security context | object | `{"fsGroup":101337,"runAsGroup":101337,"runAsNonRoot":true,"runAsUser":101337}` | | ||
| nwaku.resources | | object | `{}` | | ||
| nwaku.service.ports.http-jsonrpc | Service Port to expose JSON-RPC interface on | int | `8545` | | ||
| nwaku.service.ports.http-metrics | Service Port to expose Prometheus metrics on | int | `8008` | | ||
| nwaku.service.ports.http-rest | | int | `8645` | | ||
| nwaku.service.ports.http-ws | Service Port to expose gRPC interface on | int | `8000` | | ||
| nwaku.service.type | | string | `"ClusterIP"` | | ||
| nwaku.terminationGracePeriodSeconds | Amount of time to wait before force-killing the container | int | `60` | | ||
| nwaku.tolerations | | list | `[]` | | ||
| nwaku.volumeClaimSpec | [PersistentVolumeClaimSpec](https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.23/#persistentvolumeclaimspec-v1-core) for storage | object | `{"accessModes":["ReadWriteOnce"],"resources":{"requests":{"storage":"1.5Ti"}},"storageClassName":null}` | | ||
| nwaku.volumeClaimSpec.resources.requests.storage | The amount of disk space to provision | string | `"1.5Ti"` | | ||
| nwaku.volumeClaimSpec.storageClassName | The storage class to use when provisioning a persistent volume | string | `nil` | | ||
| prometheus.serviceMonitors.enabled | Enable monitoring by creating `ServiceMonitor` CRDs ([prometheus-operator](https://github.com/prometheus-operator/prometheus-operator)) | bool | `false` | | ||
| prometheus.serviceMonitors.interval | | string | `nil` | | ||
| prometheus.serviceMonitors.labels | | object | `{}` | | ||
| prometheus.serviceMonitors.relabelings | | list | `[]` | | ||
| prometheus.serviceMonitors.scrapeTimeout | | string | `nil` | | ||
| rbac.clusterRules | Required ClusterRole rules | list | See `values.yaml` | | ||
| rbac.create | Specifies whether RBAC resources are to be created | bool | `true` | | ||
| rbac.rules | Required ClusterRole rules | list | See `values.yaml` | | ||
| serviceAccount.annotations | Annotations to add to the service account | object | `{}` | | ||
| serviceAccount.create | Specifies whether a service account should be created | bool | `true` | | ||
| serviceAccount.name | The name of the service account to use. If not set and create is true, a name is generated using the fullname template | string | `""` | | ||
|
||
## Contributing | ||
|
||
We welcome and appreciate your contributions! Please see the [Contributor Guide](/CONTRIBUTING.md), [Code Of Conduct](/CODE_OF_CONDUCT.md) and [Security Notes](/SECURITY.md) for this repository. |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,54 @@ | ||
{{ template "graphops.title" . }} | ||
|
||
{{ template "chart.description" . }} | ||
|
||
{{ template "graphops.badges" . }} | ||
|
||
## Features | ||
|
||
- Actively maintained by [GraphOps](https://graphops.xyz) [and contributors](https://github.com/graphops/helm-charts/graphs/contributors) | ||
- Strong security defaults (non-root execution, ready-only root filesystem, drops all capabilities) | ||
- Readiness checks to ensure traffic only hits `Pod`s that are healthy and ready to serve requests | ||
- Support for `ServiceMonitor`s to configure Prometheus to scrape metrics ([prometheus-operator](https://github.com/prometheus-operator/prometheus-operator)) | ||
- Support for configuring Grafana dashboards for nwaku ([grafana](https://github.com/grafana/helm-charts/tree/main/charts/grafana)) | ||
- Support for exposing a NodePort to enable inbound P2P dials for better peering | ||
|
||
## Quickstart | ||
|
||
To install the chart with the release name `my-release`: | ||
|
||
```console | ||
$ helm repo add graphops http://graphops.github.io/helm-charts | ||
$ helm install my-release graphops/{{ template "chart.name" . }} | ||
``` | ||
|
||
Once the release is installed, nwaku will begin syncing. You can use `kubectl logs` to monitor the sync status. See the Values section to install Prometheus `ServiceMonitor`s and a Grafana dashboard. | ||
|
||
## JSON-RPC | ||
|
||
### Built-in JSON-RPC | ||
|
||
You can access JSON-RPC via the stateful node `Service` (`<release-name>-nwaku`) on port `8545` by default. | ||
|
||
## Enabling inbound P2P dials | ||
|
||
By default, your nwaku node will not have an internet-accessible port for P2P traffic. This makes it harder for your node to establish a strong set of peers because you cannot accept inbound P2P dials. To change this behaviour, you can set `nwaku.p2pNodePort.enabled` to `true`. This will make your node accessible via the Internet using a `Service` of type `NodePort`. When using `nwaku.p2pNodePort.enabled`, the exposed IP address on your nwaku ENR record will be the "External IP" of the Node where the Pod is running. When using this mode, `nwaku.replicaCount` will be locked to `1`. | ||
|
||
```yaml | ||
# values.yaml | ||
|
||
nwaku: | ||
p2pNodePort: | ||
enabled: true | ||
port: 31000 # Must be globally unique and available on the host | ||
``` | ||
|
||
You can monitor progress by following the logs of the `nwaku` container: `kubectl logs --since 1m -f release-name-nwaku-0` | ||
|
||
{{ template "graphops.upgradingSection" . }} | ||
|
||
{{ template "chart.requirementsSection" . }} | ||
|
||
{{ template "chart.valuesSection" . }} | ||
|
||
{{ template "graphops.contributingSection" . }} |
Oops, something went wrong.
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
I don't believe this is correct
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
@chriswessels waku does expose jsonrpc on 8545 - is this what you mean