v0.27.0

The maintainers and contributors to go-ceph are pleased to announce the v0.27.0 release. This is another great step towards making it possible to use the power of the Ceph APIs in the Go language.

As this is a v0.x release we do not guarantee backwards compatibility with previous versions of the code. However, we aim not to disrupt existing consumers of the library and thus make an effort not to immediately implement breaking changes without very good justification. Please see the "Deprecations & Removals" section (if present) to get a sense of what you can expect to change in the future and prepare your code ahead of time. You may also want to view "Deprecations & Removals" of previous releases as they are not repeated here. All newly introduced APIs in the following section are labeled as "preview" APIs first, and are only available if the ceph_preview build tag is set. There is explicitly no backwards compatibility guaranteed for these until they are labeled as "stable" in a later release.

Special thanks to our new contributors:

• @jarrpa made their first contribution in #980
• @zxysilent made their first contribution in #977

New Features

cephfs/admin

• API for quiesceing io on a subvolume. by @manishym in #958
  • Adds FSQuiesce similar to ceph fs quiesce <volume>

rbd

• rbd: add GetSnapGroupNamespace() to get details about group snapshots by @nixpanic in #968
  • Adds GetSnapGroupNamespace implementing rbd_snap_get_group_namespace

API Stability Updates

The following APIs are now stable:

rbd

• Image.Resize2

rgw/admin

• API.GetInfo

Other Changes

rbd

• rbd: add a test to verify that encrypted volumes can be resized by @phlogistonjohn in #973
• rbd: prevent warning about redefining _POSIX_C_SOURCE by @nixpanic in #974
• rbd: remove features_nautilus.go by @jarrpa in #980
• rbd: trigger an error on invalid max snaps value by @zxysilent in #977

cephfs/admin

• cephfs/admin: Adjust build tags for subvolume quiescing API tests by @anoopcs9 in #976

Internal

• go-ceph: bump github.com/stretchr/testify from 1.8.4 to 1.9.0 by @dependabot in #964
• go-ceph: bump golang.org/x/sys from 0.16.0 to 0.18.0 by @dependabot in #969
• go-ceph: bump github.com/aws/aws-sdk-go from 1.50.9 to 1.50.32 by @dependabot in #970
• Add ceph squid CI jobs by @anoopcs9 in #963
• build: Bump golang version to 1.21 by @anoopcs9 in #971
• go-ceph: bump github.com/aws/aws-sdk-go from 1.50.32 to 1.51.12 by @dependabot in #978
• Prepare for release v0.27.0 by @phlogistonjohn in #982

Full Changelog: v0.26.0...v0.27.0

v0.26.0

The maintainers and contributors to go-ceph are pleased to announce the v0.26.0 release. This is another great step towards making it possible to use the power of the Ceph APIs in the Go language.

As this is a v0.x release we do not guarantee backwards compatibility with previous versions of the code. However, we aim not to disrupt existing consumers of the library and thus make an effort not to immediately implement breaking changes without very good justification. Please see the "Deprecations & Removals" section (if present) to get a sense of what you can expect to change in the future and prepare your code ahead of time. You may also want to view "Deprecations & Removals" of previous releases as they are not repeated here. All newly introduced APIs in the following section are labeled as "preview" APIs first, and are only available if the ceph_preview build tag is set. There is explicitly no backwards compatibility guaranteed for these until they are labeled as "stable" in a later release.

Special thanks to our new contributors:

• @manishym made their first contribution in #959

Changes

rgw/admin

• rgw/admin: Add support for user bucket quota by @anoopcs9 in #954
  • Adds GetBucketQuota (https://docs.ceph.com/en/latest/radosgw/adminops/#get-bucket-quota)
  • Adds SetBucketQuota (https://docs.ceph.com/en/latest/radosgw/adminops/#set-bucket-quota)

Internal

• go-ceph: bump github.com/aws/aws-sdk-go from 1.48.11 to 1.49.13 by @dependabot in #950
• go-ceph: bump actions/setup-go from 4 to 5 by @dependabot in #951
• go-ceph: bump actions/upload-artifact from 3 to 4 by @dependabot in #952
• go-ceph: bump actions/stale from 8 to 9 by @dependabot in #953
• go-ceph: bump golang.org/x/sys from 0.15.0 to 0.16.0 by @dependabot in #956
• go-ceph: bump github.com/aws/aws-sdk-go from 1.49.13 to 1.50.9 by @dependabot in #957
• Code Lint: Fix lint errors caused by revive check for unused parameters by @manishym in #959
• rgw/admin: Fixup for 6f90ce1 by @ansiwen in #960

Full Changelog: v0.25.0...v0.26.0

Release v0.25.0

The maintainers and contributors to go-ceph are pleased to announce the v0.25.0 release. This is another great step towards making it possible to use the power of the Ceph APIs in the Go language.

As this is a v0.x release we do not guarantee backwards compatibility with previous versions of the code. However, we aim not to disrupt existing consumers of the library and thus make an effort not to immediately implement breaking changes without very good justification. Please see the "Deprecations & Removals" section (if present) to get a sense of what you can expect to change in the future and prepare your code ahead of time. You may also want to view "Deprecations & Removals" of previous releases as they are not repeated here. All newly introduced APIs in the following section are labeled as "preview" APIs first, and are only available if the ceph_preview build tag is set. There is explicitly no backwards compatibility guaranteed for these until they are labeled as "stable" in a later release.

Special thanks to our new contributors:

• @khayyamsaleem made their first contribution in #934

Changes

cephfs

• cephfs: made ENOENT a public error by @riya-singhal31 in #940

rbd

• rbd: adds support for librbd rbd_resize2 by @khayyamsaleem in #934
  • Adds Resize2 implementing rbd_resize2.
• rbd: Fix a typo in comment for Image.Resize2 by @anoopcs9 in #947

rgw/admin

• rgw/admin: Add support for /info section by @anoopcs9 in #936
  • Adds the GetInfo method.

Internal

• internal: use runtime.Pinner in PtrGuard by @ansiwen in #935
• go-ceph: bump golang.org/x/sys from 0.12.0 to 0.13.0 by @dependabot in #939
• go-ceph: bump github.com/aws/aws-sdk-go from 1.45.19 to 1.47.1 by @dependabot in #938
• CI: enable and collect core dumps in tests by @ansiwen in #941
• CI: add a workflow option for tmate debugging by @ansiwen in #942
• go-ceph: bump golang.org/x/sys from 0.13.0 to 0.15.0 by @dependabot in #944
• go-ceph: bump github.com/aws/aws-sdk-go from 1.47.1 to 1.48.11 by @dependabot in #943
• Miscellaneous fixes by @anoopcs9 in #945
• docs: Update README.md for v0.25.0 by @anoopcs9 in #946

Full Changelog: v0.24.0...v0.25.0

Release v0.24.0

The maintainers and contributors to go-ceph are pleased to announce the v0.24.0 release. This is another great step towards making it possible to use the power of the Ceph APIs in the Go language.

As this is a v0.x release we do not guarantee backwards compatibility with previous versions of the code. However, we aim not to disrupt existing consumers of the library and thus make an effort not to immediately implement breaking changes without very good justification. Please see the "Deprecations & Removals" section (if present) to get a sense of what you can expect to change in the future and prepare your code ahead of time. You may also want to view "Deprecations & Removals" of previous releases as they are not repeated here. All newly introduced APIs in the following section are labeled as "preview" APIs first, and are only available if the ceph_preview build tag is set. There is explicitly no backwards compatibility guaranteed for these until they are labeled as "stable" in a later release.

Special thanks to our new contributors:

• @krafZLorG made their first contribution in #898
• @DanWritesCode made their first contribution in #924

Changes

RGW Admin

• RGW/admin: add tenant to bucket struct field by @krafZLorG in #898

rados

• rados: skip TestPingMonitor test by @ansiwen in #920

rbd

• rbd: Fix global image status listing by @DanWritesCode in #924

Internal

• containers: workaround for ganesha package error on reef by @phlogistonjohn in #913
• github: require reef job to pass in mergify config by @phlogistonjohn in #910
• workflows: enable stale bot for PRs by @phlogistonjohn in #914
• go-ceph: bump golang.org/x/sys from 0.10.0 to 0.11.0 by @dependabot in #915
• go-ceph: bump github.com/aws/aws-sdk-go from 1.44.314 to 1.45.2 by @dependabot in #916
• workflows: Move actions/checkout before actions/setup-go by @anoopcs9 in #918
• go-ceph: bump actions/checkout from 3 to 4 by @dependabot in #925
• go-ceph: bump golang.org/x/sys from 0.11.0 to 0.12.0 by @dependabot in #926
• go-ceph: bump github.com/aws/aws-sdk-go from 1.45.2 to 1.45.19 by @dependabot in #927
• API updates by @phlogistonjohn in #929
• docs: update readme supported versions by @phlogistonjohn in #930

Deprecations and Removals

• The New method in the cephfs/admin module, that was previously deprecated, has been removed according to schedule. Use NewFromConn if you had been previously using New.

Full Changelog: v0.23.0...v0.24.0

Release v0.23.0

The maintainers and contributors to go-ceph are pleased to announce the v0.23.0 release. This is another great step towards making it possible to use the power of the Ceph APIs in the Go language.

As this is a v0.x release we do not guarantee backwards compatibility with previous versions of the code. However, we aim not to disrupt existing consumers of the library and thus make an effort not to immediately implement breaking changes without very good justification. Please see the "Deprecations & Removals" section (if present) to get a sense of what you can expect to change in the future and prepare your code ahead of time. You may also want to view "Deprecations & Removals" of previous releases as they are not repeated here. All newly introduced APIs in the following section are labeled as "preview" APIs first, and are only available if the ceph_preview build tag is set. There is explicitly no backwards compatibility guaranteed for these until they are labeled as "stable" in a later release.

Notice: With the recently released latest Go version 1.21 we are seeing a CI test in the rados package regularly failing with a segmentation fault. We believe it is an old issue in our tests that now shows up differently. But just in case you are experiencing new stability issues in the rados package with the latest Go version, consider going back to Go 1.20 for now. We expect this issue to be investigated and solved in the next go-ceph release.

API Stability Updates

The following APIs are now stable:

rbd

• SiteMirrorImageStatus.UnmarshalDescriptionJSON
• SiteMirrorImageStatus.DescriptionReplayStatus
• AddMirrorPeerSite
• RemoveMirrorPeerSite
• GetAttributesMirrorPeerSite
• SetAttributesMirrorPeerSite
• ListMirrorPeerSite
• SetMirrorPeerSiteClientName
• SetMirrorPeerSiteName
• SetMirrorPeerSiteDirection
• Image.SparsifyWithProgress

cephfs

• MountInfo.MakeDirs

cephfs/admin

• FSAdmin.PinSubVolume
• FSAdmin.PinSubVolumeGroup
• FSAdmin.FetchVolumeInfo

Other Changes

rbd

• rbd: Remove redundant LastSeen property from MirrorPeerSite struct by @Nikhil-Ladha in #871
• rbd: include details for parent image in the trash by @nixpanic in #906

rgw/admin

• rgw/admin: fix getbucketpolicy api by @thotz in #886

Internal

• go-ceph: add Ceph Reef CI jobs by @phlogistonjohn in #907
• chore: remove refs to deprecated io/ioutil by @testwill in #896
• CI: add tests for different Go versions by @ansiwen in #911
• go-ceph: bump github.com/aws/aws-sdk-go from 1.44.275 to 1.44.294 by @dependabot in #895
• go-ceph: bump golang.org/x/sys from 0.8.0 to 0.9.0 by @dependabot in #894
• go-ceph: bump github.com/aws/aws-sdk-go from 1.44.294 to 1.44.314 by @dependabot in #909
• go-ceph: bump golang.org/x/sys from 0.9.0 to 0.10.0 by @dependabot in #908

New Contributors

• @testwill made their first contribution in #896

Full Changelog: v0.22.0...v0.23.0

Release v0.22.0

The maintainers and contributors to go-ceph are pleased to announce the v0.22.0 release. This is another great step towards making it possible to use the power of the Ceph APIs in the Go language.

As this is a v0.x release we do not guarantee backwards compatibility with previous versions of the code. However, we aim not to disrupt existing consumers of the library and thus make an effort not to immediately implement breaking changes without very good justification. Please see the "Deprecations & Removals" section (if present) to get a sense of what you can expect to change in the future and prepare your code ahead of time. You may also want to view "Deprecations & Removals" of previous releases as they are not repeated here. All newly introduced APIs in the following section are labeled as "preview" APIs first, and are only available if the ceph_preview build tag is set. There is explicitly no backwards compatibility guaranteed for these until they are labeled as "stable" in a later release.

New Features

cephfs

• cephfs: Add mknod cephfs API by @Nikhil-Ladha in #866
  • Adds Mknod implementing ceph_mknod
• cephfs: Add futime cephfs API by @Nikhil-Ladha in #869
  • Adds Futime implementing ceph_futime
• cephfs: Add futimens cephfs API by @Nikhil-Ladha in #874
  • Adds Futimens implementing ceph_futimens
• cephfs: Add futimes cephfs API by @Nikhil-Ladha in #875
  • Adds Futimes implementing ceph_futimes

rbd

• rbd: Add locking rbd APIs by @Nikhil-Ladha in #852
  • Adds LockAcquire implementing rbd_lock_acquire
  • Adds LockBreak implementing rbd_lock_break
  • Adds LockGetOwners implementing rbd_lock_get_owners
  • Adds LockIsExclusiveOwner implementing rbd_is_exclusive_lock_owner
  • Adds LockRelease implementing rbd_lock_release

Other Changes

rbd

• rbd: Remove redundant LastSeen property from MirrorPeerSite struct by @Nikhil-Ladha in #871

Internal

• micro-osd.sh: Use ipv4 address for mon addr configuration by @anoopcs9 in #876
• go-ceph: bump golang.org/x/sys from 0.6.0 to 0.7.0 by @dependabot in #878
• go-ceph: bump github.com/aws/aws-sdk-go from 1.44.234 to 1.44.254 by @dependabot in #877
• Remove useless test file package_test.go by @anoopcs9 in #880
• docs: add some docs on how to find apis by @phlogistonjohn in #873
• go-ceph: bump golang.org/x/sys from 0.7.0 to 0.8.0 by @dependabot in #883
• go-ceph: bump github.com/stretchr/testify from 1.8.2 to 1.8.4 by @dependabot in #884
• go-ceph: bump github.com/aws/aws-sdk-go from 1.44.254 to 1.44.275 by @dependabot in #887
• docs: Fix versions for newest API additions by @anoopcs9 in #890
• Make preview APIs stable for v0.22 by @anoopcs9 in #889
• Update README.md for v0.22.0 release by @anoopcs9 in #891

Full Changelog: v0.21.0...v0.22.0

Release v0.21.0

The maintainers and contributors to go-ceph are pleased to announce the v0.21.0 release. This is another great step towards making it possible to use the power of the Ceph APIs in the Go language.

Special thanks to our new contributors:

• @maitredede made their first contribution in #832
• @Nikhil-Ladha made their first contribution in #848

As this is a v0.x release we do not guarantee backwards compatibility with previous versions of the code. However, we aim not to disrupt existing consumers of the library and thus make an effort not to immediately implement breaking changes without very good justification. Please see the "Deprecations & Removals" section (if present) to get a sense of what you can expect to change in the future and prepare your code ahead of time. You may also want to view "Deprecations & Removals" of previous releases as they are not repeated here. All newly introduced APIs in the following section are labeled as "preview" APIs first, and are only available if the ceph_preview build tag is set. There is explicitly no backwards compatibility guaranteed for these until they are labeled as "stable" in a later release.

New Features

rbd

• rbd: add functions to parse json in mirroring status description field by @phlogistonjohn in #842
  • Adds UnmarshalDescriptionJSON method to SiteMirrorImageStatus
  • Adds DescriptionReplayStatus method to SiteMirrorImageStatus
• rbd: Add mirror peer site API components by @Nikhil-Ladha in #850
  • Adds AddMirrorPeerSite implementing rbd_mirror_peer_site_add
  • Adds RemoveMirrorPeerSite implementing rbd_mirror_peer_site_remove
  • Adds GetAttributesMirrorPeerSite implementing rbd_mirror_peer_site_get_attributes
  • Adds SetAttributesMirrorPeerSite implementing rbd_mirror_peer_site_set_attributes
  • Adds ListMirrorPeerSite implementing rbd_mirror_peer_site_list
  • Adds SetMirrorPeerSiteClientName implementing rbd_mirror_peer_site_set_client_name
  • Adds SetMirrorPeerSiteDirection implementing rbd_mirror_peer_site_set_direction
  • Adds SetMirrorPeerSiteName implementing rbd_mirror_peer_site_set_name
• rbd: Add rbd_sparsify_with_progress rbd API by @Nikhil-Ladha in #851
  • Adds SparsifyWithProgress implementing rbd_sparsify_with_progress

cephfs

• cephfs: implementation of mkdirs by @maitredede in #832
  • Adds MakeDirs implementing ceph_mkdirs

cephfs/admin

• cephfs/admin: Add Subvolume{Group} pinning API by @anoopcs9 in #844
  • Adds PinSubVolume similar to ceph fs subvolume pin
  • Adds PinSubVolumeGroup similar to ceph fs subvolumegroup pin
• cephfs/admin: Add API to fetch volume info by @anoopcs9 in #846
  • Adds FetchVolumeInfo similar to ceph fs volume info

Deprecations & Removals

cephfs/admin

• cephfs admin: deprecate the New function by @phlogistonjohn in #849

Other Changes

rados

• rados: free object list results after listing by @nickjanus in #845

rgw/admin

• rgw/admin: Add missing uid member to usage struct by @Nikhil-Ladha in #848

Internal

• Go: bump tested Go version to 1.19.5 by @ansiwen in #831
• build: propagation of GOPROXY env var by @maitredede in #834
• go-ceph: bump github.com/aws/aws-sdk-go from 1.44.197 to 1.44.212 by @dependabot in #839
• go-ceph: bump github.com/stretchr/testify from 1.8.1 to 1.8.2 by @dependabot in #840
• Dockerfile: Add missing GOPROXY build argument by @anoopcs9 in #843
• go-ceph: bump golang.org/x/sys from 0.5.0 to 0.6.0 by @dependabot in #853
• go-ceph: bump actions/stale from 7 to 8 by @dependabot in #856
• go-ceph: bump github.com/aws/aws-sdk-go from 1.44.212 to 1.44.234 by @dependabot in #854
• go-ceph: bump actions/setup-go from 3 to 4 by @dependabot in #855
• docs: fix version numbers of recently added APIs by @phlogistonjohn in #860
• nfs admin: create directories used by nfs tests by @phlogistonjohn in #859
• rbd: document SparsifyWithProgress callback's arguments by @phlogistonjohn in #861
• docs: fix version for newest api additions by @phlogistonjohn in #863
• go-ceph: update README.md for v0.21.0 release by @phlogistonjohn in #865

Full Changelog: v0.20.0...v0.21.0

Release v0.20.0

The maintainers and contributors to go-ceph are pleased to announce the v0.20.0 release. This is another great step towards making it possible to use the power of the Ceph APIs in the Go language.

Special thanks to our new contributors:

• @omidyoosefi made their first contribution in #797
• @TheMoti made their first contribution in #801
• @synarete made their first contribution in #817

As this is a v0.x release we do not guarantee backwards compatibility with previous versions of the code. However, we aim not to disrupt existing consumers of the library and thus make an effort not to immediately implement breaking changes without very good justification. Please see the "Deprecations & Removals" section (if present) to get a sense of what you can expect to change in the future and prepare your code ahead of time. You may also want to view "Deprecations & Removals" of previous releases as they are not repeated here. All newly introduced APIs in the following section are labeled as "preview" APIs first, and are only available if the ceph_preview build tag is set. There is explicitly no backwards compatibility guaranteed for these until they are labeled as "stable" in a later release.

New Features

rbd

• rbd: implement live migration functions by @omidyoosefi in #797
  • Adds MigrationPrepare implementing rbd_migration_prepare
  • Adds MigrationPrepareImport implementing rbd_migration_prepare_import
  • Adds MigrationExecute implementing rbd_migration_execute
  • Adds MigrationCommit implementing rbd_migration_commit
  • Adds MigrationAbort implementing rbd_migration_abort
  • Adds MigrationStatus implementing rbd_migration_status

rgw/admin

• rgw: add "ListBucketsWithStat" function by @TheMoti in #801
  • Adds the API.ListBucketsWithStat method.

cephfs

• cephfs: add SelectFilesystem, a 2nd fs to micro-osd.sh etc, and tests by @phlogistonjohn in #827
  • Adds the MountInfo.SelectFilesystem method.
  • Special thanks to @aep for initiating this work!

general

• Build arm64 by @synarete in #817
  • Adds ARM support.

Other Changes

common/admin/nfs

• nfs admin: fix handling of non-existing psuedo_paths for export info by @phlogistonjohn in #821

cephfs/admin

• Add untracked Subvolume and Snapshot metadata APIs in api-status by @anoopcs9 in #811

internal

• Remove left over ceph_preview tags from test related files by @anoopcs9 in #799
• go-ceph: bump actions/stale from 6 to 7 by @dependabot in #804
• go-ceph: bump github.com/aws/aws-sdk-go from 1.44.151 to 1.44.172 by @dependabot in #805
• go-ceph: bump golang.org/x/sys from 0.2.0 to 0.4.0 by @dependabot in #806
• contrib: better warning for apiage by @phlogistonjohn in #808
• github: update PR template with new checklist item and helpful links by @phlogistonjohn in #809
• docs: fix version values for new rdb migration APIs by @phlogistonjohn in #813
• go-ceph: bump github.com/aws/aws-sdk-go from 1.44.172 to 1.44.192 by @dependabot in #823
• go-ceph: bump github.com/gofrs/uuid from 4.3.1+incompatible to 4.4.0+incompatible by @dependabot in #824
• github: fix linebreaks in pr template by @phlogistonjohn in #828
• github: remove deprecated and failing rebase_fallback attribute by @phlogistonjohn in #833
• docs: fix api versions for new ListBucketWithStat API by @anoopcs9 in #836

Full Changelog: v0.19.0...v0.20.0

Release v0.19.0

The maintainers and contributors to go-ceph are pleased to announce the v0.19.0 release. This is another great step towards making it possible to use the power of the Ceph APIs in the Go language.

As this is a v0.x release we do not guarantee backwards compatibility with previous versions of the code. However, we aim not to disrupt existing consumers of the library and thus make an effort not to immediately implement breaking changes without very good justification. Please see the "Deprecations & Removals" section (if present) to get a sense of what you can expect to change in the future and prepare your code ahead of time. You may also want to view "Deprecations & Removals" of previous releases as they are not repeated here. All newly introduced APIs(if any) in the following section are labeled as preview APIs first, and are only available if the ceph_preview build tag is set. There is explicitly no backwards compatibility guaranteed for these until they are labeled as stable in a later release.

API Stability Updates

rados

• The IOContext.SetAllocationHint is now stable
• The WriteOp.SetAllocationHint is now stable
• The IOContext.Alignment is now stable
• The IOContext.RequiresAlignment is now stable

rgw/admin

• The API.ListUserBuckets is now stable
• The API.ListUserBucketsWithStat is now stable
• The API.CreateKey is now stable
• The API.RemoveKey is now stable
• The API.SetIndividualBucketQuota is now stable

Deprecations and Removals

With go-ceph v0.19.0 support for Ceph "Octopus" is offically deprecated.

Other changes

Internal

• apiage: Remove empty tables from API status markdown by @anoopcs9 in #775
• go-ceph: update README.md for v0.18.0 release by @phlogistonjohn in #776
• docs: update the release document by @phlogistonjohn in #778
• github: enable dependabot for github-actions by @phlogistonjohn in #784
• go-ceph: bump github.com/stretchr/testify from 1.8.0 to 1.8.1 by @dependabot in #781
• go-ceph: bump actions/checkout from 2 to 3 by @dependabot in #786
• go-ceph: bump actions/stale from 3 to 6 by @dependabot in #787
• go-ceph: bump github.com/gofrs/uuid from 4.3.0+incompatible to 4.3.1+incompatible by @dependabot in #782
• go-ceph: bump github.com/aws/aws-sdk-go from 1.44.109 to 1.44.138 by @dependabot in #789
• ci: automatically file issues with api stability changes by @phlogistonjohn in #783
• go-ceph: bump github.com/aws/aws-sdk-go from 1.44.138 to 1.44.151 by @dependabot in #792
• go-ceph: bump golang.org/x/sys from 0.1.0 to 0.2.0 by @dependabot in #791
• cephfs admin: remove test skip in TestCancelClone by @phlogistonjohn in #684
• Update readme for next release (v0.19) by @phlogistonjohn in #796

Bug fixes

• rbd: increase maximum number of trash entries listable by @phlogistonjohn in #785

Full Changelog: v0.18.0...v0.19.0

Release v0.18.0

The maintainers and contributors to go-ceph are pleased to announce the v0.18.0 release. This is another great step towards making it possible to use the power of the Ceph APIs in the Go language.

As this is a v0.x release we do not guarantee backwards compatibility with previous versions of the code. However, we aim not to disrupt existing consumers of the library and thus make an effort not to immediately implement breaking changes without very good justification. Please see the "Deprecations & Removals" section (if present) to get a sense of what you can expect to change in the future and prepare your code ahead of time. You may also want to view "Deprecations & Removals" of previous releases as they are not repeated here. All newly introduced APIs in the following section are labeled as "preview" APIs first, and are only available if the ceph_preview build tag is set. There is explicitly no backwards compatibility guaranteed for these until they are labeled as "stable" in a later release.

New Features

common/admin/nfs package:

• nfs admin: add SecType field by @phlogistonjohn in #767
  • This new field is an API extension and currently only functions on development versions of Ceph

API Stability Updates

cephfs/admin

• The CloneStatus.GetFailure method is now stable

rbd

• The Snapshot.Remove method is now stable

common/admin/nfs

• All API methods in the package are now stable

Other Changes

Internal

• apiage: add commands to detect and report on APIs needing to be updated by @phlogistonjohn in #759
• go-ceph: bump github.com/aws/aws-sdk-go from 1.44.67 to 1.44.90 by @dependabot in #763
• readme: replace "office hours" with a new contact section by @phlogistonjohn in #765
• docs: add official documentation for how go-ceph does errors by @phlogistonjohn in #762
• apiage: ability to promote apis tracked in JSON from preview to stable by @phlogistonjohn in #761
• cephfs: fix a minor typo in a doc comment by @phlogistonjohn in #768
• go-ceph: bump github.com/gofrs/uuid from 4.2.0+incompatible to 4.3.0+incompatible by @dependabot in #769
• go-ceph: bump github.com/aws/aws-sdk-go from 1.44.90 to 1.44.109 by @dependabot in #770
• docs: add a reminder to keep local git in sync before tagging by @phlogistonjohn in #772
• apiage fixes by @phlogistonjohn in #774

Full Changelog: v0.17.0...v0.18.0