Search documentation
karat

+

K

Recall ranges

After choosing a starting version, you will be prompted to specify a recall range.

The recall ranges dropdown.

This page describes the possible recall ranges in greater detail.

Open ended recall

Recall all Releases greater than or equal to the starting Release. This recall range includes both existing and future Releases.

One example is when you have not yet published a Release that resolves an issue and want to prevent other developers from accidentally publishing a Release with an existing known bug. Any Releases that are published to Apollo while you are working on a fixed Release will be recalled. After you publish a Release that resolves the issue, you can edit the recall and change the range to be a closed recall, so that Entities can roll forward to the newest Release.

Closed recall

Recall all Releases from the starting Release up to but not including another Release.

This range can be used when you know that a specific set of Releases contains an issue, but you have built a newer Release that does not contain the issue.

Exclude Releases from recall range

In some cases you may want to exclude Releases from an recall range.

This is useful when you backport a Release that fixes the issues. For example, you may discover an issue in all Releases starting at Release 1.2.0. You create an open ended recall so Apollo will not upgrade Entities to the Releases with the issue. Once you publish Release 1.5.0 that resolves the issue, you edit the recall to be a closed recall so that Entities can upgrade to Release 1.5.0. If Release 1.3.0 requires a specific fix, then you publish Release 1.3.1 that fixes the issue. Release 1.3.1 is in the recall range, but you can exclude it so Entities can receive that specific fix.

Exclude releases from recall range is selected.

Single recall

You can use this range to recall a single Release.

Apollo will use a single recall to automatically recall a Release when it discovers an issue during container vulnerability scanning.