Skip to content

Commit 8c9ca05

Browse files
committed
Use "stored" rather than "persisted" consistently with the rest of the document.
1 parent da71752 commit 8c9ca05

File tree

1 file changed

+8
-9
lines changed

1 file changed

+8
-9
lines changed

content/en/docs/tasks/extend-kubernetes/custom-resources/custom-resource-definition-versioning.md

Lines changed: 8 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -356,7 +356,7 @@ spec:
356356

357357
### Version removal
358358

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.
360360

361361
```yaml
362362
apiVersion: apiextensions.k8s.io/v1
@@ -1021,16 +1021,16 @@ Example of a response from a webhook indicating a conversion request failed, wit
10211021

10221022
## Writing, reading, and updating versioned CustomResourceDefinition objects
10231023

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
10251025
storage version at the time of the write. If the storage version changes,
10261026
existing objects are never converted automatically. However, newly-created
10271027
or updated objects are written at the new storage version. It is possible for an
10281028
object to have been written at a version that is no longer served.
10291029

10301030
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,
10321032
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
10341034
(other than changing the `apiVersion` string) while serving the request.
10351035
You can request an object at any version that is currently served.
10361036

@@ -1040,23 +1040,22 @@ one version to another.
10401040

10411041
To illustrate this, consider the following hypothetical series of events:
10421042

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`
10451044
2. You add version `v1` to your CustomResourceDefinition and designate it as
10461045
the storage version.
10471046
3. You read your object at version `v1beta1`, then you read the object again at
10481047
version `v1`. Both returned objects are identical except for the apiVersion
10491048
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
10511050
have two objects, one of which is at `v1beta1`, and the other of which is at
10521051
`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
10541053
is the current storage version.
10551054

10561055
### Previous storage versions
10571056

10581057
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
10601059
at any version that has ever been designated as a storage version. No objects
10611060
can exist in storage at a version that has never been a storage version.
10621061

0 commit comments

Comments
 (0)