helm-charts

PlatformNOW Helm Charts

License Release Charts Downloads

Introduction

This repository contains Helm charts for various projects used by PlatformNOW. The charts are available in the PlatformNOW Helm Charts Repository.

Available Charts

Parent Charts (with dependencies)

These charts serve as parent charts that include specific dependencies:

Chart Description
argo-cd Declarative GitOps CD for Kubernetes
aws-ebs-csi-driver AWS EBS CSI driver
aws-load-balancer-controller AWS Load Balancer Controller
cert-manager Certificate management controller
cluster-autoscaler Kubernetes cluster autoscaler
crossplane Cloud native control plane framework
external-dns External DNS controller
external-secrets External Secrets operator
istio-base Istio base components
istio-ingress Istio ingress gateway
istiod Istio control plane
localstack LocalStack - A fully functional local AWS cloud stack
metrics-server Kubernetes metrics server
opentelemetry-operator OpenTelemetry Operator

Standalone Charts

These are individual service charts:

Chart Description
adservice Advertisement Service
cartservice Shopping Cart Service
checkoutservice Checkout Service
common Common chart templates and helpers
currencyservice Currency Service
emailservice Email Service
frontendservice Frontend Service
landscape-backend Landscape Backend Service
landscape-frontend Landscape Frontend Service
loadgeneratorservice Load Generator Service
opentelemetrycollectorservice OpenTelemetry Collector Service
paymentservice Payment Service
portalnow-template PortalNOW Template Chart
productcatalogservice Product Catalog Service
recommendationservice Recommendation Service
redisservice Redis Service
shippingservice Shipping Service

Usage

Helm must be installed to use the charts. Please refer to Helm’s documentation to get started.

Once Helm is set up properly, add the repository as follows:

helm repo add platformnow https://platformnow.github.io/helm-charts

You can then run helm search repo platformnow to see the charts.

Installing a Chart

To install a chart, use the following command:

helm install my-release platformnow/<chart-name>

For example:

helm install my-argo-cd platformnow/argo-cd

Using OCI Registry

Our charts are also available as OCI artifacts. You can pull them directly from our GitHub Container Registry:

# Pull a specific chart version
helm pull oci://ghcr.io/platformnow/charts/<chart-name> --version <version>

# Example
helm pull oci://ghcr.io/platformnow/charts/aws-ebs-csi-driver --version 2.41.0-0

You can also install directly from the OCI registry:

helm install my-release oci://ghcr.io/platformnow/charts/<chart-name> --version <version>

Configuration

Each chart has its own values.yaml file with detailed configuration options. Please refer to the individual chart’s README for specific configuration options.

Contributing

The source code of all PlatformNOW Helm charts can be found on Github: https://github.com/platformnow/helm-charts/

We’d love to have you contribute! Please refer to our contribution guidelines for details.

Adding a New Chart

To add a new chart to this repository:

  1. Use our GitHub Action workflow to create the chart structure:
    • Go to Actions → Add Helm Chart
    • Click “Run workflow”
    • Fill in the required information:
      • Chart Repository Name (e.g., external-dns)
      • Chart Repository URL (e.g., https://kubernetes-sigs.github.io/external-dns/)
      • Chart Name (e.g., external-dns)
      • Chart Version (e.g., 1.15.0)
      • Docker Image Registry URL
      • Docker Image Version
  2. The workflow will:
    • Create the basic chart structure
    • Add necessary files (Chart.yaml, values.yaml, README.md)
    • A Job Summary will then allow you to Create a pull request with your changes
  3. Review the generated files and make any necessary adjustments

  4. Once the PR is created:
    • Ensure all tests pass
    • Request review from maintainers
    • Address any feedback

Development

To develop on this repository:

  1. Fork this repository
  2. Make your changes
  3. Run tests if available
  4. Submit a pull request

Versioning

The charts in this repository follow Semantic Versioning. The version numbers are automatically updated by Renovate bot.

Security

Reporting Security Issues

If you discover a security issue, please bring it to our attention right away!

Please DO NOT file a public issue, instead send your report privately to security@platformnow.io.

Support

If you have any questions about this repository or its contents, please:

  1. Check the documentation
  2. Open a GitHub Issue

License

Apache 2.0 License.