Skip to content

Releases: container-storage-interface/spec

v1.4.0-rc1

04 Mar 22:59
2816e42

Choose a tag to compare

v1.4.0-rc1 Pre-release
Pre-release
Merge pull request #470 from pohly/maximum-volume-size

GetCapacityResponse: add maximum_volume_size

v1.3.0

03 Jun 21:16
1763e8e

Choose a tag to compare

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_CONDITION controller and node capability along with new ControllerGetVolume call and new volume_condition fields in ListVolumesResponse to enable CO to periodically probe a provisioned volumes health status.
  • spec (PR #412): Add additional reason to return ALREADY_EXISTS for CreateVolumeRequest.
  • spec (PR #422): Add Nomad to Container Orchestrators who've adopted CSI.

Clarifications/Corrections/Fixes:

  • spec (PR #397): Clarify idempotency requirement for ControllerExpandVolume and NodeExpandVolume.
  • spec (PR #406): Clarify the sources of volume_context.

Dependencies:

  • spec (PR #438): Pin go-genproto and grpc-go versions to 24fa4b261c55da65468f2abfdae2b024eef27dfb to ensure compatiblity with protobuf v1.3.2

v1.3.0-rc1

01 Jun 17:42
1763e8e

Choose a tag to compare

v1.3.0-rc1 Pre-release
Pre-release
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

23 Oct 22:00
314ac54

Choose a tag to compare

Breaking changes/Deprecations:

  • None (CSI 1.x releases are backwards compatible).

Additions:

  • spec (PR #372): Add optional secrets field to ListSnapshotsRequest.
  • spec (PR #374): Add optional (but recommended) VolumeStatus.published_node_ids field to ListVolumesResponse (to enable COs to detect and reconcile when a volume is unpublished out of band).
  • spec (PR #390): Add optional (but recommended) staging_path to NodeGetVolumeStatsRequest and NodeExpandVolumeRequest.
  • spec (PR #381): Add optional volume_capability to ControllerExpandVolumeRequest and NodeExpandVolumeRequest (to enable SPs to differentiate between block and file).

Clarifications/Corrections/Fixes:

  • spec (PR #347): Clarify DeleteVolume behavior with snapshots.
  • spec (PR #375): Clarify SP is allowed to return OK for ControllerUnpublishResponse if node or volume not found.
  • spec (PR #383): Relax recovery behavior for NOT_FOUND error code for ControllerUnpublishVolume from MUST to SHOULD.

Dependencies:

  • lib/go (PR #378) Update protoc to v3.9.1, protoc-gen-go to v1.3.2.

v1.2.0-rc2

21 Oct 21:29
314ac54

Choose a tag to compare

v1.2.0-rc2 Pre-release
Pre-release
Merge pull request #393 from container-storage-interface/master

Cherry pick #392 to release-1.2

v1.2.0-rc1

18 Oct 21:38
ae4d010

Choose a tag to compare

v1.2.0-rc1 Pre-release
Pre-release
Merge pull request #381 from gnufied/add-volume-capability-to-expansi…

v1.1.0

08 Mar 23:29

Choose a tag to compare

Breaking changes/Deprecations:

  • None (CSI 1.x releases are backwards compatible).

Additions:

  • spec (#334): Introduce a new VolumeExpansion plugin capability along with new ControllerExpandVolume and NodeExpandVolume calls to enable resizing (expansion) of a provisioned volume.

Clarifications/Corrections/Fixes:

  • spec: Corrected some spelling and grammar mistakes.

v1.1.0-rc1

05 Mar 23:12
c751be1

Choose a tag to compare

v1.1.0-rc1 Pre-release
Pre-release
Merge pull request #353 from msolefonte/fix/zone-correction

Fix a mistake in spec.md

v1.0.0

15 Nov 19:25
ed0bb0e

Choose a tag to compare

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_use boolean.
  • 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_at changed to timestamp and renamed to creation_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_path and SP is responsible for creating the directory or file at target_path and 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.readonly field.

Clarifications/Corrections/Fixes:

  • spec (PR #318): Rename volume_attributes and publish_info to volume_context and publish_context.
  • spec (PR #318): Rename id to volume_id and snapshot_id in Volume and Snapshot messages.
  • spec (PR #318): Clarify ID (volume, snapshot, & node) requirements.
  • spec (PR #306): Rename ACCESSIBILITY_CONSTRAINTS to VOLUME_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_path that 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:

v1.0.0-rc3

15 Nov 05:33
9aeb8c9

Choose a tag to compare

v1.0.0-rc3 Pre-release
Pre-release

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_path and SP is responsible for creating the directory at target_path and cleaning it up. (PR #335)
  • spec: Clarify that CO is responsible for creating a directory at staging_target_path that SP may use for staging purposes. (PR #335)