parent
c79948e2d7
commit
8450b22b0e
|
|
@ -32,6 +32,26 @@ Updated: 8/27/2015
|
|||
* `--namespace` should also override the value specified in a specified
|
||||
resource
|
||||
|
||||
* Most kubectl commands should be able to operate in bulk on resources, of mixed types.
|
||||
|
||||
* Kubectl should not make any decisions based on its nor the server's release version string. Instead, API
|
||||
discovery and/or OpenAPI should be used to determine available features.
|
||||
|
||||
* We currently only guarantee one release of version skew is supported, but we strive to make old releases of kubectl
|
||||
continue to work with newer servers in compliance with our API compatibility guarantees. This means, for instance, that
|
||||
kubectl should not fully parse objects returned by the server into full Go types and then re-encode them, since that
|
||||
would drop newly added fields. ([#3955](https://github.com/kubernetes/kubernetes/issues/3955))
|
||||
|
||||
* General-purpose kubectl commands (e.g., get, delete, create -f, replace, patch, apply) should work for all resource types,
|
||||
even those not present when that release of kubectl was built, such as APIs added in newer releases, aggregated APIs,
|
||||
and third-party resources.
|
||||
|
||||
* While functionality may be added to kubectl out of expedience, commonly needed functionality should be provided by
|
||||
the server to make it easily accessible to all API clients. ([#12143](https://github.com/kubernetes/kubernetes/issues/12143))
|
||||
|
||||
* Remaining non-trivial functionality remaining in kubectl should be made available to other clients via libraries
|
||||
([#7311](https://github.com/kubernetes/kubernetes/issues/7311))
|
||||
|
||||
## Command conventions
|
||||
|
||||
* Command names are all lowercase, and hyphenated if multiple words.
|
||||
|
|
|
|||
Loading…
Reference in New Issue