Codefresh: undefined variables silently stay as literal text

TL;DR

To branch on existence, use the documented includes() pattern comparing the raw reference against its expanded form.

Steps

1. Treat every ${{...}} reference as guilty until proven defined: declare variables in the pipeline or environment before use. To branch on existence, use the documented includes() pattern comparing the raw reference against its expanded form. When debugging a weird literal showing up in logs or commands, search the pipeline for a variable name that was renamed or never set; Codefresh will not warn you.

When to use

You are seeing this: Treat every ${{...}} reference as guilty until proven defined: declare variables in the pipeline or environment before use. Use this skill when you run into "Codefresh: undefined variables silently stay as literal text".

When not to use

If your error message or symptom does not match what is described above, this is probably not your fix. Search for your exact error text instead of forcing this one to fit.

Versions

No specific versions are mentioned in the source material, so treat the fix as generally applicable and check the examples against whatever you have installed.

Why this happens

The original report does not dig into a root cause. It documents the symptom and the fix that resolved it.

Source: Official docs (Codefresh conditional step execution): documents the silent-failure gotcha that trips agents generating codefresh.yml. Referencing a variable that does not exist is not an error; the engine leaves the literal ${{MY_VAR}} string in the pipeline, so a command can run with the placeholder text instead of a value and fail in confusing ways downstream.

Verified resolution: Treat every ${{...}} reference as guilty until proven defined: declare variables in the pipeline or environment before use. To branch on existence, use the documented includes() pattern comparing the raw reference against its expanded form. When debugging a weird literal showing up in logs or commands, search the pipeline for a variable name that was renamed or never set; Codefresh will not warn you.

Source URL: https://github.com/codefresh-io/docs.codefresh.io/blob/HEAD/_docs/pipelines/conditional-execution-of-steps.md