CloudBeaver Documentation

DOWNLOAD pdf

Team Edition deployment with GCP Image

Table of contents

Overview

This guide shows how to deploy DBeaver Team 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 Team 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 Team 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 dbeaver-te-server-ubuntu-%version% or dbeaver-te-server-rhel-%version%, depending on the operating system.
    • Select Virtual disk (VMDK, VHD), and in the Virtual disk file field, enter this URI: dbeaver-te-server/dbeaver. Click BROWSE and choose your version.

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

  1. Click Create. The process may take up to 15 minutes.

Create a Compute Engine instance from the imported image

  1. In the Images tab, find the imported image and click [+] Create instance.

  2. Configure the VM Instance:

    • Name: Enter a unique name for your instance.
    • Region and Zone: Choose a region and zone that suit your requirements.
    • Machine type: Choose a machine type with at least 4 vCPUs and 16 GB RAM for optimal performance.
    • Boot Disk:
      • The imported image should be pre-selected as the boot disk.
      • Ensure the disk size is set to at least 100 GB to accommodate DBeaver Team Edition.

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

  4. Begin the initial configuration of the Team Edition server.

Tip: For detailed steps on the initial setup and server management, see the Managing cloud deployed services guide.

Deployment with Google Cloud CLI

Activate Cloud Shell

  1. Launch the CLI within GCP. For more details, see official documentation.

  2. Authorize any prompts if needed.

Run the deployment command

Run this gcloud command to create a new instance:

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

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

Tip: The --image flag references a public image URL. You can find other available images, including custom ones, in the Team Edition Images section. Replace the image URL in the command if needed.

Start with Team Edition server setup
  1. After the instance is created, retrieve its external IP (needed for accessing the Team Edition server):
gcloud compute instances list --filter="name:dbeaver-te-server" --format="get(networkInterfaces[0].accessConfigs[0].natIP)"

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

  1. Use the external-ip to start configuring and accessing the Team Edition interface.

Tip: For comprehensive steps on initial setup, server management tasks like starting, stopping, updating, configuring, and backing up, see the Managing DBeaver Team Edition server guide.

Team Edition public image URIs
  • https://www.googleapis.com/compute/v1/projects/dbeaver-public/global/images/dbeaver-te-server-ubuntu-%version%
  • https://www.googleapis.com/compute/v1/projects/dbeaver-public/global/images/dbeaver-te-server-rhel-%version%

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