Alucard Helm Charts

Nothing lasts forever, we can change the future.

Overview

Welcome to Alucard the Universal Helm Chart repository! This Helm Chart is designed to provide a flexible and customizable solution for deploying applications on Kubernetes. It supports various features, including custom volume mounting, secret mounting, multiple ingress hosts and paths, and more.

Features

Custom Volume Mounting: Easily attach custom volumes to your pods for persistent data storage.
Secret Mounting: Securely inject secrets into your application through Kubernetes secrets.
Multiple Ingress Configuration: Define multiple ingress hosts and paths for better routing and accessibility.
Configurable Options: Fine-tune your deployment with a wide range of customizable options and parameters.
Scalability: Scale your application horizontally by adjusting replica counts and resource allocations.
Compatibility: Works seamlessly with different Kubernetes distributions and cloud providers.

Prerequisites

Helm installed on your Kubernetes cluster.

Installation

helm repo add alucard https://sithanos.github.io/alucard/stable/  
helm repo update
helm install my-alucard alucard/alucard [--version=1.0.0]

Configuration

The Helm Chart provides extensive configuration options to tailor the deployment to your specific needs. Review the values.yaml file for a comprehensive list of available parameters.

Example:

helm install my-alucard  alucard/alucard -f my-values.yaml

Usage

Describe how users can customize and use your Helm Chart in their own projects. Provide examples and best practices for configuration.

Parameters

Common Parameters

gracePeriodSeconds Configuration Parameters

secrets Configuration Parameters

volume Configuration Parameters

For set up service account or volume, sometimes pair with volumeMounts |Name|Description|Value| | —— | —— | —— | |volume.name |Volume name|| |volume.secret.secretName |If want to mount secret|alucard-sa| |volume.persistentVolumeClaim.claimName |If want to mount volume|volumes-pvc|

volumeMounts Configuration Parameters

|Name|Description|Value| | —— | —— | —— | |volumeMounts.name |volumeMounts name|| |volume.mountPath |Path for volume inside container|/data|

liveness Configuration Parameters

service Configuration Parameters

|Name|Description|Value| | —— | —— | —— | |service.type |type of service|ClusterIP| |service.configs|config for service|| |service.headless |enable headless if app service use GRPC protocol|false|

imagePullSecrets Configuration Parameters

image Configuration Parameters

interceptor Configuration Parameters

migrations Configuration Parameters

autoscaling Configuration Parameters

resources Configuration Parameters

resources Configuration Parameters

|Name|Description|Value| | —— | —— | —— | |ingress.enabled |enabled ingress |false| |ingress.config |ingress config ||

annotations Configuration Parameters

|Name|Description|Value| | —— | —— | —— | |annotations.ingress |add annotation for ingress|| |annotations.deployment |add annotation for deployment|| |annotations.hpa |add annotation for deployment|| |annotations.preupgradejob |add annotation for preupgradejob|| |annotations.serviceaccount |add annotation for serviceaccount|| |annotations.vault |add annotation for vault||

hostAliases Configuration Parameters

|Name|Description|Value| | —— | —— | —— | |hostAliases|add hostaliases for dns local||

Example Deployments

# Example values.yaml
image:
  repository: "alucard-example" 
  tag: "stable"
fullnameOverride: "alucard-example"
nameOverride: "alucard-example"
namespace: alucard
replicaCount: 1
service:
  type: ClusterIP
  configs:
    - name: http
      port: 80
      targetPort: 6969
      protocol: TCP
    - name: grpc
      port: 4054
      targetPort: 4053
      protocol: TCP
  headless: true
liveness:
  type: exec
  port: 4054
migrations:
  enabled: true
  type: init-container
  args:
  - "cd /go/src/alucard-example && ./main db:migrate"
secrets:
  configs:
    enabled: true
    autorestart:
      enabled: true
    path: secrets/configs/alucard-example
  creds:
    enabled: true
    autorestart:
      enabled: true
    path: secrets/creds/alucard-example
volumes:
  - name: service-account
    secret:
      secretName: alucard-example-sa
volumeMounts:
  - name: service-account
    mountPath: /mnt
resources: 
  limits:
    cpu: 300m
    memory: 500Mi
  requests:
    cpu: 200m
    memory: 384Mi
autoscaling:
  enabled: false
  minReplicas: 1
  maxReplicas: 2
  averageUtilMem: 80
  averageUtilCpu: 80
ingress:
  enabled: true
  configs:
  - ingressName: "internal-ingress"
    className: "internal-nginx"
    rules:
      - host: alucard.thanos.my.id
        http:
          paths:
            - path: /rc(?:\/|$)(.)
              pathType: Prefix
              backend:
                service:
                  name: rc-alucard
                  port:
                    number: 80
  - ingressName: "external-ingress"
    className: "internal-nginx"
    rules:
      - host: alucard.thanos.my.id
        http:
          - path: /(.)
            pathType: Prefix
            backend:
              service:
                name: alucard
                port:
                  number: 80

Contributing

We welcome contributions! If you find a bug or have an idea for improvement, please open an issue or submit a pull request.

License

This project is licensed under the MIT License.

Remember to replace the placeholder URLs, names, and images with your actual details. Customize the sections as needed for your specific Helm Chart.