Service Updates for Liferay Cloud Version 3 and 4

The services update to 2020.26.1 includes updates to Backup, CI, and Liferay services.

Version Compatibility between 3 and 4

For details on service compatibility between version 3 and 4 please see release update 6/11/2020 Services Update 2020.24.1 or 5/28/2020 Services Update 2020. 22.1

 

Using a Private Server for BitBucket and GitLab: 

In order to use a private server for your scm integration with the CI service, you must set the following environment variables for the CI service (using gitlab as an example):

LCP_CI_SCM_PROVIDER: "gitlab"
LCP_CI_SCM_SERVER_HOST: "http://private.gitlab.server.com/"

This will set the server url that the CI uses to pull in the codebase using git checkout. The default value of the server url is generated based on the public url syntax for your chosen provider.

Default Webserver Properties

The Webserver service in your project uses https, and specifies a hostname for you based on your service Id. As of Liferay service 4.0.1, the portal properties associated with the web server endpoint are now set by default to the expected host of the Webserver service.

The following properties will be specified in the portal-bundle.properties file:

web.server.host=webserver-{environment}.lfr.cloud
web.server.protocol=https
web.server.https.port=443

These may be overridden by specifying them through portal-ext.properties (or another properties file that is loaded by your project). If you have specified a custom domain for your Webserver service, which is most likely the case, you should already be specifying the correct host using web.server.host portal property.

There are use cases that require the web server properties to not be specified. If this is the case for your project please set the following in portal-all.properties

web.server.host=
web.server.protocol=
web.server.https.port=-1

Version 4 DXP Stack 2020.26.1 

Service Name	Previous Release	Current Release	Docker Images
Backup	4.0.1	4.0.2	liferaycloud/backup:4.0.2
CI	4.0.1	4.0.2	liferaycloud/jenkins:2.222.1-4.0.2
Database	4.0.1	4.0.1	liferaycloud/database:4.0.1
Liferay	4.0.0	4.0.1	liferaycloud/liferay-dxp:7.2-4.0.1 liferaycloud/liferay-dxp:7.1-4.0.1 liferaycloud/liferay-dxp:7.0-4.0.1
Search	4.0.0	4.0.0	liferaycloud/elasticsearch:6.8.6-4.0.0 liferaycloud/elasticsearch:2.4.6-4.0.0
Webserver	4.0.0	4.0.0	liferaycloud/nginx:1.16.1-4.0.0

 

 Version 4 Update Instructions

Only Applicable to Version 4 Images

After upgrading your project using this guide, the Liferay Cloud image versions are no longer set inside of the gradle.properties file. They now need to set inside of the service/LCP.json file. However, the liferay service uses two image properties. The DXP Cloud image is set in the liferay/LCP.json file, but the liferay/dxp image is set in the gradle.properties. This change was made in order to facilitate easier deployment using the Liferay Cloud CLI.

liferay/LCP.json file would set the liferaycloud/liferay-dxp image:

"image":"liferaycloud/liferay-dxp:7.2-4.0.1"

lfieray/gradle.properties file would set the liferay/dxp image:

liferay.workspace.docker.image.liferay=liferay/dxp:7.2.10-dxp-6-202006221121 

Once the LCP.json files are updated, commit the changes to your Git repository.

git add . && git commit -m "update dxp cloud stack to 2020.26.1"

After pushing these changes to the remote repository, a build will be created in Liferay Cloud and it is ready to deploy.

Version 4 Change Log

Service Name	Service Version	Ticket Number	Description
Backup	4.0.2	LCPE-1339	cancelled connections with backup upload or download are not logged
		LCP-6931	empty folder is copied into the backup on restore causing intermittent restore failure
CI	4.0.2	LCPE-1374	integrate with a private Gitlab and BitBucket domain
		LCPE-1458	git checkout error when repository requires git-lfs support
		LCP-6635	Unwanted 'github' credential is left when upgrading past Jenkins 3.2.0
		LCP-6948	OSGI wars are not copied from the right location in CI build process
Liferay	4.0.1	LCPE-1321	Set default webserver properties
		LCP-6850	liferay service startup fails when project secrets are undefined
		LCP-6925	incorrect cloud monitoring configuration results in liferay service startup failure

 

Version 3 DXP Stack 2020.24.1 

Service Name	Previous Release	Current Release	Docker Images
Backup	3.2.13	3.2.14	liferaycloud/backup:3.2.14
CI	3.2.5	3.2.6	liferaycloud/jenkins:2.222.1-3.2.6
Database	3.2.10	3.2.10	liferaycloud/database:3.2.10
Liferay	3.0.23	3.0.24	liferaycloud/liferay-dxp:7.2.10-sp1-fp5-3.0.24 liferaycloud/liferay-dxp:7.1.10-ga1-fp17-3.0.24 liferaycloud/liferay-dxp:7.0.10-ga1-fp91-3.0.24
Search	3.0.8	3.0.8	liferaycloud/elasticsearch:6.8.6-3.0.8 liferaycloud/elasticsearch:2.4.6-3.0.8
Webserver	3.2.0	3.2.0	liferaycloud/nginx:1.16.1-3.2.0

 

Version 3 Update Instructions

To apply these updates, update the gradle.properties file the project root folder with the new docker image tags. Here is an example of applying update 2020.26.1 for a 7.2 Liferay project:

liferay.workspace.lcp.backup.image=liferaycloud/backup:3.2.14
liferay.workspace.lcp.database.image=liferaycloud/database:3.2.10
liferay.workspace.lcp.search.image=liferaycloud/elasticsearch:6.8.6-3.0.8
liferay.workspace.lcp.liferay.image=liferaycloud/liferay-dxp:7.2.10-sp1-fp5-3.0.24
liferay.workspace.lcp.webserver.image=liferaycloud/nginx:1.16.1-3.2.0
liferay.workspace.lcp.jenkins.image=liferaycloud/jenkins:2.222.1-3.2.6

Once the gradle.properties file contains the updates, commit the changes to your Git repository.

git add gradle.properties && git commit -m "update dxp cloud stack to 2020.26.1"

After pushing these changes to the remote repository, a build will be created in Liferay Cloud and it is ready to deploy.

 

Version 3 Change Log

Service Name	Service Version	Ticket Number	Description
Backup	3.2.14	LCPE-1339	cancelled connections with backup upload or download are not logged
		LCP-6931	empty folder is copied into the backup on restore causing intermittent restore failure
CI	3.2.6	LCPE-1374	integrate with a private Gitlab and BitBucket domain
		LCPE-1458	git checkout error when repository requires git-lfs support
		LCP-6635	Unwanted 'github' credential is left when upgrading past Jenkins 3.2.0
		LCP-6948	OSGI wars are not copied from the right location in CI build process
Liferay	3.0.24	LCPE-1321	Set default webserver properties