Skip to content
Crow CI

Autoscaler

Autoscaler configuration variables.

LOG_LEVEL

Section titled “LOG_LEVEL”
  • Name: CROW_LOG_LEVEL
  • Description: default log level
  • Default: info

RECONCILIATION_INTERVAL

Section titled “RECONCILIATION_INTERVAL”
  • Name: CROW_RECONCILIATION_INTERVAL
  • Description: interval at which the autoscaler will reconsider a scale up/down
  • Default: 1m

POOL_ID

Section titled “POOL_ID”
  • Name: CROW_POOL_ID
  • Description: id of the autoscaler pool
  • Default: 1

AGENT_INACTIVITY_TIMEOUT

Section titled “AGENT_INACTIVITY_TIMEOUT”
  • Name: CROW_AGENT_INACTIVITY_TIMEOUT
  • Description: time an agent is allowed to be inactive before it can be terminated as duration string like 2h45m
  • Default: 10m
  • Synonyms:
    • CROW_AGENT_ALLOWED_STARTUP_TIME
    • CROW_AGENT_SERVER_CONNECTION_TIMEOUT

AGENT_IDLE_TIMEOUT

Section titled “AGENT_IDLE_TIMEOUT”
  • Name: CROW_AGENT_IDLE_TIMEOUT
  • Description: time an agent is allowed to be idle before it can be terminated as duration string like 2h45m
  • Default: 10m

FILTER_LABELS

Section titled “FILTER_LABELS”
  • Name: CROW_FILTER_LABELS
  • Description: only count queued tasks matching these labels toward scaling decisions. Format: a comma-separated list of key=value pairs (e.g. tier=heavy,arch=arm64); a task must match all of them. Required when running multiple autoscalers to prevent each autoscaler from scaling for tasks meant for another.
  • Default: none (all pending tasks are counted)
  • Synonyms:
    • WOODPECKER_FILTER_LABELS

AGENT_ENV

Section titled “AGENT_ENV”
  • Name: CROW_AGENT_ENV
  • Description: environment variables passed to spawned agents, as a comma-separated list of KEY=value pairs (e.g. CROW_LOG_LEVEL=debug,CROW_HEALTHCHECK=false). Agent labels are configured here through CROW_AGENT_LABELS, whose value is itself a comma-separated list of key=value labels. Because CROW_AGENT_ENV is also comma-separated, the autoscaler reassembles a multi-label CROW_AGENT_LABELS value: CROW_AGENT_ENV=CROW_AGENT_LABELS=tier=heavy,gpu=true is read as the two labels tier=heavy and gpu=true rather than dropping gpu. For this to work, label keys must be lower-case — env var names are upper-case, which is how the two are told apart.
  • Default: none
  • Synonyms:
    • WOODPECKER_AGENT_ENV

AGENT_IMAGE

Section titled “AGENT_IMAGE”
  • Name: CROW_AGENT_IMAGE
  • Description: container image used for spawned agents. When not set, the autoscaler automatically uses the agent image matching the Crow server version (e.g. codefloe.com/crowci/crow-agent:<version>).
  • Default: auto-detected from server version
  • Synonyms:
    • WOODPECKER_AGENT_IMAGE

PLUGINS_PRIVILEGED

Section titled “PLUGINS_PRIVILEGED”
  • Name: CROW_PLUGINS_PRIVILEGED
  • Description: List of plugin images allowed to run in privileged mode. Matching is controlled by CROW_PLUGINS_PRIVILEGED_MATCH_TYPE.
  • Default: none

PLUGINS_PRIVILEGED_MATCH_TYPE

Section titled “PLUGINS_PRIVILEGED_MATCH_TYPE”
  • Name: CROW_PLUGINS_PRIVILEGED_MATCH_TYPE
  • Description: Type of match for privileged plugins. Possible values are semver, semver-range, regex, or exact. Controls how entries in CROW_PLUGINS_PRIVILEGED are matched against plugin images.
  • Default: semver