frostfs-s3-gw/CHANGELOG.md

Changelog

This document outlines major changes between releases.

Unreleased

Fixed

• Clean up List and Name caches when object is missing in Tree service (#57)
• Get empty bucket CORS from frostfs (TrueCloudLab#36)
• Don't count pool error on client abort (#35)

Added

• Return X-Owner-Id in head-bucket response (#79)
• Return container name in head-bucket response (TrueCloudLab#18)
• Billing metrics (TrueCloudLab#5)
• Multiple configs support (TrueCloudLab#21)
• Bucket name resolving policy (TrueCloudLab#25)
• Support string Action and Resource fields in bucketPolicy.Statement (TrueCloudLab#32)
• Add new kludge.use_default_xmlns_for_complete_multipart config param (TrueCloudLab#40)

Changed

• Update neo-go to v0.101.0 (#14)
• Update viper to v1.15.0 (#14)
• Using multiple servers require only one healthy (TrueCloudLab#12)
• Update go version to go1.18 (TrueCloudLab#16)
• Return error on invalid LocationConstraint (TrueCloudLab#23)
• Place billing metrics to separate url path (TrueCloudLab#26)
• Add generated deb builder files to .gitignore, and fix typo (TrueCloudLab#28)
• Limit number of objects to delete at one time (TrueCloudLab#37)
• CompleteMultipartUpload handler now sends whitespace characters to keep alive client's connection (#60)
• Support new system attributes (#64)
• Changed values for frostfs_s3_gw_state_health metric (#91)

[0.26.0] - 2022-12-28

Added

• Use client time as now in some requests (#726)
• Reload policies on SIGHUP (#747)
• Authmate flags for pool timeouts (#760)
• Multiple server listeners (#742)

Changed

• Placement policy configuration (#568)
• Improved debug logging of CID and OID values (#754)

Removed

• Deprecated linters (#755)

Updating from v0.25.1

New config parameters were added. And old one defaul_policy were changed.

placement_policy:
  default: "REP 3"
  region_mapping: /path/to/container/policies.json

Make sure you update the config accordingly: If you configure application using environment variables change:

• S3_GW_DEFAULT_POLICY -> S3_GW_PLACEMENT_POLICY_DEFAULT_POLICY
• S3_GW_LISTEN_ADDRESS -> S3_GW_SERVER_0_ADDRESS
• S3_GW_TLS_CERT_FILE -> S3_GW_SERVER_0_TLS_CERT_FILE (and set S3_GW_SERVER_0_TLS_ENABLED=true)
• S3_GW_TLS_KEY_FILE -> S3_GW_SERVER_0_TLS_KEY_FILE (and set S3_GW_SERVER_0_TLS_ENABLED=true)

If you configure application using .yaml file change:

• defaul_policy -> placement_policy.default
• listen_address -> server.0.address
• tls.cert_file -> server.0.tls.cert_file (and set server.0.tls.enabled: true)
• tls.key_file -> server.0.tls.key_file (and set server.0.tls.enabled: true)

[0.25.1] - 2022-10-30

Fixed

• Empty bucket policy (#740)
• Big object removal (#749)
• Checksum panic (#741)

Added

• Debian packaging (#737)
• Timeout for individual operations in streaming RPC (#750)

0.25.0 - 2022-10-31

Fixed

• Legal hold object lock enabling (#709)
• Errors at object locking (#719)
• Unrestricted access to not owned objects via cache (#713)
• Check tree service health (#699)
• Bucket names in listing (#733)

Added

• Config reloading on SIGHUP (#702, #715, #716)
• Stop pool dial on SIGINT (#712)

Changed

• GitHub actions update (#710)
• Makefile help (#725)
• Optimized object tags setting (#669)
• Improved logging (#728)
• Unified unit test names (#617)
• Improved docs (#732)

Removed

• Unused cache methods (#650)

Updating from v0.24.0

New config parameters were added. Make sure the default parameters are appropriate for you.

cache:
  accesscontrol:
    lifetime: 1m
    size: 100000

0.24.0 - 2022-09-14

Added

• Exposure of pool metrics (#615, #680)
• Configuration of set_copies_number (#634, #637)
• Configuration of list of allowed AccessKeyID prefixes (#674)
• Tagging directive for CopyObject (#666, #683)
• Customer encryption (#595)
• CopiesNumber configuration (#634, #637)

Changed

• Improved wallet configuration via .yaml config and environment variables (#607)
• Update go version for build to 1.19 (#694, #705)
• Update version calculation (#653, #697)
• Optimized lock creation (#692)
• Update way to configure listen_domains (#667)
• Use FilePath instead of FileName for object keys (#657)
• Optimize listing (#625, #616)

Removed

• Drop any object search logic (#545)

Fixed

• Responses to GetObject and HeadObject: removed redundant VersionID (#577, #682)
• Replacement of object tagging in case of overwriting of an object (#645)
• Using tags cache with empty versionId (#643)
• Fix panic on go1.19 (#678)
• Fix panic on invalid versioning status (#660)
• Fix panic on missing decrypt reader (#704)
• Using multipart uploads with / in name (#671)
• Don't update settings cache when request fails (#661)
• Fix handling X-Amz-Copy-Source header (#672)
• ACL related problems (#676, #606)
• Using ContinuationToken for "directories" (#684)
• Fix connection was closed error (#656)
• Fix listing for nested objects (#624)
• Fix anon requests to tree service (#504, #505)

Updating from v0.23.0

Make sure your configuration is valid:

If you configure application using environment variables change:

• S3_GW_WALLET -> S3_GW_WALLET_PATH
• S3_GW_ADDRESS -> S3_GW_WALLET_ADDRESS
• S3_GW_LISTEN_DOMAINS_N -> S3_GW_LISTEN_DOMAINS (use it as array variable)

If you configure application using .yaml file change:

• wallet -> wallet.path
• address -> wallet.address
• listen_domains.n -> listen_domains (use it as array param)

0.23.0 - 2022-08-01

Fixed

• System metadata are filtered now (#619)
• List objects in corner cases (#612, #627)
• Correct removal of a deleted object (#610)
• Bucket creation could lead to "no healthy client" error (#636)

Added

• New param to configure pool error threshold (#633)

Changed

• Pprof and prometheus metrics configuration (#591)
• Don't set sticky bit in authmate container (#540)
• Updated compatibility table (#638)
• Rely on string sanitizing from zap (#498)

Updating from v0.22.0

1. To enable pprof use pprof.enabled instead of pprof in config. To enable prometheus metrics use prometheus.enabled instead of metrics in config. If you are using the command line flags you can skip this step.

0.22.0 - 2022-07-25

Tree service support

Fixed

• Error logging (#450)
• Default bucket location constraint (#463)
• Suspended versioning status (#462)
• CodeQL warnings (#489, #522, #539)
• Bearer token behaviour with non-owned buckets (#459)
• ACL issues (#495, #553, #571, #573, #574, #580)
• Authmate policy parsing (#558)

Added

• Public key output in authmate issue-secret command (#482)
• Support of conditional headers (#484)
• Cache type cast error logging (#465)
• docker/* target in Makefile (#471)
• Pre signed requests (#529)
• Tagging and ACL notifications (#361)
• AWSv4 signer package to improve compatibility with S3 clients (#528)
• Extension mimetype detector (#289)
• Default params documentation (#592)
• Health metric (#600)
• Parallel object listing (#525)
• Tree service (see commit links from #609)

Changed

• Reduce number of network requests (#439, #441)
• Renamed authmate to s3-authmate (#518)
• Version output (#578)
• Improved error messages (#539)

Removed

• layer/neofs package (#438)

0.21.1 - 2022-05-16

Changed

• Update go version to go1.17 (#427)
• Set homomorphic hashing disable attribute in container if required (#435)

0.21.0 - 2022-05-13

Added

• Support of get-object-attributes (#430)

Fixed

• Reduced time of bucket creation (#426)
• Bucket removal (#428)
• Obtainment of ETag value (#431)

Changed

• Authmate doesn't parse session context anymore, now it accepts application defined flexible structure with container ID in human-readable format (#428)

0.20.0 - 2022-04-29

Added

• Support of object locking (#195)
• Support of basic notifications (#357, #358, #359)

Changed

• Logger behavior: now it writes to stderr instead of stdout, app name and version are always presented and fixed, all user options except of level are dropped (#380)
• Improved docs, added config examples (#396, #398)
• Updated NeoFS SDK (#365, #409)

Fixed

• Added check of SetEACL tokens before processing of requests (#347)
• Authmate: returned lost session tokens when a parameter --session-token is omitted (#387)
• Error when a bucket hasn't a settings file (#389)
• Response to a request to delete not existing object (#392)
• Replaced gate key in ACL Grantee by key of bearer token issuer (#395)
• Missing attach of bearer token to requests to put system object (#399)
• Deletion of system object while CompleteMultipartUpload (#400)
• Improved English in docs and comments (#405)
• Authmate: reconsidered default bearer token rules (#406)

0.19.0 - 2022-03-16

Added

• Authmate: support placement policy overriding (#343, #364)
• Managing bucket notification configuration (#340)
• Unit tests in go1.17 (#265)
• NATS settings in application config (#341)
• Support Expires and Cache-Control headers (#312)
• Support % as delimiter (#313)
• Support null version deletion (#319)
• Bucket name resolving order (#285)
• Authmate: added timeout flag (#290)
• MinIO results in s3 compatibility tables (#304)
• Support overriding response headers (#310)

Changed

• Authmate: check parameters before container creation (#372)
• Unify cache invalidation on deletion (#368)
• Updated NeoFS SDK to v1.0.0-rc.3 (#297, #333, #346, #376)
• Authmate: changed session token rules handling (#329, #336, #338, #352)
• Changed status code for some failed requests (#308)
• GetBucketLocation returns policy name used at bucket creation (#301)

Fixed

• Waiting for bucket to be deleted (#366)
• Authmate: changed error message for session context building (#348)
• Authmate: fixed access key parsing in obtain-secret command (#295)
• Distinguishing BucketAlreadyExists errors (#354)
• Incorrect panic if handler not found (#305)
• Authmate: use container friendly name as system name (#299, #324)
• Use UTC Last-Modified timestamps (#331)
• Don't return object system metadata (#307)
• Handling empty post policy (#306)
• Use X-Amz-Verion-Id in CompleteMulipartUpload (#318)

Removed

• Drop MinIO related errors (#316)

0.18.0 - 2021-12-16

Added

• Support for MultipartUpload (#186, #187)
• CORS support (#217)
• Authmate supports setting of tokens lifetime in a more convenient format (duration) (#258)
• Generation of a random key for --no-sign-request (#276)

Changed

• Bucket name resolving mechanism from listing owner's containers to using DNS (#219)

Removed

• Deprecated golint, replaced by revive (#272)

0.17.0 (24 Sep 2021)

With this release we introduce ceph-based S3 compatibility results.

Added

• Versioning support (#122, #242, #263)
• Ceph S3 compatibility results (#150, #249, #266)
• Handling X-Amz-Expected-Bucket-Owner header (#216)
• X-Container-Id header for HeadBucket response (#220)
• Basic ACL support (#49, #213)
• Caching (#179, #206, #231, #236, #253)
• Metadata directive when copying (#191)
• Bucket name checking (189)
• Continuation token support (#112, #154, #180)
• Mapping LocationConstraint to PlacementPolicy (#89)
• Tagging support (#196)
• POST uploading support (#190)
• Delete marker support (#248)
• Expiration for access box (#255)
• AWS CLI credential generating by authmate (#241)

Changed

• Default placement policy is now configurable (#218)
• README is split into different files (#210)
• Unified error handling (#89, #149, #184)
• Authmate issue-secret response contains container id (#163)
• Removed "github.com/nspcc-dev/neofs-node" dependency (#234)
• Removed GitHub workflow of image publishing (#243)
• Changed license to AGPLv3 (#264)

Fixed

• ListObjects results are now the same for different users (#230)
• Error response for invalid authentication header is now correct (#199)
• Saving object metadata (#198)
• Range header handling (#194)
• Correct status codes (#118, #262)
• HeadObject for "directories" (#160)
• Fetch-owner parameter support (#159)

0.16.0 (16 Jul 2021)

With this release we publish S3 gateway source code. It includes various S3 compatibility improvements, support of bucket management, unified secp256r1 cryptography with NEP-6 wallet support.

Fixed

• Allowed no-sign request (#65)
• Bearer token attached to all requests (#84)
• Time format in responses (#133)
• Max-keys checked in ListObjects (#135)
• Lost metadat in the objects (#131)
• Unique bucket name check (#125)

Added

• Bucket management operations (#47, #72)
• Node-specific owner IDs in bearer tokens (#83)
• AWS CLI usage section in README (#77)
• List object paging (#97)
• Lifetime for the tokens in auth-mate (#108)
• Support of range in GetObject request (#96)
• Support of NEP-6 wallets instead of binary encoded keys (#92)
• Support of JSON encoded rules in auth-mate (#71)
• Support of delimiters in ListObjects (#98)
• Support of object ETag (#93)
• Support of time-based conditional CopyObject and GetObject (#94)

Changed

• Accesskey format: now 0 used as a delimiter between container ID and object ID instead of _ (#164)
• Accessbox is encoded in protobuf format (#48)
• Authentication uses secp256r1 instead of ed25519 (#75)
• Improved integration with NeoFS SDK and NeoFS API Go (#78, #88)
• Optimized object put execution (#155)

Removed

• GRPC keepalive options (#73)

0.15.0 (10 Jun 2021)

This release brings S3 gateway to the current state of NeoFS and fixes some bugs, no new significant features introduced (other than moving here already existing authmate component).

New features:

• authmate was moved into this repository and is now built along with the gateway itself (#46)

Behavior changes:

• neofs-s3-gate was renamed to neofs-s3-gw (#50)

Improvements:

• better Makefile (#43, #45, #55)
• stricter linters (#45)
• removed non-standard errors package from dependencies (#54)
• refactoring, reusing new sdk-go component (#60, #62, #63)
• updated neofs-api-go for compatibility with current NeoFS node 0.21.0 (#60, #68)
• extended README (#67, #76)

Bugs fixed:

• wrong (as per AWS specification) access key ID generated (#64)

Older versions

Please refer to Github releases for older releases.