Add a New Application

How to deploy a business application using the generic-deployment chart.

Kuberise.io includes a reusable generic-deployment Helm chart in charts/generic-deployment/ for deploying business applications (microservices).

1. Declare in app-of-apps

Add the application to app-of-apps/values.yaml:

ArgocdApplications:
  my-app:
    enabled: false
    path: charts/generic-deployment
    valuesFolder: applications
    namespace: my-team
    team: my-team
  • path — points to the generic-deployment chart (shared by all apps)
  • valuesFolder — tells ArgoCD to look in values/<cluster>/applications/ instead of values/<cluster>/platform/
  • namespace — the Kubernetes namespace for this app
  • team — label for team ownership

Enable it for your cluster:

# app-of-apps/values-onprem.yaml
ArgocdApplications:
  my-app:
    enabled: true

2. Add Values

Create the values file at values/defaults/applications/my-app/values.yaml:

image:
  repository: ghcr.io/my-org/my-app
  tag: latest

service:
  type: ClusterIP
  ports:
    http: 80

containerPorts:
  http: 8080

ingress:
  className: nginx-external

Add cluster-specific overrides if needed in values/<cluster>/applications/my-app/values.yaml.

3. Push and Sync

Push to Git. ArgoCD will create and sync the application.

Existing Examples

The repository includes several example applications you can reference:

ApplicationTraffic TypeDescription
show-envExternalHTTP container with external ingress
frontend-httpsExternalHTTPS container receiving TLS from ingress
backendInternalMicroservice with internal traffic only
apiInternalAnother internal microservice example
grpc-serverExternalgRPC service example