Export from Gandi to Azure Blob Storage

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

The CloudQuery Gandi plugin allows you to sync data from Gandi to any destination, including Azure Blob Storage. 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 Gandi source plugin

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

Configuration

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

kind: source
# Common source-plugin configuration
spec:
  name: gandi
  path: cloudquery/gandi
  version: "v1.3.1"
  tables: ["*"]
  destinations: ["azblob"]

  # Gandi specific configuration
  spec:
    api_key: "${GANDI_API_KEY}"

This example syncs from Gandi to the azblob destination, using api_key authentication. It reads the value of the API key from an environment variable called GANDI_API_KEY. The (top level) source spec section is described in the Source Spec Reference.

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

Authentication

In order to fetch information from Gandi, cloudquery needs to be authenticated. An API key is required for authentication. Get your API key from Gandi's Account Settings Page (opens in a new tab).

Once you have your API key, you can store it as an environment variable:

export GANDI_API_KEY=<your_api_key>

(MacOS / Linux) or

set GANDI_API_KEY=<your_api_key>

(Windows)

Step 3. Configure the Azure Blob Storage destination plugin

Create a configuration file for the Azure Blob Storage plugin and set up authentication.

Configuration

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

kind: destination
spec:
  name: "azblob"
  path: "cloudquery/azblob"
  version: "v3.2.0"
  write_mode: "append" # this plugin only supports 'append' mode
  # batch_size: 10000 # optional
  # batch_size_bytes: 5242880 # optional
  spec:
    storage_account: "cqdestinationazblob"
    container: "test"
    path: "path/to/files"
    format: "parquet" # options: parquet, json, csv

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

Authentication

The plugin needs to be authenticated with your Azure account in order to fetch information about your cloud setup.

You can either authenticate with az login (when running locally), or by using a "service principal" and exporting environment variables (appropriate for automated deployments).

You can find out more about authentication with Azure at Azure's documentation (opens in a new tab) for the Go SDK.

Step 4. Start the Sync

Run the following command in your terminal to start the sync

cloudquery sync gandi.yaml azblob.yaml

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

Export from Gandi to Azure Blob Storage

Step 1. Install the CloudQuery CLI

Step 2. Configure the Gandi source plugin

Configuration

Authentication

Step 3. Configure the Azure Blob Storage destination plugin

Configuration

Authentication

Step 4. Start the Sync

Further Reading