You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: content/en/docs/tasks/extend-kubernetes/custom-resources/custom-resource-definition-versioning.md
+8-9Lines changed: 8 additions & 9 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -356,7 +356,7 @@ spec:
356
356
357
357
### Version removal
358
358
359
-
An older API version cannot be dropped from a CustomResourceDefinition manifest until existing persisted data has been migrated to the newer API version for all clusters that served the older version of the custom resource, and the old version is removed from the `status.storedVersions` of the CustomResourceDefinition.
359
+
An older API version cannot be dropped from a CustomResourceDefinition manifest until existing stored data has been migrated to the newer API version for all clusters that served the older version of the custom resource, and the old version is removed from the `status.storedVersions` of the CustomResourceDefinition.
360
360
361
361
```yaml
362
362
apiVersion: apiextensions.k8s.io/v1
@@ -1021,16 +1021,16 @@ Example of a response from a webhook indicating a conversion request failed, wit
1021
1021
1022
1022
## Writing, reading, and updating versioned CustomResourceDefinition objects
1023
1023
1024
-
When an object is written, it is persisted at the version designated as the
1024
+
When an object is written, it is stored at the version designated as the
1025
1025
storage version at the time of the write. If the storage version changes,
1026
1026
existing objects are never converted automatically. However, newly-created
1027
1027
or updated objects are written at the new storage version. It is possible for an
1028
1028
object to have been written at a version that is no longer served.
1029
1029
1030
1030
When you read an object, you specify the version as part of the path. If you
1031
-
specify a version that is different from the object's persisted version,
1031
+
specify a version that is different from the object's stored version,
1032
1032
Kubernetes returns the object to you at the version you requested, but the
1033
-
persisted object is neither changed on disk, nor converted in any way
1033
+
stored object is neither changed on disk, nor converted in any way
1034
1034
(other than changing the `apiVersion` string) while serving the request.
1035
1035
You can request an object at any version that is currently served.
1036
1036
@@ -1040,23 +1040,22 @@ one version to another.
1040
1040
1041
1041
To illustrate this, consider the following hypothetical series of events:
1042
1042
1043
-
1. The storage version is `v1beta1`. You create an object. It is persisted in
1044
-
storage at version `v1beta1`
1043
+
1. The storage version is `v1beta1`. You create an object. It is stored at version `v1beta1`
1045
1044
2. You add version `v1` to your CustomResourceDefinition and designate it as
1046
1045
the storage version.
1047
1046
3. You read your object at version `v1beta1`, then you read the object again at
1048
1047
version `v1`. Both returned objects are identical except for the apiVersion
1049
1048
field.
1050
-
4. You create a new object. It is persisted in storage at version `v1`. You now
1049
+
4. You create a new object. It is stored at version `v1`. You now
1051
1050
have two objects, one of which is at `v1beta1`, and the other of which is at
1052
1051
`v1`.
1053
-
5. You update the first object. It is now persisted at version `v1` since that
1052
+
5. You update the first object. It is now stored at version `v1` since that
1054
1053
is the current storage version.
1055
1054
1056
1055
### Previous storage versions
1057
1056
1058
1057
The API server records each version which has ever been marked as the storage
1059
-
version in the status field `storedVersions`. Objects may have been persisted
1058
+
version in the status field `storedVersions`. Objects may have been stored
1060
1059
at any version that has ever been designated as a storage version. No objects
1061
1060
can exist in storage at a version that has never been a storage version.
0 commit comments