New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Any official docs around Kind: List? #837
Comments
Kubernetes documentation has examples that use this, however there is nothing explicitly about it as @slmingol mentioned. apiVersion: v1
kind: List
items:
- apiVersion: stable.example.com/v1
kind: CronTab
metadata:
creationTimestamp: 2017-05-31T12:56:35Z
generation: 1
name: my-new-cron-object
namespace: default
resourceVersion: "285"
uid: 9423255b-4600-11e7-af6a-28d2447dc82b
spec:
cronSpec: '* * * * */5'
image: my-awesome-cron-image
metadata:
resourceVersion: "" |
I think this is because List is not actually a "resource". Each resource can have an associated list type, PodList or CronJobList, but those are not actually resources. And each of those lists is represented in yaml by If you do a
|
@brianpursley : While the explanation why nothing has been done before, what should be done to document this somewhere going forward? |
I literally just went searching for the exact same thing. Would be nice if there was something mentioned about |
I think Brian's explanation nicely covers the topic. |
@soltysh: Closing this issue. In response to this:
Instructions for interacting with me using PR comments are available here. If you have questions or suggestions related to my behavior, please file an issue against the kubernetes/test-infra repository. |
The explanation is only part of the issue; the lack of documenting it is the premise. |
BTW I'd document this detail in https://kubernetes.io/docs/reference/using-api/api-concepts/ and have kubectl just link there. That said, if |
But this lists all the actual kind in the system? |
To anyone else stumbling across this. Official documentation for
|
Also see the note in https://kubernetes.io/docs/reference/using-api/api-concepts/#collections |
Couldn't find any information on how to make use of
kubectl explain list
.The text was updated successfully, but these errors were encountered: