CorefinityCorefinityDocs
Open the Control PanelControl Panel
Varnish · 3 of 12

corestack_varnish_version_change

Change a site's Varnish version.

Scope writeRuns as a taskNo secrets returnedCoreCluster
On this page

When to use it

Change the Varnish version of a Magento 2 row while Varnish is on, up or down. Read corestack_varnish_get first: only versions in options[] with allowed: true are accepted, and recommended marks the version Adobe certifies for the installed Magento patch.

Before anything changes, the row's saved custom VCL is compiled against the target version; if it does not compile, nothing changes and the refusal lists each problem with its hook, line and column (fix the VCL with corestack_varnish_vcl_validate and corestack_varnish_vcl_update, passing varnish_version to validate against the target). Then one line of the site's settings changes, Varnish is rolled to the new version and the quick cache check runs. The cache starts empty, so the first requests for each page go to Magento.

The change takes about a minute and answers a task on its varnish_version operation (follow it with corestack_site_operation_get). With apply: window it waits for the row's next maintenance window and answers at once {operation: null, queued: true, window_date, item_id, window}; the VCL is compiled again when the window opens. While Varnish is off, choose the version as you switch it on: corestack_varnish_set with version.

Ask for it

Prompt
Using the Corefinity MCP server, call corestack_varnish_version_change with site_id 4211, to 8.0, acknowledge ["eol"]. (Change a site's Varnish version.) Tell me what it returned.

Inputs

acknowledgearray of strings

Required when the target's status is eol (end of life upstream; Corefinity keeps its image patched). Up to 1 items.

eol
applystring

Now (the default), or in the row's next maintenance window. Defaults to now.

nowwindowtonight
site_idintegerRequired

The row, a Magento 2 site or one of its environments. At least 1.

tostringRequired

The version, such as 8.0.

Example call

tools/call
{
  "name": "corestack_varnish_version_change",
  "arguments": {
    "site_id": 4211,
    "to": "8.0",
    "acknowledge": [
      "eol"
    ]
  }
}

If it is refused

ReasonWhat to do
varnish_offVarnish is switched off; switch it on with corestack_varnish_set and version.
version_unsupportedThe version is not allowed for this Magento; the message names the offered versions.
vcl_incompatibleThe saved VCL does not compile on the target; details.diagnostics lists {hook, line, column, severity, kind, message}. Nothing changed.
not_availableThis row's Varnish version cannot be managed from here; contact support.
temporarily_unavailableThe compile check could not run just now; try again in a minute.
change_in_progressOr busy: another change on the row is unfinished; change_pending: a change waits for the window.
invalid_argumentsAn eol target without acknowledge: ["eol"], or a malformed input; fields names the argument.
managed_elsewhereAnother control panel manages this site, so use that control panel for it. This is refused before anything else about the site, as in the Control Panel and the API. Nothing was done.
tenant_mismatchThe object does not exist or the token may not see it. Check the id.
scope_requiredThe token lacks a scope this call needs. Open the link in the answer to add it, then call again.
pin_refusedThe grant is limited to chosen clusters, sites or environments, and this call is outside them. Open the link in the answer to widen it.
rate_limitedToo many calls. Wait for the number of seconds the answer names.
internal_errorSomething went wrong on our side. Quote the trace id to support.

The same task elsewhere

Was this helpful?
Open in ClaudeOpen in ChatGPT