[master] bcd7d07aa upgrading 6.3: vcl auto state details
Nils Goroll
nils.goroll at uplex.de
Mon Feb 24 11:20:06 UTC 2020
commit bcd7d07aab281536dfa4f9f7e91877ad15a030d4
Author: Nils Goroll <nils.goroll at uplex.de>
Date: Mon Feb 24 12:19:27 2020 +0100
upgrading 6.3: vcl auto state details
diff --git a/doc/sphinx/whats-new/upgrading-6.3.rst b/doc/sphinx/whats-new/upgrading-6.3.rst
index df269e077..b813b9c44 100644
--- a/doc/sphinx/whats-new/upgrading-6.3.rst
+++ b/doc/sphinx/whats-new/upgrading-6.3.rst
@@ -14,7 +14,27 @@ features are listed in "Changes". Explicitly mention what does *not*
have to be changed, especially in VCL. May include, but is not limited
to:**
-TODO: a word on VCL temperature and the ``auto`` change.
+For users of many and/or labeled VCLs
+=====================================
+
+Users of the advanced mechanics behind the ``vcl.state`` CLI command
+(most likely used via ``varnishadm``) should be aware of the following
+changes, which may require adjustments to (or, more likely, allow for
+simplifications of) scripts/programs interfacing with varnish:
+
+The VCL ``auto`` state has been streamlined. Conceptually, it used to
+be a variant of the ``warm`` state which would automatically cool
+the vcl. Yet, cooling did not only transition the temperature, but
+also the state, so ``auto`` only worked one way - except that
+``vcl.use`` or moving a label (by labeling another vcl) would also set
+``auto``, so a manual warm/cold setting would get lost.
+
+Now the ``auto`` state will remain no matter the actual temperature or
+labeling, so when a vcl needs to implicitly change temperature (due to
+being used or being labeled), an ``auto`` vcl will remain ``auto``,
+and a ``cold`` / ``warm`` vcl will change state, but never become
+``auto`` implicitly.
+
For developers and authors of VMODs and API clients
===================================================
More information about the varnish-commit
mailing list