Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/storj-thirdparty/connector-mariadb
MariaDB/MySQL connector to the Storj protocol; use this to backup your data to the leading decentralized storage network.
https://github.com/storj-thirdparty/connector-mariadb
connector mariadb mysql
Last synced: 19 days ago
JSON representation
MariaDB/MySQL connector to the Storj protocol; use this to backup your data to the leading decentralized storage network.
- Host: GitHub
- URL: https://github.com/storj-thirdparty/connector-mariadb
- Owner: storj-thirdparty
- License: apache-2.0
- Created: 2020-05-25T21:23:58.000Z (over 4 years ago)
- Default Branch: master
- Last Pushed: 2020-10-02T02:00:57.000Z (over 4 years ago)
- Last Synced: 2024-11-15T21:45:53.932Z (3 months ago)
- Topics: connector, mariadb, mysql
- Language: Go
- Homepage: https://storj.io
- Size: 4.36 MB
- Stars: 2
- Watchers: 3
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.assets/Home.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
README
## Flow Diagram
![](https://github.com/storj-thirdparty/connector-mariadb/blob/master/README.assets/arch.drawio.png)
## Config Files
There are two config files that contain Storj network and MariaDB connection information. The tool is designed so you can specify a config file as part of your tooling/workflow.
##### `db_property.json`
Inside the `./config` directory there is a `db_property.json` file, with following information about your MariaDB instance:
* `hostName`- Host Name connect to MariaDB
* `port` - Port connect to MariaDB
* `username` - User Name of MariaDB
* `password` - Password of MariaDB
* `database` - MariaDB Database Name# `storj_config.json`
Inside the `./config` directory a `storj_config.json` file, with Storj network configuration information in JSON format:
* `apiKey` - API Key created in Storj Satellite GUI (mandatory)
* `satellite` - Storj Satellite URL (mandatory)
* `encryptionPassphrase` - Storj Encryption Passphrase (mandatory)
* `bucket` - Name of the bucket to upload data into (mandatory)
* `uploadPath` - Path on Storj Bucket to store data (optional) or "" or "/". (mandatory)
* `serializedAccess` - Serialized access shared while uploading data used to access bucket without API Key (mandatory)
* `allowDownload` - Set *true* to create serialized access with restricted download (mandatory while using *share* flag)
* `allowUpload` - Set *true* to create serialized access with restricted upload (mandatory while using *share* flag)
* `allowList` - Set *true* to create serialized access with restricted list access
* `allowDelete` - Set *true* to create serialized access with restricted delete
* `notBefore` - Set time that is always before *notAfter*
* `notAfter` - Set time that is always after *notBefore*## Run
Once you have built the project run the following commands as per your requirement:
##### Get help
```
$ ./connector-mariadb --help
```##### Check version
```
$ ./connector-mariadb --version
```##### Create back-up from MariaDB and upload them to Storj
```
$ ./connector-mariadb store --mariab --storj
```##### Create back-up from MariaDB and upload it to Storj bucket using Access Key
```
$ ./connector-mariadb store --accesskey
```##### Create back-up from MariaDB and upload it to Storj and generate a Shareable Access Key based on restrictions in `storj_config.json`
```
$ ./connector-mariadb store --share
```## Testing
The project has been tested on the following operating systems:
```
* Windows
* Version: 10 Pro
* Processor: Intel(R) Core(TM) i3-5005U CPU @ 2.00GHz 2.00GHz
* MariaDB version: 10.4.14* macOS Catalina
* Version: 10.15.4
* Processor: 2.5 GHz Dual-Core Intel Core i5
* MariaDB version: 10.4.14* ubuntu
* Version: 16.04 LTS
* Processor: AMD A6-7310 APU with AMD Radeon R4 Graphics × 4
* MariaDB version: 10.4.14
```