Env

env is a string map passed to a component’s adapter operations.

components:
  smoke:
    type: script
    runner: local
    env:
      BASE_URL: "http://localhost:${web.outputs._meta.ports.services.web.80}"

Values are interpolated before execution. Ork warns when environment keys look like credential or access-mechanism values, but it still passes them through.

Default Runtime Variables

Ork adds a small set of runtime variables to every component execution environment.

ORK_WORKDIR is always available when an adapter command or lifecycle hook runs. It points at the component workdir on the runner for adapter operations, and at the selected hook workdir during hooks.

Variable	Available in	Description
ORK_ENV_ID	Adapter operations, hooks	Current Ork environment ID.
ORK_COMPONENT_NAME	Adapter operations, hooks	Current component name.
ORK_COMPONENT_TYPE	Adapter operations, hooks	Current component adapter type.
ORK_RUNNER_NAME	Adapter operations, hooks	Runner executing the component.
ORK_WORKDIR	Adapter operations, hooks	Component workdir on the runner.

Lifecycle hooks also receive:

Variable	Available in	Description
ORK_LIFECYCLE	Hooks	Hook phase, such as pre_apply or post_destroy.

Adapter-Specific Variables

Adapters may add their own environment variables.

Adapter	Variables
Script	ORK_OUTPUT_ENV, ORK_OUTPUT_JSON
Docker Compose	COMPOSE_PROJECT_NAME

See each adapter page for adapter-specific behavior.