This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

Table of contents

• Prerequisites
  • Permissions
• Deployment in Google Cloud Console
  • Import the CloudBeaver Community Edition custom image
  • Create a Compute Engine instance from the imported image
• Deployment with Google Cloud CLI
  • Activate Cloud Shell
  • Run the deployment command
  • Start with CloudBeaver server setup
• CloudBeaver public image URIs

This guide covers how to deploy CloudBeaver Community Edition on Google Cloud Platform (GCP) using both the Google Cloud Console and the Google Cloud CLI.

Prerequisites

Before you begin, make sure you have:

• A Google Cloud account for accessing GCP services.
• Compute Engine set up in your project.

If you don’t have a GCP account, sign up on the Google Cloud signup page.

Permissions

To deploy CloudBeaver Community Edition in Google Cloud, you need certain permissions to create and manage resources like virtual machines, disks, and networks. Ensure you have the necessary permissions for your project.

Tip: For a full list of permissions and more information on how to manage them, see the official Google Cloud Permissions documentation.If you don’t have the required permissions, contact your system administrator.

Deployment in Google Cloud Console

Import the CloudBeaver Community Edition custom image

1. Log in to the Google Cloud Console, then go to Compute Engine -> Images. Click [+] Create image.

2. Complete the Create an image form:

   • Enter the image name in the format cloudbeaver-ce-server-ubuntu-%version% or cloudbeaver-ce-server-rhel-%version%, depending on the operating system.
   • Select Virtual disk (VMDK, VHD) as the source and enter the following URI: cloudbeaver-ce-server/ in the Virtual disk file field. Click BROWSE to select your version.

   Tip: Replace %version% with the desired version number, such as 24-2-0.

3. Click Create. The image import process can take up to 15 minutes.

Create a Compute Engine instance from the imported image

1. After the image is imported, navigate to the Images tab, find your imported image, and click [+] Create instance.

2. Name your instance and set up the following:

   • Under Machine configuration, choose a machine type with at least 1 CPU and 4GB RAM for optimal CloudBeaver performance.
   • Click Change, select your custom image, and set the disk size to at least 100GB.

3. In the Firewall section, check Allow HTTP traffic and Allow HTTPS traffic to make the instance accessible online.

4. Click Create. Your instance will be ready in a few minutes. Verify by pasting its External IP into your browser.

5. Begin the initial configuration of the CloudBeaver server in your browser.

Deployment with Google Cloud CLI

Activate Cloud Shell

1. In the Google Cloud Console, go to Compute Engine and click Activate Cloud Shell to launch the CLI within GCP.

2. Authorize any prompts if needed.

Run the deployment command

Run this gcloud command to create a new instance:

gcloud beta compute instances create cloudbeaver-ce-server \
--zone=us-central1-a \
--machine-type=e2-medium \
--tags=http-server,https-server \
--image=https://www.googleapis.com/compute/v1/projects/dbeaver-public/global/images/cloudbeaver-ce-ubuntu-24-2-0 \
--create-disk=auto-delete=yes \
--boot-disk-size=100GB --boot-disk-device-name=cloudbeaver-ce-server

You can customize the command as needed. For more details on using the Google Cloud CLI, see the official documentation.

Tip: Replace the --image URL with a different version if needed.

Start with CloudBeaver server setup

1. After the instance is created, retrieve its external IP (needed for accessing the CloudBeaver server):

   gcloud compute instances list --filter="name:cloudbeaver-ce-server" --format="get(networkInterfaces[0].accessConfigs[0].natIP)"
   

   This command will return the external-ip, which you’ll need to begin the initial setup.

2. Use the external-ip to start configuring and accessing the CloudBeaver interface.

3. In your browser, go to http://<external-ip>/, where <external-ip> is the public IP address of your GCP instance.

4. You’ll be redirected to CloudBeaver’s initial configuration wizard to complete the setup.

Tip: For guidance on locating your instance's public IP address, see GCP: Viewing IP Addresses.

CloudBeaver public image URIs

• https://www.googleapis.com/compute/v1/projects/dbeaver-public/global/images/cloudbeaver-ce-ubuntu-%version%
• https://www.googleapis.com/compute/v1/projects/dbeaver-public/global/images/cloudbeaver-ce-rhel-%version%

Tip: Replace %version% with the desired version number, such as 24-2-0. For more information on tags, see CloudBeaver release cycles.