Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/storj/gateway-st
Single-tenant, S3-compatible server to interact with the Storj network
https://github.com/storj/gateway-st
gateway storj storj-network
Last synced: 6 days ago
JSON representation
Single-tenant, S3-compatible server to interact with the Storj network
- Host: GitHub
- URL: https://github.com/storj/gateway-st
- Owner: storj
- License: apache-2.0
- Created: 2020-02-21T08:21:17.000Z (over 4 years ago)
- Default Branch: main
- Last Pushed: 2024-10-29T12:35:55.000Z (13 days ago)
- Last Synced: 2024-10-29T13:30:48.259Z (13 days ago)
- Topics: gateway, storj, storj-network
- Language: Go
- Homepage:
- Size: 2.12 MB
- Stars: 71
- Watchers: 25
- Forks: 19
- Open Issues: 12
-
Metadata Files:
- Readme: README.md
- License: LICENSE
- Code of conduct: .github/CODE_OF_CONDUCT
- Codeowners: CODEOWNERS
Awesome Lists containing this project
README
# Single Tenant S3 Gateway
[](https://goreportcard.com/report/storj.io/gateway)
[](https://pkg.go.dev/storj.io/gateway)
S3-compatible gateway for Storj V3 Network, based on a [MinIO
fork](https://github.com/storj/minio).
If you're looking for the rest of Storj's edge services, check out
[Edge](https://github.com/storj/edge).
Storj is building a decentralized cloud storage network. [Check out our white
paper for more info!](https://storj.io/white-paper)
----
Storj is an S3-compatible platform and suite of decentralized applications that
allows you to store data in a secure and decentralized manner. Your files are
encrypted, broken into little pieces and stored in a global decentralized
network of computers. Luckily, we also support allowing you (and only you) to
retrieve those files!
## Documentation
* [Using the S3 Gateway](https://docs.storj.io/api-reference/s3-gateway)
* [S3 Compatibility](https://docs.storj.io/dcs/api/s3/s3-compatibility)
## S3 API Compatibility
We support all essential API actions, like
* AbortMultipartUpload
* CompleteMultipartUpload
* CopyObject
* CreateBucket
* CreateMultipartUpload
* DeleteBucket
* DeleteObject
* DeleteObjects
* GetObject
* HeadBucket
* HeadObject
* ListBuckets
* ListMultipartUploads
* ListObjects
* ListObjectsV2
* ListParts
* PutObject
* UploadPart
as well as (Get/Put/Delete)ObjectTagging actions.
For more details on gateway's S3 compatibility, please refer to [Compatibility
Table](https://docs.storj.io/dcs/api/s3/s3-compatibility).
## Testing
### Correctness
A suite of integration tests can be run on the checked out code.
`make integration-run` will start a new integration environment using Docker
and run all the integration tests.
At the end of the run, you can run `make integration-env-purge` to remove the
integration environment.
This requires `docker` to be installed on your local machine for this to work.
#### mint
We run mint tests based on MinIO's mint
([gateway-mint](https://github.com/storj/gateway-mint)) on every commit.
To run the tests:
`make integration-env-start integration-mint-tests`
You can also run a specific test using the `TEST` environment variable:
`TEST=aws-sdk-php make integration-mint-tests`
#### ceph/splunk-s3-tests
We run S3 tests based on Splunk's fork (which is better suited for us) of
Ceph's S3 tests ([splunk-s3-tests](https://github.com/storj/splunk-s3-tests)) on
every commit.
To run the tests:
`make integration-env-start integration-splunk-tests`
## License
This library is distributed under the
[Apache-2.0](https://www.apache.org/licenses/LICENSE-2.0) license.
## Support
If you have any questions or suggestions please reach out to us on [our
community forum](https://forum.storj.io/) or email us at [email protected].