Releases: container-storage-interface/spec
Releases · container-storage-interface/spec
v1.4.0-rc1
Merge pull request #470 from pohly/maximum-volume-size GetCapacityResponse: add maximum_volume_size
v1.3.0
Breaking changes/Deprecations:
- There are plans to deprecate Volume Expansion "online/offline" capability (moving to online by default, while allowing for offline via the "Volume In Use" error code). These changes are NOT being made in this CSI release (CSI v1.3.x), instead they will most likely be part of the next minor release (CSI v1.4.x). If you depend on "offline/volume expansion" please follow the relevant discussions (e.g. #429, #431, etc.), and read the CSI 1.4.x release notes carefully.
Additions:
- spec (PR #417): Introduce alpha protobuf annotations to enable new APIs to be introduced experimentally before evolving to something more stable. Note that Alpha APIs may change in incompatible ways or be removed between minor releases without notice.
- spec (PR #415): [Alpha] Introduce a new
VOLUME_CONDITIONcontroller and node capability along with newControllerGetVolumecall and newvolume_conditionfields inListVolumesResponseto enable CO to periodically probe a provisioned volumes health status. - spec (PR #412): Add additional reason to return
ALREADY_EXISTSforCreateVolumeRequest. - spec (PR #422): Add Nomad to Container Orchestrators who've adopted CSI.
Clarifications/Corrections/Fixes:
- spec (PR #397): Clarify idempotency requirement for
ControllerExpandVolumeandNodeExpandVolume. - spec (PR #406): Clarify the sources of
volume_context.
Dependencies:
- spec (PR #438): Pin
go-genprotoandgrpc-goversions to24fa4b261c55da65468f2abfdae2b024eef27dfbto ensure compatiblity with protobuf v1.3.2
v1.3.0-rc1
Merge pull request #439 from gnufied/add-note-about-gopath Add a note about CSI go language bindings should be built in GOPATH
v1.2.0
Breaking changes/Deprecations:
- None (CSI 1.x releases are backwards compatible).
Additions:
- spec (PR #372): Add optional
secretsfield toListSnapshotsRequest. - spec (PR #374): Add optional (but recommended)
VolumeStatus.published_node_idsfield toListVolumesResponse(to enable COs to detect and reconcile when a volume is unpublished out of band). - spec (PR #390): Add optional (but recommended)
staging_pathtoNodeGetVolumeStatsRequestandNodeExpandVolumeRequest. - spec (PR #381): Add optional
volume_capabilitytoControllerExpandVolumeRequestandNodeExpandVolumeRequest(to enable SPs to differentiate between block and file).
Clarifications/Corrections/Fixes:
- spec (PR #347): Clarify
DeleteVolumebehavior with snapshots. - spec (PR #375): Clarify SP is allowed to return
OKforControllerUnpublishResponseif node or volume not found. - spec (PR #383): Relax recovery behavior for
NOT_FOUNDerror code forControllerUnpublishVolumefromMUSTtoSHOULD.
Dependencies:
- lib/go (PR #378) Update protoc to v3.9.1, protoc-gen-go to v1.3.2.
v1.2.0-rc2
Merge pull request #393 from container-storage-interface/master Cherry pick #392 to release-1.2
v1.2.0-rc1
Merge pull request #381 from gnufied/add-volume-capability-to-expansi…
v1.1.0
Breaking changes/Deprecations:
- None (CSI 1.x releases are backwards compatible).
Additions:
- spec (#334): Introduce a new
VolumeExpansionplugin capability along with newControllerExpandVolumeandNodeExpandVolumecalls to enable resizing (expansion) of a provisioned volume.
Clarifications/Corrections/Fixes:
- spec: Corrected some spelling and grammar mistakes.
v1.1.0-rc1
Merge pull request #353 from msolefonte/fix/zone-correction Fix a mistake in spec.md
v1.0.0
Breaking changes/Deprecations:
- spec (PR #260): Change "reverse domain notation" requirement to "forward domain notation".
- spec (PR #307): Remove SnapshotStatus enum; replace with
ready_to_useboolean. - spec (PR #271): Add and change ValidateVolumeCapabilitiesRequest fields.
- spec (PR #309): Remove deprecated NodeGetId method.
- spec (PR #321): Bump csi protobuf package name to
csi.v1. - spec (PR #331): Snapshot
created_atchanged to timestamp and renamed tocreation_time. - spec (PR #328): GetPluginCapabilitiesResponse field number reordering.
- spec (PR #328): ControllerGetCapabilitiesResponse field number reordering.
- spec (PR #335): Specify that CO will only create the parent directory of
target_pathand SP is responsible for creating the directory or file attarget_pathand cleaning it up.
Additions:
- spec (PR #244): Initial support for volume cloning.
- spec (PR #256): New NodeGetVolumeStats call to fetch volume usage and capacity.
- spec (PR #310): Add capability for
ControllerPublishVolume.readonlyfield.
Clarifications/Corrections/Fixes:
- spec (PR #318): Rename
volume_attributesandpublish_infotovolume_contextandpublish_context. - spec (PR #318): Rename
idtovolume_idandsnapshot_idinVolumeandSnapshotmessages. - spec (PR #318): Clarify ID (volume, snapshot, & node) requirements.
- spec (PR #306): Rename
ACCESSIBILITY_CONSTRAINTStoVOLUME_ACCESSIBILITY_CONSTRAINTS. - spec (PR #303): Disallow control characters in name fields.
- spec (PR #317): Decorate sensitive fields with
csi_secret. - spec (PR #296, PR #316): Revise common error codes.
- spec (PR #260): Exclude underscores (_) from allowed characters list in plugin name and topology key prefix.
- spec (PR #335): Clarify that CO is responsible for creating a directory at
staging_target_paththat SP may use for staging purposes. - spec (PR #323): Clarify timeout and retries.
- spec (PR #322): Clarify CreateVolume: idempotent recovery from errors.
- spec (PR #265): Clarify default scalar values tagged as REQUIRED or OPTIONAL.
- spec (PR #312): Clarify expectations w/ respect to consistency when paging results of ListXYZ calls.
- spec (PR #314, PR #315): Clarify VolumeCapability in CreateVolumeRequest and ControllerPUblishVolume.
- spec (PR #308): Clarify expectations for NodeGetInfo
- spec (PR #297): Clarify ListVolumes and ListSnapshots for consistency.
- lib/go (PR #311): Strip "/vXYZ" from golang import path.
- lib/go (PR #254): Protobuf bindings register fully qualified package root.
Dependencies:
- lib/go (PR #269): Build against golang v1.10.4.
- lib/go (PR #269): Update https://github.com/golang/protobuf dependency to v1.2.0.
v1.0.0-rc3
CSI spec v1.0.0 release candidate 3
Has the following additional changes:
- spec: Clarify that CO will only create the parent directory of
target_pathand SP is responsible for creating the directory attarget_pathand cleaning it up. (PR #335) - spec: Clarify that CO is responsible for creating a directory at
staging_target_paththat SP may use for staging purposes. (PR #335)