Skip to content

Storj Connector Framework - reference implementation to connect data sources to the Storj protocol

License

Notifications You must be signed in to change notification settings

storj-thirdparty/connector-framework

Repository files navigation

connector-framework (uplink v1.4.5)

Codacy Badge Go Report Card Cloud Build

Overview

The framework Connector is a generic connector that can be used to take backup from the specified source and upload the backup files on Storj network. Sample connector to local disk is provided.

Usage:
  connector-framework [command] <flags>

Available Commands:
  help        Help about any command
  store       Command to upload data to a Storj V3 network
  version     Prints the version of the tool
  visualize   Visualize collected performance metrics

store - Connect to the specified(default: local.json). Back-up data are generated using tooling provided by framework then uploaded to the Storj network. Connect to a Storj v3 network using the access specified in the Storj configuration file (default: storj_config.json).

Sample configuration files are provided in the ./config folder.

Requirements and Install

To build from scratch, install the latest Go.

Note: Ensure go modules are enabled (GO111MODULE=on)

Option #1: clone this repo (most common)

To clone the repo

git clone https://github.com/storj-thirdparty/connector-framework.git

Then, build the project using the following:

cd connector-framework
go build

Option #2: go get into your gopath

To download the project inside your GOPATH use the following command:

go get github.com/storj-thirdparty/connector-framework

Note: For reference, connector-local to backup a local file is made and following commands can be used to test the same.

Run (short version)

Once you have built the project run the following commands as per your requirement:

Get help
$ ./connector-framework --help
Check version
$ ./connector-framework --version
Create backup from framework and upload to Storj
$ ./connector-framework store

Documentation

For more information on runtime flags, configuration, testing, and diagrams, check out the Detail or jump to:

About

Storj Connector Framework - reference implementation to connect data sources to the Storj protocol

Topics

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages