Skip to main content

         This documentation site is for previous versions. Visit our new documentation site for current releases.      

This content has been archived and is no longer being updated.

Links may not function; however, this content may be relevant to outdated versions of the product.

Deploying Pega Platform on GCP

Updated on September 10, 2021

Deploy Pega Platform™ on Google Cloud Platform (GCP) to take advantage of Pega Platform Cloud Choice flexibility. This article provides general instructions for creating typical Pega Platform environments on GCP. To explore the latest information about the Cloud Choice deployment solution using Kubernetes across client-managed environments, see Cloud Choice.

The most common types of Pega Platform environments that are deployed to GCP include:

  • A development or test environment, which typically consists of a single virtual machine (VM) with Pega Platform installed.

  • A shared development environment, which typically includes multiple virtual machines and a load balancer to support development across several teams.

  • An advanced multi-tiered environment, which is typically used for production deployments or preproduction testing. In this environment, separate tiers of servers are added to address specific needs such as front-end processing, back-end processing, and database services. Additional availability sets ensure high availability.

Assumptions and best practices

These instructions require the following:

  • You have a GCP account that includes access to the GCP Cloud Shell

  • Each VM includes only one Pega Platform node

  • You are familiar with the following GCP services:

    • Compute Engine

    • Network Services

    • VPC Network

    • Monitoring

    • Logging

    • IAM and Admin

    • SQL including Cloud SQL Proxy

  • All GCP resources related to a single Pega Platform database use the same GCP region and zone, as shown in the following figure:


Pega Platform deployments on GCP require all nodes to have read/write access to the Pega Cloud SQL database.

Note: The Cloud SQL for PostgreSQL Database service does not support the installation of user-defined functions (UDFs).

System requirements

Before you begin deployment, ensure that your system includes the following items:

  • A supported 64-bit JDK. See the Platform Support Guide for a list of supported versions.

  • A supported application server. See the Platform Support Guide for a list of supported versions. The preferred server is Apache Tomcat.

  • An appropriate JDBC Driver

Database requirements

Pega Platform requires a relational database to host its data and rules. Use one of the supported databases listed in the Platform Support Guide on a VM or, if you prefer, you can use Cloud SQL for PostgreSQL.

For the database installation, complete the following steps:

  1. Create a temporary VM in GCP by using the same zone as the database.

  2. Copy the Pega Platform distribution image to this VM.

  3. Go to the Pega Platform product page and select the Pega Platform Installation Guide for the product version that is appropriate for your database.

  4. Install Pega Platform on the VM by following the installation guide instructions.

Setup and configuration

For configuration steps to set up your environment, see the tutorial: Deploying Pega Platform on Google Cloud Platform.

Note: Pega supports the deployment of Pega Platform 7.4 and later on GCP.

Have a question? Get answers now.

Visit the Support Center to ask questions, engage in discussions, share ideas, and help others.

Did you find this content helpful?

Want to help us improve this content?

We'd prefer it if you saw us at our best. is not optimized for Internet Explorer. For the optimal experience, please use:

Close Deprecation Notice
Contact us