Skip to content

Environment variables overview

Olares apps use app-service to inject runtime context and configuration into the app's values.yaml. In Helm templates, you can reference these values via .Values.*.

Variables and Helm values

In this document, "variables" mainly refer to Helm values. They are not automatically passed into container environment variables. If you need them inside containers, explicitly map them to env: in your templates.

How variables are injected

Olares injects variables through two channels:

  • Declarative environment variables: The developer declares variables under envs in OlaresManifest.yaml. At deployment, app-service resolves and injects the values into .Values.olaresEnv in values.yaml.

  • System-injected runtime variables: Injected automatically by Olares at deployment time. No declaration is required, though some values are only available after you declare the relevant dependency, such as middleware.

Next steps

  1. Declarative environment variables: Field reference for the envs schema, including variable mapping and variable references.
  2. System-injected runtime variables: Full reference for all system-injected runtime variables.