-
Garage v0.9.0 Stable
released this
2023-10-10 13:21:45 +00:00 | 429 commits to main since this releaseThis release is the final version of Garage v0.9.0.
Make sure to follow the upgrade procedure to upgrade a v0.8.x cluster to v0.9.0.
Garage v0.9.0 includes the following BREAKING CHANGES:
-
LMDB is now the default metadata db engine and Sled is deprecated. Make sure you are using the correct value of
db_engine
in your config file before updating. Sled will be removed in Garage v1.0. -
Capacity values are now in actual byte units. The translation from the old layout will assign 1 capacity = 1Gb by default, which might be wrong for your cluster. This does not cause any data to be moved around, but users might want to re-assign correct capacities to all their nodes to be future-proof.
-
Multipart uploads that were started in Garage v0.8 will not be visible in Garage v0.9 and will have to be restarted from scratch.
-
Updated admin API endpoints, prefixed by
v1/
. For endpoints with incompatible syntax, thev0/
endpoints have been disabled; for others thev0/
URLs are translated automatically to theirv1/
counterpart. Endpoints underv0/
will be removed in Garage v1.0.- affected admin endpoints: GetClusterStatus, GetClusterHealth, GetClusterLayout, UpdateClusterLayout, ApplyClusterLayout, GetKeyInfo, UpdateKey, CreateKey, ImportKey
-
Changes to the
garage key
CLI:garage key new
is renamed togarage key create
to be the same asgarage bucket create
garage key import
will not work without the--yes
flag and will reject invalid keys (keys that are not generated by Garage)garage key info
will no longer display the secret key by default (fix #506)
Other changes since v0.8.4:
- Optimal layout assignation algorithm (#296)
- Full multipart upload semantics (#204, #553)
- Support for multiple HDDs per server (#218, #625)
- Support for basic lifecycle configurations (#309, #620)
- Uniformized serialization conventions in admin API (#377, #381)
- Added checks to
garage key import
(#278), renamedgarage key new
intogarage key create
(#459) - Added the
convert_db
subcommand to the main Garage binary (#645) - Added support for binding API servers to UNIX sockets (#253, #640)
- Update
rmp-serde
from 0.15 to 1.1.2 - s/assignation/assignment (#465)
- Many updates to the documentation
- Many smaller changes not tracked by issues or PRs
Thanks to all of the contributors that have participated in this new version: Florian Klink, Jonathan Davies, Mendes, networkException.
Downloads
-