Connect your Google Cloud Platform account to Encore Cloud to deploy your Leap application directly to your own GCP infrastructure. Encore provides a dedicated GCP Service Account for your application and guides you through the setup process.

​
Prerequisites

1

GCP Organization Access

  • Access to a GCP Organization account
  • Organization Policy Administrator role (required for setup)
  • Billing enabled on your GCP project
  • Understanding of which GCP region you want to deploy to
2

Leap Application Ready

  • Your application built and tested with Leap
  • Preview environment validated and working
  • Ready to deploy to production infrastructure

​
Connection Process

1

Access the Connect Cloud page

In your Leap project:

  1. Go to the Encore Cloud dashboard
  2. Select your application
  3. Navigate to App Settings → Integrations → Connect Cloud
  4. Select Google Cloud Platform (GCP)
2

Get your App's Service Account

Encore Cloud provides a unique GCP Service Account for your application:

  • Find your app’s Service Account email on the Connect Cloud page
  • Copy this email address - you’ll need it for the next steps
  • This Service Account will be used by Encore to provision infrastructure
3

Configure Domain Restricted Sharing

Update your GCP Organization’s domain restricted sharing policy:

  • Add Encore Cloud to your allowed domains list
  • Follow the specific instructions provided on the Connect Cloud page
  • This allows Encore’s Service Account to access your organization

Permission required: You need the Organization Policy Administrator role to modify this policy.

4

Grant Access to Encore Service Account

Provide the necessary permissions to Encore’s Service Account:

  • Use the Service Account email from step 2
  • Follow the detailed permission instructions on the Connect Cloud page
  • Grant access to provision infrastructure in your GCP project

​
Required Permissions

​
What Gets Deployed

When you deploy to your GCP account through Encore Cloud, the following infrastructure is automatically provisioned:

Compute & Networking

Cloud-native application hosting

  • Google Cloud Run or Compute Engine services
  • Load balancing and auto-scaling
  • VPC and firewall configuration
  • SSL certificates and domain management

Data & Storage

Managed database and storage

  • Cloud SQL for managed databases
  • Cloud Storage for application assets
  • Automated backups and maintenance
  • Security and access controls

Security & Identity

Enterprise security configuration

  • IAM roles and service accounts
  • Security policies and firewall rules
  • Encryption at rest and in transit
  • Network isolation and access controls

Monitoring & Operations

Observability and management

  • Cloud Monitoring integration
  • Cloud Logging for centralized logs
  • Integration with Encore’s monitoring
  • Performance tracking and alerting

​
Managing Multiple GCP Accounts

Working with multiple GCP accounts

If you have access to multiple GCP accounts:

  • Ensure you’re logged in with the correct account
  • Verify the correct organization is selected in GCP Console
  • Double-check you’re modifying policies for the right organization
  • Use the account switcher in GCP Console if needed

​
Troubleshooting Common Issues

​
After Connection

Once you’ve successfully connected your GCP account:

1

Verify Connection

  • Encore Cloud will test the connection to your GCP account
  • You should see a success confirmation
  • Your GCP account will appear as an available deployment target
2

Choose Deployment Region

Select which GCP region you want for your deployment:

  • Consider latency to your users
  • Review regional service availability
  • Factor in compliance and data residency requirements
  • Consider integration with existing GCP infrastructure
3

Deploy Your Application

  • Click Deploy in your Leap project
  • Select your GCP environment
  • Monitor the deployment progress in Encore Cloud dashboard
  • First deployment typically takes 10-15 minutes

​
Important Notes

​
Getting Help

If you encounter issues during the GCP connection process:

Encore Support

Direct support channels

GCP Documentation

Additional GCP resources

Next steps: After connecting your GCP account, you can deploy your application by selecting your GCP environment in the deployment options. Monitor the deployment progress through the Encore Cloud dashboard.