Export from BitBucket to PostgreSQL

CloudQuery is an open-source data integration platform that allows you to export data from any source to any destination.

The CloudQuery BitBucket plugin allows you to sync data from BitBucket to any destination, including PostgreSQL. It's free, open source, requires no account, and takes only minutes to get started.

Ready? Let's dive right in!

Step 1. Install the CloudQuery CLI

The CloudQuery CLI is a command-line tool that runs the sync. It supports MacOS, Linux and Windows.

brew install cloudquery/tap/cloudquery

Step 2. Configure the BitBucket source plugin

Create a configuration file for the BitBucket plugin and set up authentication.

Configuration

Create a file called bitbucket.yaml and add the following contents:

kind: source
# Common source-plugin configuration
spec:
  name: bitbucket
  registry: docker
  path: ghcr.io/cloudquery/cq-source-bitbucket:v1.0.2
  tables: ["*"]
  destinations: ["postgresql"]
  # bitbucket-specific configuration
  spec:
    username: "${BITBUCKET_USERNAME}" # required
    password: "${BITBUCKET_PASSWORD}" # required

This example uses environment variable expansion to read the username and password options from BITBUCKET_USERNAME and BITBUCKET_PASSWORD environment variables respectively. You can also hardcode the value in the configuration file, but this is not advised for production settings.

Fine-tune this configuration to match your needs. For more information, see the BitBucket Plugin ↗ page in the docs.

Authentication

In order to fetch information from Bitbucket Cloud, cloudquery needs to authenticate using an app password (opens in a new tab). Follow the instructions on the Bitbucket website and create a read-only token with account:read, projects:read and repositories:read permissions.

Step 3. Configure the PostgreSQL destination plugin

Create a configuration file for the PostgreSQL plugin and set up authentication.

Configuration

Create a file called postgresql.yaml and add the following contents:

This example configures a Postgresql destination, located at localhost:5432:

kind: destination
spec:
  name: "postgresql"
  registry: "github"
  path: "cloudquery/postgresql"
  version: "v6.1.2"

  spec:
    connection_string: "postgresql://postgres:pass@localhost:5432/postgres?sslmode=disable"
    # can be also specified in DSN format which can hold special characters in password
    # connection_string: "user=postgres password=pass+0-[word host=localhost port=5432 dbname=postgres"
    # Optional parameters:
    # pgx_log_level: error
    # batch_size: 10000 # 10K entries
    # batch_size_bytes: 100000000 # 100 MB
    # batch_timeout: 60s

Fine-tune this configuration to match your needs. For more information, see the PostgreSQL Plugin ↗ page in the docs.

Step 4. Start the Sync

Run the following command in your terminal to start the sync

cloudquery sync bitbucket.yaml postgresql.yaml

And away we go! 🚀 The sync will run until completion, fetching all selected tables from BitBucket. Any errors will be logged to a file called cloudquery.log.

Export from BitBucket to PostgreSQL

Step 1. Install the CloudQuery CLI

Step 2. Configure the BitBucket source plugin

Configuration

Authentication

Step 3. Configure the PostgreSQL destination plugin

Configuration

Step 4. Start the Sync

Further Reading