Issue
- Now that the Liferay DXP image for a Liferay PaaS environment is set through the liferay/gradle.properties file in a 4.x+ workspace instead of in the liferay/LCP.json (as described here), how can I know that an image will be compatible/supported for use with Liferay PaaS?
- I only see one fix pack listed in the Version 4 Update Instructions of these service update notes, for example -- is this the only fix pack I can use with this Liferay PaaS stack?
Environment
- Liferay PaaS
- A 4.x.x+ workspace (either created as such, or upgraded from 3.x.x images using these instructions)
Resolution
-
As of version 4+, Liferay PaaS leverages two different images to build out the
liferayservice. One is built and delivered by the Liferay PaaS Services team -- this image is defined in the LCP.json and new versions can be found on the Services Changelog Page in Help Center. It looks like this:liferaycloud/liferay-dxp:7.4-5.8.1The other image is built and delivered on the Liferay DXP page on Docker Hub. It looks like this:
liferay/dxp:2024.q2.0-d5.0.60-20240612122920Any images fitting the syntax of this "liferay/" example (where the same major version of Liferay is used; i.e., 7.4 with Quarterly Releases, 7.3 with 7.3, etc.) can be used within a Liferay PaaS environment, as the included Liferay code base will match that from the fix packs available on our Downloads page. In this case, this is a 2024.Q2 Quarterly release image, which has the -d5.0.60 docker tag version.
- Please note that this excludes images that have
-develop,-rc, etc. included in the tag, as these are pre-release images and are not recommended for production.
Additional Information
- The docker tags on liferay/dxp include a `-dx.y.z` designation (e.g.
-d5.0.60), which provides information about any changes to the underlying docker scripts that are utilized by the image. The syntax of the image tags on Docker Hub for the official liferay/dxp images are formatted as follows (using a 7.2 bundle patched to dxp-8 as an example):liferay/dxp:{Liferay.DXP.Version}-{Patching-Level}-{Docker.Script.Version}-{Timestamp}
liferay/dxp:7.2.10-dxp-8-d1.1.0-202009221223When selecting which liferay/dxp base image to utilize for your project, please consider the entire docker tag (choosing one with a timestamp instead of a shortened, general tag), and be sure to review the DXP Release Notes (along with testing as suggested in this Recommended Patching Cycle documentation) for the desired patching level before applying new fix packs. Information about Docker script updates can be found in the DOCKER project on issues.liferay.com.
- More information can be found in the following related documentation: