Skip to content

development_environment.md

Latest commit

 

History

History
56 lines (41 loc) · 1.75 KB

development_environment.md

File metadata and controls

56 lines (41 loc) · 1.75 KB

Development Environment Setup

Requirements

  • Go 1.19+ (to build the integrations)

Quick Start

Building

Clone the repository:

git clone https://github.com/cloudquery/cloudquery

Build the CLI and all integrations:

./scripts/build.sh

Running Source Plugins in Developer Mode

  1. Execute go run main.go serve from the chosen plugin directory under ../plugins/source (e.g. ../plugins/source/aws).
  2. Create a config file for the source plugin. See the plugin's README.md for details. In the global spec section, set registry to grpc and path to localhost:7777. For example: 
    kind: "source"
spec:
  # global config
  name: "aws"
  version: "VERSION_SOURCE_AWS"
  registry: "grpc"
  path: "localhost:7777"
  tables: ["*"]
  destinations: ["postgresql"]
  spec:
  # plugin-specific config
  3. Create a configuration file for the destination plugin to load data into. See the Destination Integration's README.md for examples.
  4. Open another terminal and run bin/cloudquery sync <config-dir>, where <config-dir> is the directory containing the config files.

Note that plugin logs will be output to the plugin process terminal.

Testing

To run tests all unit tests for a plugin, inside the plugin directory run:

make test  # This runs go test -race ./...

Unit Tests don't require any credentials, but some may require internet access.

Unit tests for integrations include:

  • Specific resource tests. You can find those next to each resource, in the resources/services folder under the plugin directory.
  • Client tests. You can find those in the client folder.