Initial Setup Overview
Getting started with Liferay Cloud (SaaS or PaaS) involves ensuring all accounts, environments, and services have been successfully provisioned and deployed in your instance. Begin with the following steps:
- Check Setup Emails
- Access the Liferay Cloud Console
- Access the Provisioned Project Source Code
- Log into Your CI and Liferay Services
- Verify Setup
Check Setup Emails
Check the email account associated with your Liferay Cloud subscription for setup emails. You should receive a Liferay Cloud onboarding email along with email invitations for each purchased Liferay Cloud environment.
The onboarding email provides necessary credentials for accessing Jenkins and Liferay DXP on non-production environments, as well as important steps for getting started with Liferay Cloud.
Each environment invitation grants access to a single purchased Liferay Cloud environment. Be sure to accept all environment invitations.
Access the Liferay Cloud Console
Returning users can log into the Liferay Cloud Console using their existing accounts. New users must create an account using the email account associated with the Liferay Cloud subscription.
After logging in, the Liferay Cloud Console home page appears.
From here, you can access and manage environments and deployments, as well as invite other team members.
Access the Provisioned Project Source Code
New Liferay Cloud projects are provisioned a temporary GitHub repository hosted in the dxpcloud
organization. This repository contains the template for a Liferay Cloud development project.
To access to your new project repository, follow the instructions in the Liferay Cloud onboarding email and accept the subsequent GitHub invitation.
After accepting the invitation, locate your provisioned project repository:
-
Log into GitHub.
-
Search
dxpcloud
in the Your teams search box.
Once you have found your provisioned repository, you must:
-
Transfer the provisioned repository’s content to a private Git repository.
-
Integrate the private repository with the Jenkins (CI) service in Liferay Cloud using a Webhook.
See Configuring Your GitHub Repository for detailed instructions.
Log into Your CI and Liferay Services
Log into the Jenkins (CI) web interface, then log into your Liferay DXP instance’s non-production environments (e.g., dev and uat) so you can access them.
Login credentials are provided in the initial onboarding email, and listed as secrets in your infra environment.
See Logging into Your Liferay Cloud Services for detailed instructions.
Verifying Setup
Before beginning deployment in Liferay Cloud, verify that the correct environments and services have been successfully provisioned and deployed.
Verifying Environments
Verify all purchased environments are listed in the Liferay Cloud Console home page under Projects.
If any environments are missing after you’ve accepted all environment invitations, please contact the Liferay Support team.
Verifying Environment Locations
Verify that the location for each environment matches the location requested by your team.
All environment locations are listed on the Liferay Cloud Console home page.
You can also view an environment’s location by navigating to its Overview page or Settings page.
If the environment location does not match the location requested by your team, please contact the Liferay Support team.
Verifying Cloud Stack Services
Verify the Liferay Cloud stack services are properly deployed:
-
Access the dev environment from the Liferay Cloud Console.
-
Navigate to the Services page.
When properly deployed, the status of all 5 default Cloud Stack services should be ‘Ready’.