addons/
└── <app-name>/
    ├── .config/
    │   └── <app-name>.yaml         # App configuration (REQUIRED)
    ├── <app-name>.app.yaml         # ArgoCD Application definition (REQUIRED)
    ├── kustomization.yaml          # Kustomize manifest (REQUIRED)
    ├── values-default.yaml         # Default Helm values (if using Helm)
    ├── values-override.yaml        # Template for env-specific overrides (if using Helm)
    ├── vs.yaml                     # Virtual Service for ingress (optional)
    ├── <resource>.yaml             # Additional K8s resources
    ├── README.md                   # Documentation (recommended)
    └── <subfolder>/                # Optional: misc files without templating

addons/
├── app-yamls/
│   └── <app-name>.yaml            # ArgoCD Application (OLD - deprecated)
├── default.yaml                   # Global configuration (OLD - deprecated)
└── <app-name>/
    ├── kustomization.yaml
    ├── deployment.yaml
    └── ...

mkdir -p <app-name>/.config
cd <app-name>

<app-name>/
├── .config/
│   └── <app-name>.yaml      # Start here
├── <app-name>.app.yaml      # Then create this
├── kustomization.yaml       # Then this
└── ... other resources

undefined

**Common configuration fields:**
- `enabled`: Boolean to enable/disable the app
- `version`: Helm chart version (if using Helm)
- `tag`: Docker image tag (if using plain manifests)
- `namespace`: Kubernetes namespace for deployment
- `syncWave`: ArgoCD sync wave for ordering (-1 for infrastructure, 0 for apps, 99+ for tests)
- `values`: Hash for Helm chart value overrides
- `image`: Full image reference (for non-Helm deployments)

**Examples from existing addons:**

```yaml

```yaml

```yaml

undefined

undefined

**Key elements:**
- `path`: Points to the addon's app directory
- `repoURL`: Uses `${cluster.gitlabProjectUrl}` template variable
- `destination.namespace`: Uses `${app.namespace}` template variable
- `syncWave`: Uses `${app.syncWave}` template variable
- `syncPolicy.automated`: Enables auto-sync and self-healing
- `syncOptions`: Common options for namespace creation and pruning

apiVersion: kustomize.config.k8s.io/v1beta1
kind: Kustomization
resources:
  - vs.yaml                    # Optional: if app has ingress
  - <additional-resources>.yaml
helmCharts:
  - name: <chart-name>
    releaseName: <release-name>
    version: ${app.version}
    repo: https://<chart-repo-url>
    valuesFile: values-default.yaml
    namespace: <app-name>
    includeCRDs: true
    additionalValuesFiles:
      - values-override.yaml

apiVersion: kustomize.config.k8s.io/v1beta1
kind: Kustomization
resources:
  - vs.yaml
  - k6-test-als-configmap.yaml
  - kronic.yaml
helmCharts:
  - name: k6-operator
    releaseName: k6-operator
    version: ${app.version}
    repo: https://grafana.github.io/helm-charts
    valuesFile: values-default.yaml
    namespace: k6
    includeCRDs: true
    additionalValuesFiles:
      - values-override.yaml

apiVersion: kustomize.config.k8s.io/v1beta1
kind: Kustomization
resources:
  - deployment.yaml
  - service.yaml
  - vs.yaml
  - external-secret.yaml
  - pvc.yaml
configMapGenerator:
  - name: <app-name>
    files:
      - config-file.conf

apiVersion: kustomize.config.k8s.io/v1beta1
kind: Kustomization
resources:
  - deployment.yaml
  - external-secret.yaml
  - password-policy.yaml
  - pvc.yaml
  - random-secret.yaml
  - service.yaml
  - vault-secret.yaml
  - vs.yaml
configMapGenerator:
  - name: cloud-beaver
    files:
      - cloudbeaver.conf
      - initial-data-sources.conf

undefined

**Example (chaosmesh):**
```yaml
chaosDaemon:
  runtime: containerd
  socketPath: /var/snap/microk8s/common/run/containerd.sock

image:
  tag: ${app.tag}

resources:
  limits:
    cpu: 200m
    memory: 256Mi
  requests:
    cpu: 50m
    memory: 64Mi

serverBlock: |-
  server {
    listen 8080;
    server_name _;
    location / {
      root /app;
      index index.html;
    }
  }

undefined

undefined

apiVersion: networking.istio.io/v1alpha3
kind: VirtualService
metadata:
  name: <app-name>
spec:
  gateways:
    - istio-ingress-int/internal-wildcard-gateway
  hosts:
    - <app-name>.int.${cluster.env}.${cluster.domain}
  http:
    - match:
        - uri:
            prefix: /
      route:
        - destination:
            host: <app-name>
            port:
              number: 80

apiVersion: apps/v1
kind: Deployment
metadata:
  name: <app-name>
  labels:
    app: <app-name>
spec:
  replicas: 1
  selector:
    matchLabels:
      app: <app-name>
  template:
    metadata:
      labels:
        app: <app-name>
    spec:
      containers:
        - name: <app-name>
          image: ${app.image}
          imagePullPolicy: IfNotPresent
          resources:
            limits:
              cpu: 1000m
              memory: 256Mi
            requests:
              cpu: 100m
              memory: 128Mi
          ports:
            - containerPort: 8080
              name: http

apiVersion: v1
kind: Service
metadata:
  name: <app-name>
spec:
  selector:
    app: <app-name>
  ports:
    - name: http
      port: 80
      targetPort: 8080
  type: ClusterIP

apiVersion: v1
kind: PersistentVolumeClaim
metadata:
  name: <app-name>
spec:
  accessModes:
    - ReadWriteOnce
  resources:
    requests:
      storage: 10Gi

undefined

undefined

undefined

**Deployment testing:**

1. Push addon to git repository
2. Enable in environment: Create `custom-config/<app-name>.yaml` with `enabled: true`
3. Sync ArgoCD app-of-apps
4. Monitor deployment: `kubectl get applications -n argocd`
5. Check app status: `kubectl get all -n <namespace>`

mongo-express/
├── .config/
│   └── mongo-express.yaml       # Configuration here
├── mongo-express.app.yaml       # App definition here
├── kustomization.yaml
├── deployment.yaml
├── service.yaml
├── vs.yaml
└── README.md

app-yamls/
└── mongo-express.yaml           # App definition (OLD location)
default.yaml                     # Configuration (OLD location)
mongo-express/
├── kustomization.yaml
├── deployment.yaml
└── service.yaml