WAF node versioning policy¶
This policy describes the method of versioning of different WAF node artifacts: Linux packages, Docker containers, Helm charts, etc. You can use this document to select the WAF node version for installation and to schedule installed packages update.
The artifact is the result of WAF node development that is used to install the WAF node on the platform. For example: Linux packages, Kong API modules, Docker containers, etc.
|WAF node version||Release date||Support until|
|2.10 and lower||May 2019|
|2.12||March 2019||November 2020|
WAF node artifact versions have the following format:
|Parameter||Description||Average release rate|
| ||Major WAF node version: ||No release expected|
| ||Minor WAF node version: ||2 times per year|
| ||WAF node patch version: ||Once a month|
| ||WAF node build version. The value is assigned automatically by the employed package build platform. The value will be not assigned to artifacts built using a manual process. |
The value increases by 1, for example:
|As new |
Versions of WAF node packages may differ within the same artifact. For example, if only one package needs to be updated, then the remaining packages retain the previous version.
Wallarm supports 2 latest versions of the WAF node in the following way:
In the latest version, releases bug fixes. May release new features after a special request.
In the previous version, releases bug fixes.
When installing a WAF node for the first time, it is recommended to use the latest available version. When installing an additional WAF node in the environment with already installed WAF nodes, it is recommended to use the same minor version in all installations for full compatibility.
It is assumed that you are using the latest available version of the WAF node when installing, updating, or configuring the product. The WAF node instructions describe commands that automatically install the latest available patch and build.
New version notification¶
Wallarm publishes information about the new minor version in the following sources:
Along with the release of the new WAF node minor version, installation instructions and instructions for current artifacts update are published. The methods of updating artifacts may differ. To update versions of artifacts, please use the appropriate instructions from the Updating and Migrating section.
After updating to a new minor version or patch version, all previous WAF node settings will be saved and applied to the new version.