HelmIngressKit

HelmIngressKit is a Helm chart designed to deploy a Node.js (or any web-based) microservice on AWS EKS with an ALB (Application Load Balancer) ingress.

Features

• Deploys a containerized web service to EKS.
• Configures AWS ALB ingress with SSL and health checks.
• Supports private image registries via imagePullSecrets.
• Fully customizable through values.yaml.

Prerequisites

Before using this chart, ensure you have:

• Kubernetes cluster on AWS EKS.
• Helm 3 installed.
• AWS Load Balancer Controller configured.
• An ACM certificate for HTTPS (if SSL is enabled, AWS SSL ARN).

Installation

1. Add the Helm repository

helm repo add helmingresskit https://charts.amitdalal.com/
helm repo update

2. Install the chart

helm install my-release helmingresskit/HelmIngressKit -f values.yaml

Replace my-release with your preferred release name.

OPTIONAL: if you want to check the values.yaml (or just want to view it)

helm show values helmingresskit/HelmIngressKit > values.yaml   #To save in a file

helm show values helmingresskit/HelmIngressKit                 #To view on the fly

Configuration

Modify the values.yaml file to customize the deployment. Below are key configurations:

Replica Count

Set the number of instances for high availability:

replicaCount: 2

Image Settings

Define the container image and tag:

image:
  repository: registry.gitlab.com/your-repo/eks-play
  tag: latest

Ingress Settings

Configure ALB ingress for external access:

ingress:
  enabled: true
  host: <your-domain>
  path: /graphql
  annotations:
    alb.ingress.kubernetes.io/scheme: "internet-facing"
    alb.ingress.kubernetes.io/certificate-arn: "<your-acm-arn>"

Example Usage

A complete example of using this Helm chart with custom values:

helm upgrade --install my-release helmingresskit/HelmIngressKit \
  --namespace $KUBE_NAMESPACE \
  --set image.repository=$REGISTRY \
  --set image.tag=$IMAGE_TAG \
  --set ingress.host=$DOMAIN_NAME \
  --set ingress.annotations.alb\.ingress\.kubernetes\.io/certificate-arn=$SSL_CERT_ARN

Upgrade

To upgrade to a new version:

helm upgrade my-release helmingresskit/HelmIngressKit -f values.yaml

Uninstall

To remove the deployment:

helm uninstall my-release

License

This Helm chart is open-source and available under the MIT license.

Contributing

Feel free to open issues or pull requests to improve HelmIngressKit!

How to Contribute

1. Fork the repository.
2. Create a feature branch.
3. Commit your changes.
4. Open a pull request with detailed information about your changes.

For issues or feature requests, please open an issue.

This site is open source. Improve this page.