FrostFS is a decentralized distributed object storage integrated with the NEO Blockchain.
Find a file
Ekaterina Lebedeva afd2ba9a66
All checks were successful
DCO action / DCO (pull_request) Successful in 2m55s
Vulncheck / Vulncheck (pull_request) Successful in 3m22s
Tests and linters / Staticcheck (pull_request) Successful in 4m10s
Build / Build Components (1.20) (pull_request) Successful in 4m58s
Build / Build Components (1.21) (pull_request) Successful in 4m54s
Tests and linters / Lint (pull_request) Successful in 5m47s
Tests and linters / Tests (1.20) (pull_request) Successful in 6m45s
Tests and linters / Tests (1.21) (pull_request) Successful in 6m58s
Tests and linters / Tests with -race (pull_request) Successful in 7m42s
[#110] Add check for repeated error log in policer
processObject() returns 3 types of errors: container not found errors,
could not get container error and placement vector building error. Every
error will occur for all objects in container simultaneously, so we can
log each error once and safely ignore the rest.

Signed-off-by: Ekaterina Lebedeva <ekaterina.lebedeva@yadro.com>
2024-02-06 00:56:41 +03:00
.docker [#581] Bump required go version to go1.20 2023-08-09 10:16:48 +00:00
.forgejo/workflows [#935] .forgejo: Update dco-go to v3 2024-01-26 12:19:20 +03:00
.github Add to Possible Solutions 2023-03-21 15:41:20 +03:00
.woodpecker [#171] Remove unit tests from pipeline 2023-03-24 10:50:11 +03:00
cmd [#922] cli: Add new command control list-targets 2024-02-02 12:09:51 +00:00
config [#887] node: Drop badger writecache implementation 2023-12-22 13:00:54 +03:00
debian [#552] Add status notification to systemd 2023-12-13 15:02:39 +03:00
dev [#922] Fix linter issue 2024-02-02 12:09:51 +00:00
docs [#887] node: Drop badger writecache implementation 2023-12-22 13:00:54 +03:00
internal [#937] ape: Validate chain resource name 2024-01-31 11:34:35 +03:00
misc [#1592] Remove debug builds 2022-07-14 10:39:51 +03:00
pkg [#110] Add check for repeated error log in policer 2024-02-06 00:56:41 +03:00
scripts/export-metrics [#772] node: Apply gofumpt 2023-10-31 17:03:03 +03:00
.dockerignore [#144] Don't copy cache inside Docker environment 2023-03-17 10:36:50 +03:00
.gitattributes [#246] .gitattributes: Do not show diff for go.sum 2023-04-14 06:02:04 +00:00
.gitignore [#53] Fix dirty in version 2023-02-16 11:10:43 +03:00
.gitlint [#171] Syncrhonize pre-commit settings across FrostFS repos 2023-03-24 10:43:55 +03:00
.golangci.yml [#857] golangci: Add protogetter linter 2023-12-12 16:27:02 +03:00
.pre-commit-config.yaml [#837] .pre-commit: Update hook versions 2023-12-06 11:07:10 +00:00
CHANGELOG.md [#581] Bump required go version to go1.20 2023-08-09 10:16:48 +00:00
CONTRIBUTING.md [#511] docs: Remove GitHub mentions from CONTRIBUTING.md 2023-07-18 13:24:02 +00:00
CREDITS.md [#83] pre-commit: Add initial configuration 2023-03-13 07:07:29 +00:00
go.mod [#922] go.mod: Update APE 2024-02-02 12:09:51 +00:00
go.sum [#922] go.mod: Update APE 2024-02-02 12:09:51 +00:00
help.mk [#1578] Minor Makefile fixes 2022-07-06 10:00:19 +03:00
LICENSE Initial commit 2020-07-10 17:45:00 +03:00
Makefile [#922] Fix linter issue 2024-02-02 12:09:51 +00:00
README.md [#922] Fix linter issue 2024-02-02 12:09:51 +00:00
VERSION Release v0.36.0 2023-04-12 16:57:02 +03:00

FrostFS

FrostFS is a decentralized distributed object storage integrated with the NEO Blockchain.


Report GitHub release (latest SemVer) License

Overview

FrostFS Nodes are organized in a peer-to-peer network that takes care of storing and distributing user's data. Any Neo user may participate in the network and get paid for providing storage resources to other users or store their data in FrostFS and pay a competitive price for it.

Users can reliably store object data in the FrostFS network and have a transparent data placement process due to a decentralized architecture and flexible storage policies. Each node is responsible for executing the storage policies that the users select for geographical location, reliability level, number of nodes, type of disks, capacity, etc. Thus, FrostFS gives full control over data to users.

Deep Neo Blockchain integration allows FrostFS to be used by dApps directly from NeoVM on the Smart Contract code level. This way dApps are not limited to on-chain storage and can manipulate large amounts of data without paying a prohibitive price.

FrostFS has a native gRPC API and has protocol gateways for popular protocols such as AWS S3, HTTP, FUSE and sFTP allowing developers to integrate applications without rewriting their code.

Supported platforms

Now, we only support GNU/Linux on amd64 CPUs with AVX/AVX2 instructions. More platforms will be officially supported after release 1.0.

The latest version of frostfs-node works with frostfs-contract v0.16.0.

Building

To make all binaries you need Go 1.20+ and make:

make all

The resulting binaries will appear in bin/ folder.

To make a specific binary use:

make bin/frostfs-<name>

See the list of all available commands in the cmd folder.

Building with Docker

Building can also be performed in a container:

make docker/all                     # build all binaries
make docker/bin/frostfs-<name> # build a specific binary

Docker images

To make docker images suitable for use in frostfs-dev-env use:

make images

Debugging

VSCode

To run and debug single node cluster with VSCode:

  1. Clone and build frostfs-contract repository to the same directory level as frostfs-node. For example:
/
├── src
    ├── frostfs-node
    └── frostfs-contract

See frostfs-contract's README.md for build instructions.

  1. Copy launch.json and tasks.json from dev/.vscode-example directory to .vscode directory. If you already have such files in .vscode directory, then merge them manually.

  2. Go to Run and Debug (Ctrl+Shift+D) and start IR+Storage node configuration.

  3. To create container and put object into it run (container and object IDs will be different):

./bin/frostfs-cli container create -r 127.0.0.1:8080 --wallet ./dev/wallet.json --policy "REP 1 IN X CBF 1 SELECT 1 FROM * AS X" --basic-acl public-read-write --await
Enter password >  <- press ENTER, the is no password for wallet
CID: CfPhEuHQ2PRvM4gfBQDC4dWZY3NccovyfcnEdiq2ixju

./bin/frostfs-cli object put -r 127.0.0.1:8080 --wallet ./dev/wallet.json --file README.md --cid CfPhEuHQ2PRvM4gfBQDC4dWZY3NccovyfcnEdiq2ixju
Enter password >
 4300 / 4300 [===========================================================================================================================================================================================================] 100.00% 0s
[README.md] Object successfully stored
  OID: 78sohnudVMnPsczXqsTUcvezosan2YDNVZwDE8Kq5YwU
  CID: CfPhEuHQ2PRvM4gfBQDC4dWZY3NccovyfcnEdiq2ixju

./bin/frostfs-cli object get -r 127.0.0.1:8080 --wallet ./dev/wallet.json --cid CfPhEuHQ2PRvM4gfBQDC4dWZY3NccovyfcnEdiq2ixju --oid 78sohnudVMnPsczXqsTUcvezosan2YDNVZwDE8Kq5YwU
...

Contributing

Feel free to contribute to this project after reading the contributing guidelines.

Before starting to work on a certain topic, create a new issue first, describing the feature/topic you are going to implement.

Credits

FrostFS is maintained by True Cloud Lab with the help and contributions from community members.

Please see CREDITS for details.

License