helm-charts/rallly/values.yaml

# Scale the whole chart down without uninstalling it: scaleDown: true renders
# every Deployment/StatefulSet with replicas: 0 (and suspends CronJobs) and
# takes precedence over any per-workload replicas value. PVCs, Secrets and
# Services stay in place; scaleDown: false brings the workloads back up.
scaleDown: false

secrets:
  ralllySecretRef: null
  oidcSecretRef: null
  databaseSecretRef: null
  smtpSecretRef: null

rallly:
  # Replica count for this workload; 0 is allowed and scales it down.
  # The chart-global scaleDown flag takes precedence.
  replicas: 1
  smtp:
    enabled: false
    # Verify the mail server's TLS certificate (passed to the app as
    # SMTP_REJECT_UNAUTHORIZED). Leave this at true.
    #
    # Set it to false ONLY for a mail server with a self-signed certificate.
    # Without that hint the symptom is misleading: the send fails with a
    # certificate error naming the mail server, so the search starts at the
    # mail server or its CA chain rather than at this value.
    #
    # false disables the certificate check entirely and exposes the SMTP
    # session to a man-in-the-middle; prefer trusting the CA over setting it.
    rejectUnauthorized: true
  allowedEmails: '*'
  supportEmail: null
  oidc:
    name: 'OIDC'
    pictureClaimPath: 'picture'
    emailClaimPath: 'email'
    nameClaimPath: 'name'
  # Next.js writes its cache below the app directory (prerendered/ISR pages and
  # the optimized images of /_next/image). The container runs as uid 20000
  # while /app belongs to the image's own "nextjs" user, so that path is not
  # writable for the app even without readOnlyRootFilesystem — the chart mounts
  # a writable volume over it. The pod's fsGroup (1000) is what makes the
  # mounted volume group-writable for the container.
  #
  # Deliberately an emptyDir, not a PVC: the cache is volatile. After every pod
  # restart it starts out empty and Next.js rebuilds it on demand, which costs
  # a little time on the first request after a restart. That is correct for a
  # cache — its entries are derived data tied to the build id of the image, so
  # a persistent volume would only carry stale entries across app updates.
  cache:
    # Mount path of the cache volume. Matches the Next.js cache directory of
    # the upstream image; only needs changing if the image layout changes.
    path: /app/apps/web/.next/cache
    # Optional upper bound for the emptyDir, e.g. 512Mi. Unset means the volume
    # is only bounded by the container's ephemeral-storage limit (computed as
    # limitFactor x request, see resources below) — note that emptyDir usage
    # counts against that limit, and exceeding either bound evicts the pod.
    sizeLimit: null
  securityContext:
    pod:
      runAsNonRoot: true
      runAsUser: 20000
      runAsGroup: 1000
      fsGroup: 1000
      fsGroupChangePolicy: Always
      # RuntimeDefault applies the container runtime's default seccomp filter,
      # which blocks the syscalls a normal workload never makes. It sits in the
      # pod context on purpose: from here it covers every container in the pod
      # including init containers, while a container-level seccompProfile would
      # have to be repeated for each one (and silently missed on the next one
      # added). A container that genuinely needs a different filter can still
      # override it under securityContext.container, which wins over this value.
      seccompProfile:
        type: RuntimeDefault
    container:
      allowPrivilegeEscalation: false
      readOnlyRootFilesystem: true
      runAsNonRoot: true
      # No capabilities are added: the app is a plain Node process listening on
      # the unprivileged port 3000, verified to run with all capabilities
      # dropped. Do not reintroduce an "add:" key here — an empty list item
      # under it renders as a null entry, which is what Trivy reported as
      # AVD-KSV-0022 for the older chart version deployed in the cluster (#84).
      capabilities:
        drop:
          - ALL
  # Extra environment variables, appended to the ones the chart always sets.
  # Values are rendered through tpl; value, secretKeyRef and configMapKeyRef
  # forms are supported.
  env: []
  resources:
    # Limits are optional: memory and ephemeral-storage limits default to
    # limitFactor x the request, an explicitly set limit always wins, and a
    # CPU limit is only set when configured explicitly under "limits".
    limitFactor: 3
    requests:
      cpu: 0.1
      memory: 512Mi
      ephemeral-storage: 100Mi
  livenessProbe:
    httpGet:
      path: /
      port: http
    periodSeconds: 10
    timeoutSeconds: 5
    failureThreshold: 3
  readinessProbe:
    httpGet:
      path: /
      port: http
    periodSeconds: 10
    timeoutSeconds: 5
    failureThreshold: 3
  # The startup probe gates liveness/readiness, so those need no initialDelaySeconds.
  # Startup budget = periodSeconds * failureThreshold = 150s.
  startupProbe:
    httpGet:
      path: /
      port: http
    periodSeconds: 5
    timeoutSeconds: 5
    failureThreshold: 30

ingress:
  # Set to false to omit the Ingress entirely. Note that ingress.domain stays
  # required even then: it is also the app's public base URL
  # (NEXT_PUBLIC_BASE_URL), not just the Ingress host. Only clusterIssuer
  # becomes unnecessary.
  #
  # Mutually exclusive with httpRoute.enabled below (Gitea #114): with both
  # true the render aborts, naming both values.
  enabled: true
  clusterIssuer: null
  # The public hostname of this release. Read by the Ingress, by
  # NEXT_PUBLIC_BASE_URL, and - when httpRoute.hostnames is empty - by the
  # HTTPRoute. Required in every mode (see above).
  domain: null
  className: nginx
  # Extra annotations for the Ingress; merged with the cert-manager
  # cluster-issuer annotation the chart always sets.
  #
  # THESE HAVE NO COUNTERPART IN GATEWAY MODE. The Gateway API has no
  # annotation channel for controller behaviour, so anything configured here is
  # simply gone when httpRoute.enabled is used instead - it is then the
  # Gateway's business, or that of an implementation-specific policy object
  # this chart deliberately does not render. Nothing this chart needs lives
  # here by default.
  annotations: {}

# Gateway-API alternative to the Ingress above (Gitea #114). Off by default, so
# an existing release is unaffected; exactly one of ingress.enabled and
# httpRoute.enabled may be true.
#
# The chart renders ONLY an HTTPRoute with parentRefs - no Gateway, no
# gatewayClassName, no Certificate and no implementation-specific policy
# object. Class and certificate belong to the Gateway and therefore to the
# platform, which is what keeps this chart independent of whether the cluster
# runs nginx-gateway-fabric, Cilium, Envoy Gateway or Istio.
#
# The Gateway-API CRDs must be installed in the cluster: the chart does not and
# cannot detect them (.Capabilities.APIVersions is unreliable at template
# time), so with httpRoute.enabled: true and no CRDs the INSTALL fails.
httpRoute:
  enabled: false
  # The Gateway(s) this route attaches to - a platform object, usually in
  # another namespace, which must allow this namespace in its listener's
  # allowedRoutes. One entry per parent, the fields are the Gateway API's
  # ParentReference (name, and optionally namespace, sectionName, port, group,
  # kind), passed through unchanged:
  #
  #   parentRefs:
  #     - name: public
  #       namespace: gateway
  #       sectionName: https
  #
  # REQUIRED while httpRoute.enabled is true - the render aborts on an empty
  # list, because a route without a parent is created, is valid and routes
  # nothing, with no event to say so.
  parentRefs: []
  # Empty means [ingress.domain], so the hostname has one source of truth. Set
  # explicitly only to publish under a different or an additional name - which
  # is how a migration from the Ingress runs: the HTTPRoute takes a second
  # hostname while the Ingress keeps ingress.domain.
  #
  # For THIS chart, mind that a second hostname does not move
  # NEXT_PUBLIC_BASE_URL with it, and that the OIDC redirect URI registered at
  # the provider is built from ingress.domain - a new name needs both sides
  # updated or logins fail on a redirect-uri mismatch while the pod stays green.
  hostnames: []