doc/tutorials/kubernetes: update comments

+12 -8

doc/tutorial/kubernetes/quick/pkg/k8s.io/api/apps/v1beta1/types_go_gen.cue

··· 43 43 44 44 // Scale represents a scaling request for a resource. 45 45 Scale: metav1.TypeMeta & { 46 - // Standard object metadata; More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#metadata. 46 + // Standard object metadata; More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata. 47 47 // +optional 48 48 metadata?: metav1.ObjectMeta @go(ObjectMeta) @protobuf(1,bytes,opt) 49 49 50 - // defines the behavior of the scale. More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#spec-and-status. 50 + // defines the behavior of the scale. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#spec-and-status. 51 51 // +optional 52 52 spec?: ScaleSpec @go(Spec) @protobuf(2,bytes,opt) 53 53 54 - // current status of the scale. More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#spec-and-status. Read-only. 54 + // current status of the scale. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#spec-and-status. Read-only. 55 55 // +optional 56 56 status?: ScaleStatus @go(Status) @protobuf(3,bytes,opt) 57 57 } ··· 109 109 110 110 // StatefulSetUpdateStrategyType is a string enumeration type that enumerates 111 111 // all possible update strategies for the StatefulSet controller. 112 - StatefulSetUpdateStrategyType: string 112 + StatefulSetUpdateStrategyType: string // enumStatefulSetUpdateStrategyType 113 + 114 + enumStatefulSetUpdateStrategyType: 115 + RollingUpdateStatefulSetStrategyType | 116 + OnDeleteStatefulSetStrategyType 113 117 114 118 // RollingUpdateStatefulSetStrategyType indicates that update will be 115 119 // applied to all Pods in the StatefulSet with respect to the StatefulSet 116 120 // ordering constraints. When a scale operation is performed with this 117 121 // strategy, new Pods will be created from the specification version indicated 118 122 // by the StatefulSet's updateRevision. 119 - RollingUpdateStatefulSetStrategyType: "RollingUpdate" 123 + RollingUpdateStatefulSetStrategyType: StatefulSetUpdateStrategyType & "RollingUpdate" 120 124 121 125 // OnDeleteStatefulSetStrategyType triggers the legacy behavior. Version 122 126 // tracking and ordered rolling restarts are disabled. Pods are recreated 123 127 // from the StatefulSetSpec when they are manually deleted. When a scale 124 128 // operation is performed with this strategy,specification version indicated 125 129 // by the StatefulSet's currentRevision. 126 - OnDeleteStatefulSetStrategyType: "OnDelete" 130 + OnDeleteStatefulSetStrategyType: StatefulSetUpdateStrategyType & "OnDelete" 127 131 128 132 // RollingUpdateStatefulSetStrategy is used to communicate parameter for RollingUpdateStatefulSetStrategyType. 129 133 RollingUpdateStatefulSetStrategy: { ··· 521 525 // depend on its stability. It is primarily for internal use by controllers. 522 526 ControllerRevision: metav1.TypeMeta & { 523 527 // Standard object's metadata. 524 - // More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#metadata 528 + // More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata 525 529 // +optional 526 530 metadata?: metav1.ObjectMeta @go(ObjectMeta) @protobuf(1,bytes,opt) 527 531 ··· 534 538 535 539 // ControllerRevisionList is a resource containing a list of ControllerRevision objects. 536 540 ControllerRevisionList: metav1.TypeMeta & { 537 - // More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#metadata 541 + // More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata 538 542 // +optional 539 543 metadata?: metav1.ListMeta @go(ListMeta) @protobuf(1,bytes,opt) 540 544

+219 -127

doc/tutorial/kubernetes/quick/pkg/k8s.io/api/core/v1/types_go_gen.cue

··· 78 78 79 79 // ISCSI represents an ISCSI Disk resource that is attached to a 80 80 // kubelet's host machine and then exposed to the pod. 81 - // More info: https://releases.k8s.io/HEAD/examples/volumes/iscsi/README.md 81 + // More info: https://examples.k8s.io/volumes/iscsi/README.md 82 82 // +optional 83 83 iscsi?: null | ISCSIVolumeSource @go(ISCSI,*ISCSIVolumeSource) @protobuf(8,bytes,opt) 84 84 85 85 // Glusterfs represents a Glusterfs mount on the host that shares a pod's lifetime. 86 - // More info: https://releases.k8s.io/HEAD/examples/volumes/glusterfs/README.md 86 + // More info: https://examples.k8s.io/volumes/glusterfs/README.md 87 87 // +optional 88 88 glusterfs?: null | GlusterfsVolumeSource @go(Glusterfs,*GlusterfsVolumeSource) @protobuf(9,bytes,opt) 89 89 ··· 94 94 persistentVolumeClaim?: null | PersistentVolumeClaimVolumeSource @go(PersistentVolumeClaim,*PersistentVolumeClaimVolumeSource) @protobuf(10,bytes,opt) 95 95 96 96 // RBD represents a Rados Block Device mount on the host that shares a pod's lifetime. 97 - // More info: https://releases.k8s.io/HEAD/examples/volumes/rbd/README.md 97 + // More info: https://examples.k8s.io/volumes/rbd/README.md 98 98 // +optional 99 99 rbd?: null | RBDVolumeSource @go(RBD,*RBDVolumeSource) @protobuf(11,bytes,opt) 100 100 ··· 103 103 // +optional 104 104 flexVolume?: null | FlexVolumeSource @go(FlexVolume,*FlexVolumeSource) @protobuf(12,bytes,opt) 105 105 106 - // Cinder represents a cinder volume attached and mounted on kubelets host machine 107 - // More info: https://releases.k8s.io/HEAD/examples/mysql-cinder-pd/README.md 106 + // Cinder represents a cinder volume attached and mounted on kubelets host machine. 107 + // More info: https://examples.k8s.io/mysql-cinder-pd/README.md 108 108 // +optional 109 109 cinder?: null | CinderVolumeSource @go(Cinder,*CinderVolumeSource) @protobuf(13,bytes,opt) 110 110 ··· 207 207 208 208 // Glusterfs represents a Glusterfs volume that is attached to a host and 209 209 // exposed to the pod. Provisioned by an admin. 210 - // More info: https://releases.k8s.io/HEAD/examples/volumes/glusterfs/README.md 210 + // More info: https://examples.k8s.io/volumes/glusterfs/README.md 211 211 // +optional 212 212 glusterfs?: null | GlusterfsPersistentVolumeSource @go(Glusterfs,*GlusterfsPersistentVolumeSource) @protobuf(4,bytes,opt) 213 213 ··· 217 217 nfs?: null | NFSVolumeSource @go(NFS,*NFSVolumeSource) @protobuf(5,bytes,opt) 218 218 219 219 // RBD represents a Rados Block Device mount on the host that shares a pod's lifetime. 220 - // More info: https://releases.k8s.io/HEAD/examples/volumes/rbd/README.md 220 + // More info: https://examples.k8s.io/volumes/rbd/README.md 221 221 // +optional 222 222 rbd?: null | RBDPersistentVolumeSource @go(RBD,*RBDPersistentVolumeSource) @protobuf(6,bytes,opt) 223 223 ··· 226 226 // +optional 227 227 iscsi?: null | ISCSIPersistentVolumeSource @go(ISCSI,*ISCSIPersistentVolumeSource) @protobuf(7,bytes,opt) 228 228 229 - // Cinder represents a cinder volume attached and mounted on kubelets host machine 230 - // More info: https://releases.k8s.io/HEAD/examples/mysql-cinder-pd/README.md 229 + // Cinder represents a cinder volume attached and mounted on kubelets host machine. 230 + // More info: https://examples.k8s.io/mysql-cinder-pd/README.md 231 231 // +optional 232 232 cinder?: null | CinderPersistentVolumeSource @go(Cinder,*CinderPersistentVolumeSource) @protobuf(8,bytes,opt) 233 233 ··· 280 280 local?: null | LocalVolumeSource @go(Local,*LocalVolumeSource) @protobuf(20,bytes,opt) 281 281 282 282 // StorageOS represents a StorageOS volume that is attached to the kubelet's host machine and mounted into the pod 283 - // More info: https://releases.k8s.io/HEAD/examples/volumes/storageos/README.md 283 + // More info: https://examples.k8s.io/volumes/storageos/README.md 284 284 // +optional 285 285 storageos?: null | StorageOSPersistentVolumeSource @go(StorageOS,*StorageOSPersistentVolumeSource) @protobuf(21,bytes,opt) 286 286 ··· 301 301 // More info: https://kubernetes.io/docs/concepts/storage/persistent-volumes 302 302 PersistentVolume: metav1.TypeMeta & { 303 303 // Standard object's metadata. 304 - // More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#metadata 304 + // More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata 305 305 // +optional 306 306 metadata?: metav1.ObjectMeta @go(ObjectMeta) @protobuf(1,bytes,opt) 307 307 ··· 428 428 // PersistentVolumeList is a list of PersistentVolume items. 429 429 PersistentVolumeList: metav1.TypeMeta & { 430 430 // Standard list metadata. 431 - // More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#types-kinds 431 + // More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds 432 432 // +optional 433 433 metadata?: metav1.ListMeta @go(ListMeta) @protobuf(1,bytes,opt) 434 434 ··· 440 440 // PersistentVolumeClaim is a user's request for and claim to a persistent volume 441 441 PersistentVolumeClaim: metav1.TypeMeta & { 442 442 // Standard object's metadata. 443 - // More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#metadata 443 + // More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata 444 444 // +optional 445 445 metadata?: metav1.ObjectMeta @go(ObjectMeta) @protobuf(1,bytes,opt) 446 446 ··· 459 459 // PersistentVolumeClaimList is a list of PersistentVolumeClaim items. 460 460 PersistentVolumeClaimList: metav1.TypeMeta & { 461 461 // Standard list metadata. 462 - // More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#types-kinds 462 + // More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds 463 463 // +optional 464 464 metadata?: metav1.ListMeta @go(ListMeta) @protobuf(1,bytes,opt) 465 465 ··· 710 710 // Glusterfs volumes do not support ownership management or SELinux relabeling. 711 711 GlusterfsVolumeSource: { 712 712 // EndpointsName is the endpoint name that details Glusterfs topology. 713 - // More info: https://releases.k8s.io/HEAD/examples/volumes/glusterfs/README.md#create-a-pod 713 + // More info: https://examples.k8s.io/volumes/glusterfs/README.md#create-a-pod 714 714 endpoints: string @go(EndpointsName) @protobuf(1,bytes,opt) 715 715 716 716 // Path is the Glusterfs volume path. 717 - // More info: https://releases.k8s.io/HEAD/examples/volumes/glusterfs/README.md#create-a-pod 717 + // More info: https://examples.k8s.io/volumes/glusterfs/README.md#create-a-pod 718 718 path: string @go(Path) @protobuf(2,bytes,opt) 719 719 720 720 // ReadOnly here will force the Glusterfs volume to be mounted with read-only permissions. 721 721 // Defaults to false. 722 - // More info: https://releases.k8s.io/HEAD/examples/volumes/glusterfs/README.md#create-a-pod 722 + // More info: https://examples.k8s.io/volumes/glusterfs/README.md#create-a-pod 723 723 // +optional 724 724 readOnly?: bool @go(ReadOnly) @protobuf(3,varint,opt) 725 725 } ··· 728 728 // Glusterfs volumes do not support ownership management or SELinux relabeling. 729 729 GlusterfsPersistentVolumeSource: { 730 730 // EndpointsName is the endpoint name that details Glusterfs topology. 731 - // More info: https://releases.k8s.io/HEAD/examples/volumes/glusterfs/README.md#create-a-pod 731 + // More info: https://examples.k8s.io/volumes/glusterfs/README.md#create-a-pod 732 732 endpoints: string @go(EndpointsName) @protobuf(1,bytes,opt) 733 733 734 734 // Path is the Glusterfs volume path. 735 - // More info: https://releases.k8s.io/HEAD/examples/volumes/glusterfs/README.md#create-a-pod 735 + // More info: https://examples.k8s.io/volumes/glusterfs/README.md#create-a-pod 736 736 path: string @go(Path) @protobuf(2,bytes,opt) 737 737 738 738 // ReadOnly here will force the Glusterfs volume to be mounted with read-only permissions. 739 739 // Defaults to false. 740 - // More info: https://releases.k8s.io/HEAD/examples/volumes/glusterfs/README.md#create-a-pod 740 + // More info: https://examples.k8s.io/volumes/glusterfs/README.md#create-a-pod 741 741 // +optional 742 742 readOnly?: bool @go(ReadOnly) @protobuf(3,varint,opt) 743 743 744 744 // EndpointsNamespace is the namespace that contains Glusterfs endpoint. 745 745 // If this field is empty, the EndpointNamespace defaults to the same namespace as the bound PVC. 746 - // More info: https://releases.k8s.io/HEAD/examples/volumes/glusterfs/README.md#create-a-pod 746 + // More info: https://examples.k8s.io/volumes/glusterfs/README.md#create-a-pod 747 747 // +optional 748 748 endpointsNamespace?: null | string @go(EndpointsNamespace,*string) @protobuf(4,bytes,opt) 749 749 } ··· 752 752 // RBD volumes support ownership management and SELinux relabeling. 753 753 RBDVolumeSource: { 754 754 // A collection of Ceph monitors. 755 - // More info: https://releases.k8s.io/HEAD/examples/volumes/rbd/README.md#how-to-use-it 755 + // More info: https://examples.k8s.io/volumes/rbd/README.md#how-to-use-it 756 756 monitors: [...string] @go(CephMonitors,[]string) @protobuf(1,bytes,rep) 757 757 758 758 // The rados image name. 759 - // More info: https://releases.k8s.io/HEAD/examples/volumes/rbd/README.md#how-to-use-it 759 + // More info: https://examples.k8s.io/volumes/rbd/README.md#how-to-use-it 760 760 image: string @go(RBDImage) @protobuf(2,bytes,opt) 761 761 762 762 // Filesystem type of the volume that you want to mount. ··· 769 769 770 770 // The rados pool name. 771 771 // Default is rbd. 772 - // More info: https://releases.k8s.io/HEAD/examples/volumes/rbd/README.md#how-to-use-it 772 + // More info: https://examples.k8s.io/volumes/rbd/README.md#how-to-use-it 773 773 // +optional 774 774 pool?: string @go(RBDPool) @protobuf(4,bytes,opt) 775 775 776 776 // The rados user name. 777 777 // Default is admin. 778 - // More info: https://releases.k8s.io/HEAD/examples/volumes/rbd/README.md#how-to-use-it 778 + // More info: https://examples.k8s.io/volumes/rbd/README.md#how-to-use-it 779 779 // +optional 780 780 user?: string @go(RadosUser) @protobuf(5,bytes,opt) 781 781 782 782 // Keyring is the path to key ring for RBDUser. 783 783 // Default is /etc/ceph/keyring. 784 - // More info: https://releases.k8s.io/HEAD/examples/volumes/rbd/README.md#how-to-use-it 784 + // More info: https://examples.k8s.io/volumes/rbd/README.md#how-to-use-it 785 785 // +optional 786 786 keyring?: string @go(Keyring) @protobuf(6,bytes,opt) 787 787 788 788 // SecretRef is name of the authentication secret for RBDUser. If provided 789 789 // overrides keyring. 790 790 // Default is nil. 791 - // More info: https://releases.k8s.io/HEAD/examples/volumes/rbd/README.md#how-to-use-it 791 + // More info: https://examples.k8s.io/volumes/rbd/README.md#how-to-use-it 792 792 // +optional 793 793 secretRef?: null | LocalObjectReference @go(SecretRef,*LocalObjectReference) @protobuf(7,bytes,opt) 794 794 795 795 // ReadOnly here will force the ReadOnly setting in VolumeMounts. 796 796 // Defaults to false. 797 - // More info: https://releases.k8s.io/HEAD/examples/volumes/rbd/README.md#how-to-use-it 797 + // More info: https://examples.k8s.io/volumes/rbd/README.md#how-to-use-it 798 798 // +optional 799 799 readOnly?: bool @go(ReadOnly) @protobuf(8,varint,opt) 800 800 } ··· 803 803 // RBD volumes support ownership management and SELinux relabeling. 804 804 RBDPersistentVolumeSource: { 805 805 // A collection of Ceph monitors. 806 - // More info: https://releases.k8s.io/HEAD/examples/volumes/rbd/README.md#how-to-use-it 806 + // More info: https://examples.k8s.io/volumes/rbd/README.md#how-to-use-it 807 807 monitors: [...string] @go(CephMonitors,[]string) @protobuf(1,bytes,rep) 808 808 809 809 // The rados image name. 810 - // More info: https://releases.k8s.io/HEAD/examples/volumes/rbd/README.md#how-to-use-it 810 + // More info: https://examples.k8s.io/volumes/rbd/README.md#how-to-use-it 811 811 image: string @go(RBDImage) @protobuf(2,bytes,opt) 812 812 813 813 // Filesystem type of the volume that you want to mount. ··· 820 820 821 821 // The rados pool name. 822 822 // Default is rbd. 823 - // More info: https://releases.k8s.io/HEAD/examples/volumes/rbd/README.md#how-to-use-it 823 + // More info: https://examples.k8s.io/volumes/rbd/README.md#how-to-use-it 824 824 // +optional 825 825 pool?: string @go(RBDPool) @protobuf(4,bytes,opt) 826 826 827 827 // The rados user name. 828 828 // Default is admin. 829 - // More info: https://releases.k8s.io/HEAD/examples/volumes/rbd/README.md#how-to-use-it 829 + // More info: https://examples.k8s.io/volumes/rbd/README.md#how-to-use-it 830 830 // +optional 831 831 user?: string @go(RadosUser) @protobuf(5,bytes,opt) 832 832 833 833 // Keyring is the path to key ring for RBDUser. 834 834 // Default is /etc/ceph/keyring. 835 - // More info: https://releases.k8s.io/HEAD/examples/volumes/rbd/README.md#how-to-use-it 835 + // More info: https://examples.k8s.io/volumes/rbd/README.md#how-to-use-it 836 836 // +optional 837 837 keyring?: string @go(Keyring) @protobuf(6,bytes,opt) 838 838 839 839 // SecretRef is name of the authentication secret for RBDUser. If provided 840 840 // overrides keyring. 841 841 // Default is nil. 842 - // More info: https://releases.k8s.io/HEAD/examples/volumes/rbd/README.md#how-to-use-it 842 + // More info: https://examples.k8s.io/volumes/rbd/README.md#how-to-use-it 843 843 // +optional 844 844 secretRef?: null | SecretReference @go(SecretRef,*SecretReference) @protobuf(7,bytes,opt) 845 845 846 846 // ReadOnly here will force the ReadOnly setting in VolumeMounts. 847 847 // Defaults to false. 848 - // More info: https://releases.k8s.io/HEAD/examples/volumes/rbd/README.md#how-to-use-it 848 + // More info: https://examples.k8s.io/volumes/rbd/README.md#how-to-use-it 849 849 // +optional 850 850 readOnly?: bool @go(ReadOnly) @protobuf(8,varint,opt) 851 851 } ··· 855 855 // The volume must also be in the same region as the kubelet. 856 856 // Cinder volumes support ownership management and SELinux relabeling. 857 857 CinderVolumeSource: { 858 - // volume id used to identify the volume in cinder 859 - // More info: https://releases.k8s.io/HEAD/examples/mysql-cinder-pd/README.md 858 + // volume id used to identify the volume in cinder. 859 + // More info: https://examples.k8s.io/mysql-cinder-pd/README.md 860 860 volumeID: string @go(VolumeID) @protobuf(1,bytes,opt) 861 861 862 862 // Filesystem type to mount. 863 863 // Must be a filesystem type supported by the host operating system. 864 864 // Examples: "ext4", "xfs", "ntfs". Implicitly inferred to be "ext4" if unspecified. 865 - // More info: https://releases.k8s.io/HEAD/examples/mysql-cinder-pd/README.md 865 + // More info: https://examples.k8s.io/mysql-cinder-pd/README.md 866 866 // +optional 867 867 fsType?: string @go(FSType) @protobuf(2,bytes,opt) 868 868 869 869 // Optional: Defaults to false (read/write). ReadOnly here will force 870 870 // the ReadOnly setting in VolumeMounts. 871 - // More info: https://releases.k8s.io/HEAD/examples/mysql-cinder-pd/README.md 871 + // More info: https://examples.k8s.io/mysql-cinder-pd/README.md 872 872 // +optional 873 873 readOnly?: bool @go(ReadOnly) @protobuf(3,varint,opt) 874 874 ··· 883 883 // The volume must also be in the same region as the kubelet. 884 884 // Cinder volumes support ownership management and SELinux relabeling. 885 885 CinderPersistentVolumeSource: { 886 - // volume id used to identify the volume in cinder 887 - // More info: https://releases.k8s.io/HEAD/examples/mysql-cinder-pd/README.md 886 + // volume id used to identify the volume in cinder. 887 + // More info: https://examples.k8s.io/mysql-cinder-pd/README.md 888 888 volumeID: string @go(VolumeID) @protobuf(1,bytes,opt) 889 889 890 890 // Filesystem type to mount. 891 891 // Must be a filesystem type supported by the host operating system. 892 892 // Examples: "ext4", "xfs", "ntfs". Implicitly inferred to be "ext4" if unspecified. 893 - // More info: https://releases.k8s.io/HEAD/examples/mysql-cinder-pd/README.md 893 + // More info: https://examples.k8s.io/mysql-cinder-pd/README.md 894 894 // +optional 895 895 fsType?: string @go(FSType) @protobuf(2,bytes,opt) 896 896 897 897 // Optional: Defaults to false (read/write). ReadOnly here will force 898 898 // the ReadOnly setting in VolumeMounts. 899 - // More info: https://releases.k8s.io/HEAD/examples/mysql-cinder-pd/README.md 899 + // More info: https://examples.k8s.io/mysql-cinder-pd/README.md 900 900 // +optional 901 901 readOnly?: bool @go(ReadOnly) @protobuf(3,varint,opt) 902 902 ··· 910 910 // Cephfs volumes do not support ownership management or SELinux relabeling. 911 911 CephFSVolumeSource: { 912 912 // Required: Monitors is a collection of Ceph monitors 913 - // More info: https://releases.k8s.io/HEAD/examples/volumes/cephfs/README.md#how-to-use-it 913 + // More info: https://examples.k8s.io/volumes/cephfs/README.md#how-to-use-it 914 914 monitors: [...string] @go(Monitors,[]string) @protobuf(1,bytes,rep) 915 915 916 916 // Optional: Used as the mounted root, rather than the full Ceph tree, default is / ··· 918 918 path?: string @go(Path) @protobuf(2,bytes,opt) 919 919 920 920 // Optional: User is the rados user name, default is admin 921 - // More info: https://releases.k8s.io/HEAD/examples/volumes/cephfs/README.md#how-to-use-it 921 + // More info: https://examples.k8s.io/volumes/cephfs/README.md#how-to-use-it 922 922 // +optional 923 923 user?: string @go(User) @protobuf(3,bytes,opt) 924 924 925 925 // Optional: SecretFile is the path to key ring for User, default is /etc/ceph/user.secret 926 - // More info: https://releases.k8s.io/HEAD/examples/volumes/cephfs/README.md#how-to-use-it 926 + // More info: https://examples.k8s.io/volumes/cephfs/README.md#how-to-use-it 927 927 // +optional 928 928 secretFile?: string @go(SecretFile) @protobuf(4,bytes,opt) 929 929 930 930 // Optional: SecretRef is reference to the authentication secret for User, default is empty. 931 - // More info: https://releases.k8s.io/HEAD/examples/volumes/cephfs/README.md#how-to-use-it 931 + // More info: https://examples.k8s.io/volumes/cephfs/README.md#how-to-use-it 932 932 // +optional 933 933 secretRef?: null | LocalObjectReference @go(SecretRef,*LocalObjectReference) @protobuf(5,bytes,opt) 934 934 935 935 // Optional: Defaults to false (read/write). ReadOnly here will force 936 936 // the ReadOnly setting in VolumeMounts. 937 - // More info: https://releases.k8s.io/HEAD/examples/volumes/cephfs/README.md#how-to-use-it 937 + // More info: https://examples.k8s.io/volumes/cephfs/README.md#how-to-use-it 938 938 // +optional 939 939 readOnly?: bool @go(ReadOnly) @protobuf(6,varint,opt) 940 940 } ··· 955 955 // Cephfs volumes do not support ownership management or SELinux relabeling. 956 956 CephFSPersistentVolumeSource: { 957 957 // Required: Monitors is a collection of Ceph monitors 958 - // More info: https://releases.k8s.io/HEAD/examples/volumes/cephfs/README.md#how-to-use-it 958 + // More info: https://examples.k8s.io/volumes/cephfs/README.md#how-to-use-it 959 959 monitors: [...string] @go(Monitors,[]string) @protobuf(1,bytes,rep) 960 960 961 961 // Optional: Used as the mounted root, rather than the full Ceph tree, default is / ··· 963 963 path?: string @go(Path) @protobuf(2,bytes,opt) 964 964 965 965 // Optional: User is the rados user name, default is admin 966 - // More info: https://releases.k8s.io/HEAD/examples/volumes/cephfs/README.md#how-to-use-it 966 + // More info: https://examples.k8s.io/volumes/cephfs/README.md#how-to-use-it 967 967 // +optional 968 968 user?: string @go(User) @protobuf(3,bytes,opt) 969 969 970 970 // Optional: SecretFile is the path to key ring for User, default is /etc/ceph/user.secret 971 - // More info: https://releases.k8s.io/HEAD/examples/volumes/cephfs/README.md#how-to-use-it 971 + // More info: https://examples.k8s.io/volumes/cephfs/README.md#how-to-use-it 972 972 // +optional 973 973 secretFile?: string @go(SecretFile) @protobuf(4,bytes,opt) 974 974 975 975 // Optional: SecretRef is reference to the authentication secret for User, default is empty. 976 - // More info: https://releases.k8s.io/HEAD/examples/volumes/cephfs/README.md#how-to-use-it 976 + // More info: https://examples.k8s.io/volumes/cephfs/README.md#how-to-use-it 977 977 // +optional 978 978 secretRef?: null | SecretReference @go(SecretRef,*SecretReference) @protobuf(5,bytes,opt) 979 979 980 980 // Optional: Defaults to false (read/write). ReadOnly here will force 981 981 // the ReadOnly setting in VolumeMounts. 982 - // More info: https://releases.k8s.io/HEAD/examples/volumes/cephfs/README.md#how-to-use-it 982 + // More info: https://examples.k8s.io/volumes/cephfs/README.md#how-to-use-it 983 983 // +optional 984 984 readOnly?: bool @go(ReadOnly) @protobuf(6,varint,opt) 985 985 } ··· 2269 2269 periodSeconds?: int32 @go(PeriodSeconds) @protobuf(4,varint,opt) 2270 2270 2271 2271 // Minimum consecutive successes for the probe to be considered successful after having failed. 2272 - // Defaults to 1. Must be 1 for liveness. Minimum value is 1. 2272 + // Defaults to 1. Must be 1 for liveness and startup. Minimum value is 1. 2273 2273 // +optional 2274 2274 successThreshold?: int32 @go(SuccessThreshold) @protobuf(5,varint,opt) 2275 2275 ··· 2465 2465 // +optional 2466 2466 readinessProbe?: null | Probe @go(ReadinessProbe,*Probe) @protobuf(11,bytes,opt) 2467 2467 2468 + // StartupProbe indicates that the Pod has successfully initialized. 2469 + // If specified, no other probes are executed until this completes successfully. 2470 + // If this probe fails, the Pod will be restarted, just as if the livenessProbe failed. 2471 + // This can be used to provide different probe parameters at the beginning of a Pod's lifecycle, 2472 + // when it might take a long time to load data or warm a cache, than during steady-state operation. 2473 + // This cannot be updated. 2474 + // This is an alpha feature enabled by the StartupProbe feature flag. 2475 + // More info: https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes 2476 + // +optional 2477 + startupProbe?: null | Probe @go(StartupProbe,*Probe) @protobuf(22,bytes,opt) 2478 + 2468 2479 // Actions that the management system should take in response to container lifecycle events. 2469 2480 // Cannot be updated. 2470 2481 // +optional ··· 2557 2568 postStart?: null | Handler @go(PostStart,*Handler) @protobuf(1,bytes,opt) 2558 2569 2559 2570 // PreStop is called immediately before a container is terminated due to an 2560 - // API request or management event such as liveness probe failure, 2571 + // API request or management event such as liveness/startup probe failure, 2561 2572 // preemption, resource contention, etc. The handler is not called if the 2562 2573 // container crashes or exits. The reason for termination is passed to the 2563 2574 // handler. The Pod's termination grace period countdown begins before the ··· 2680 2691 // Container's ID in the format 'docker://<container_id>'. 2681 2692 // +optional 2682 2693 containerID?: string @go(ContainerID) @protobuf(8,bytes,opt) 2694 + 2695 + // Specifies whether the container has passed its startup probe. 2696 + // Initialized as false, becomes true after startupProbe is considered successful. 2697 + // Resets to false when the container is restarted, or if kubelet loses state temporarily. 2698 + // Is always true when no startupProbe is defined. 2699 + // +optional 2700 + started?: null | bool @go(Started,*bool) @protobuf(9,varint,opt) 2683 2701 } 2684 2702 2685 2703 // PodPhase is a label for the condition of a pod at the current time. ··· 3133 3151 // init container fails, the pod is considered to have failed and is handled according 3134 3152 // to its restartPolicy. The name for an init container or normal container must be 3135 3153 // unique among all containers. 3136 - // Init containers may not have Lifecycle actions, Readiness probes, or Liveness probes. 3154 + // Init containers may not have Lifecycle actions, Readiness probes, Liveness probes, or Startup probes. 3137 3155 // The resourceRequirements of an init container are taken into account during scheduling 3138 3156 // by finding the highest request/limit for each resource type, and then using the max of 3139 3157 // of that value or the sum of the normal containers. Limits are applied to init containers ··· 3153 3171 // +patchStrategy=merge 3154 3172 containers: [...Container] @go(Containers,[]Container) @protobuf(2,bytes,rep) 3155 3173 3156 - // EphemeralContainers is the list of ephemeral containers that run in this pod. Ephemeral containers 3157 - // are added to an existing pod as a result of a user-initiated action such as troubleshooting. 3158 - // This list is read-only in the pod spec. It may not be specified in a create or modified in an 3159 - // update of a pod or pod template. 3160 - // To add an ephemeral container use the pod's ephemeralcontainers subresource, which allows update 3161 - // using the EphemeralContainers kind. 3174 + // List of ephemeral containers run in this pod. Ephemeral containers may be run in an existing 3175 + // pod to perform user-initiated actions such as debugging. This list cannot be specified when 3176 + // creating a pod, and it cannot be modified by updating the pod spec. In order to add an 3177 + // ephemeral container to an existing pod, use the pod's ephemeralcontainers subresource. 3162 3178 // This field is alpha-level and is only honored by servers that enable the EphemeralContainers feature. 3163 3179 // +optional 3164 3180 // +patchMergeKey=name ··· 3578 3594 ip?: string @go(IP) @protobuf(1,bytes,opt) 3579 3595 } 3580 3596 3597 + // EphemeralContainerCommon is a copy of all fields in Container to be inlined in 3598 + // EphemeralContainer. This separate type allows easy conversion from EphemeralContainer 3599 + // to Container and allows separate documentation for the fields of EphemeralContainer. 3600 + // When a new field is added to Container it must be added here as well. 3581 3601 EphemeralContainerCommon: { 3582 3602 // Name of the ephemeral container specified as a DNS_LABEL. 3583 3603 // This name must be unique among all containers, init containers and ephemeral containers. ··· 3662 3682 // +optional 3663 3683 readinessProbe?: null | Probe @go(ReadinessProbe,*Probe) @protobuf(11,bytes,opt) 3664 3684 3685 + // Probes are not allowed for ephemeral containers. 3686 + // +optional 3687 + startupProbe?: null | Probe @go(StartupProbe,*Probe) @protobuf(22,bytes,opt) 3688 + 3665 3689 // Lifecycle is not allowed for ephemeral containers. 3666 3690 // +optional 3667 3691 lifecycle?: null | Lifecycle @go(Lifecycle,*Lifecycle) @protobuf(12,bytes,opt) ··· 3720 3744 tty?: bool @go(TTY) @protobuf(18,varint,opt) 3721 3745 } 3722 3746 3723 - // An EphemeralContainer is a special type of container which doesn't come with any resource 3724 - // or scheduling guarantees but can be added to a pod that has already been created. They are 3725 - // intended for user-initiated activities such as troubleshooting a running pod. 3726 - // Ephemeral containers will not be restarted when they exit, and they will be killed if the 3727 - // pod is removed or restarted. If an ephemeral container causes a pod to exceed its resource 3747 + // An EphemeralContainer is a container that may be added temporarily to an existing pod for 3748 + // user-initiated activities such as debugging. Ephemeral containers have no resource or 3749 + // scheduling guarantees, and they will not be restarted when they exit or when a pod is 3750 + // removed or restarted. If an ephemeral container causes a pod to exceed its resource 3728 3751 // allocation, the pod may be evicted. 3729 - // Ephemeral containers are added via a pod's ephemeralcontainers subresource and will appear 3730 - // in the pod spec once added. No fields in EphemeralContainer may be changed once added. 3752 + // Ephemeral containers may not be added by directly updating the pod spec. They must be added 3753 + // via the pod's ephemeralcontainers subresource, and they will appear in the pod spec 3754 + // once added. 3731 3755 // This is an alpha feature enabled by the EphemeralContainers feature flag. 3732 3756 EphemeralContainer: EphemeralContainerCommon & { 3733 3757 // If set, the name of the container from PodSpec that this ephemeral container targets. ··· 3829 3853 // +optional 3830 3854 qosClass?: PodQOSClass @go(QOSClass) @protobuf(9,bytes,rep) 3831 3855 3832 - // Status for any ephemeral containers that running in this pod. 3833 - // This field is alpha-level and is only honored by servers that enable the EphemeralContainers feature. 3856 + // Status for any ephemeral containers that have run in this pod. 3857 + // This field is alpha-level and is only populated by servers that enable the EphemeralContainers feature. 3834 3858 // +optional 3835 3859 ephemeralContainerStatuses?: [...ContainerStatus] @go(EphemeralContainerStatuses,[]ContainerStatus) @protobuf(13,bytes,rep) 3836 3860 } ··· 3838 3862 // PodStatusResult is a wrapper for PodStatus returned by kubelet that can be encode/decoded 3839 3863 PodStatusResult: metav1.TypeMeta & { 3840 3864 // Standard object's metadata. 3841 - // More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#metadata 3865 + // More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata 3842 3866 // +optional 3843 3867 metadata?: metav1.ObjectMeta @go(ObjectMeta) @protobuf(1,bytes,opt) 3844 3868 ··· 3846 3870 // This data may not be up to date. 3847 3871 // Populated by the system. 3848 3872 // Read-only. 3849 - // More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#spec-and-status 3873 + // More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#spec-and-status 3850 3874 // +optional 3851 3875 status?: PodStatus @go(Status) @protobuf(2,bytes,opt) 3852 3876 } ··· 3855 3879 // by clients and scheduled onto hosts. 3856 3880 Pod: metav1.TypeMeta & { 3857 3881 // Standard object's metadata. 3858 - // More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#metadata 3882 + // More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata 3859 3883 // +optional 3860 3884 metadata?: metav1.ObjectMeta @go(ObjectMeta) @protobuf(1,bytes,opt) 3861 3885 3862 3886 // Specification of the desired behavior of the pod. 3863 - // More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#spec-and-status 3887 + // More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#spec-and-status 3864 3888 // +optional 3865 3889 spec?: PodSpec @go(Spec) @protobuf(2,bytes,opt) 3866 3890 ··· 3868 3892 // This data may not be up to date. 3869 3893 // Populated by the system. 3870 3894 // Read-only. 3871 - // More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#spec-and-status 3895 + // More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#spec-and-status 3872 3896 // +optional 3873 3897 status?: PodStatus @go(Status) @protobuf(3,bytes,opt) 3874 3898 } ··· 3876 3900 // PodList is a list of Pods. 3877 3901 PodList: metav1.TypeMeta & { 3878 3902 // Standard list metadata. 3879 - // More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#types-kinds 3903 + // More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds 3880 3904 // +optional 3881 3905 metadata?: metav1.ListMeta @go(ListMeta) @protobuf(1,bytes,opt) 3882 3906 3883 3907 // List of pods. 3884 - // More info: https://git.k8s.io/community/contributors/devel/api-conventions.md 3908 + // More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md 3885 3909 items: [...Pod] @go(Items,[]Pod) @protobuf(2,bytes,rep) 3886 3910 } 3887 3911 3888 3912 // PodTemplateSpec describes the data a pod should have when created from a template 3889 3913 PodTemplateSpec: { 3890 3914 // Standard object's metadata. 3891 - // More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#metadata 3915 + // More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata 3892 3916 // +optional 3893 3917 metadata?: metav1.ObjectMeta @go(ObjectMeta) @protobuf(1,bytes,opt) 3894 3918 3895 3919 // Specification of the desired behavior of the pod. 3896 - // More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#spec-and-status 3920 + // More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#spec-and-status 3897 3921 // +optional 3898 3922 spec?: PodSpec @go(Spec) @protobuf(2,bytes,opt) 3899 3923 } ··· 3901 3925 // PodTemplate describes a template for creating copies of a predefined pod. 3902 3926 PodTemplate: metav1.TypeMeta & { 3903 3927 // Standard object's metadata. 3904 - // More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#metadata 3928 + // More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata 3905 3929 // +optional 3906 3930 metadata?: metav1.ObjectMeta @go(ObjectMeta) @protobuf(1,bytes,opt) 3907 3931 3908 3932 // Template defines the pods that will be created from this pod template. 3909 - // https://git.k8s.io/community/contributors/devel/api-conventions.md#spec-and-status 3933 + // https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#spec-and-status 3910 3934 // +optional 3911 3935 template?: PodTemplateSpec @go(Template) @protobuf(2,bytes,opt) 3912 3936 } ··· 3914 3938 // PodTemplateList is a list of PodTemplates. 3915 3939 PodTemplateList: metav1.TypeMeta & { 3916 3940 // Standard list metadata. 3917 - // More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#types-kinds 3941 + // More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds 3918 3942 // +optional 3919 3943 metadata?: metav1.ListMeta @go(ListMeta) @protobuf(1,bytes,opt) 3920 3944 ··· 4017 4041 ReplicationController: metav1.TypeMeta & { 4018 4042 // If the Labels of a ReplicationController are empty, they are defaulted to 4019 4043 // be the same as the Pod(s) that the replication controller manages. 4020 - // Standard object's metadata. More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#metadata 4044 + // Standard object's metadata. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata 4021 4045 // +optional 4022 4046 metadata?: metav1.ObjectMeta @go(ObjectMeta) @protobuf(1,bytes,opt) 4023 4047 4024 4048 // Spec defines the specification of the desired behavior of the replication controller. 4025 - // More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#spec-and-status 4049 + // More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#spec-and-status 4026 4050 // +optional 4027 4051 spec?: ReplicationControllerSpec @go(Spec) @protobuf(2,bytes,opt) 4028 4052 ··· 4030 4054 // This data may be out of date by some window of time. 4031 4055 // Populated by the system. 4032 4056 // Read-only. 4033 - // More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#spec-and-status 4057 + // More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#spec-and-status 4034 4058 // +optional 4035 4059 status?: ReplicationControllerStatus @go(Status) @protobuf(3,bytes,opt) 4036 4060 } ··· 4038 4062 // ReplicationControllerList is a collection of replication controllers. 4039 4063 ReplicationControllerList: metav1.TypeMeta & { 4040 4064 // Standard list metadata. 4041 - // More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#types-kinds 4065 + // More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds 4042 4066 // +optional 4043 4067 metadata?: metav1.ListMeta @go(ListMeta) @protobuf(1,bytes,opt) 4044 4068 ··· 4148 4172 hostname?: string @go(Hostname) @protobuf(2,bytes,opt) 4149 4173 } 4150 4174 4175 + // IPFamily represents the IP Family (IPv4 or IPv6). This type is used 4176 + // to express the family of an IP expressed by a type (i.e. service.Spec.IPFamily) 4177 + IPFamily: string // enumIPFamily 4178 + 4179 + enumIPFamily: 4180 + IPv4Protocol | 4181 + IPv6Protocol 4182 + 4183 + // IPv4Protocol indicates that this IP is IPv4 protocol 4184 + IPv4Protocol: IPFamily & "IPv4" 4185 + 4186 + // IPv6Protocol indicates that this IP is IPv6 protocol 4187 + IPv6Protocol: IPFamily & "IPv6" 4188 + 4151 4189 // ServiceSpec describes the attributes that a user creates on a service. 4152 4190 ServiceSpec: { 4153 4191 // The list of ports that are exposed by this service. ··· 4264 4302 // sessionAffinityConfig contains the configurations of session affinity. 4265 4303 // +optional 4266 4304 sessionAffinityConfig?: null | SessionAffinityConfig @go(SessionAffinityConfig,*SessionAffinityConfig) @protobuf(14,bytes,opt) 4305 + 4306 + // ipFamily specifies whether this Service has a preference for a particular IP family (e.g. IPv4 vs. 4307 + // IPv6). If a specific IP family is requested, the clusterIP field will be allocated from that family, if it is 4308 + // available in the cluster. If no IP family is requested, the cluster's primary IP family will be used. 4309 + // Other IP fields (loadBalancerIP, loadBalancerSourceRanges, externalIPs) and controllers which 4310 + // allocate external load-balancers should use the same IP family. Endpoints for this Service will be of 4311 + // this family. This field is immutable after creation. Assigning a ServiceIPFamily not available in the 4312 + // cluster (e.g. IPv6 in IPv4 only cluster) is an error condition and will fail during clusterIP assignment. 4313 + // +optional 4314 + ipFamily?: null | IPFamily @go(IPFamily,*IPFamily) @protobuf(15,bytes,opt,Configcasttype=IPFamily) 4267 4315 } 4268 4316 4269 4317 // ServicePort contains information on service's port. 4270 4318 ServicePort: { 4271 4319 // The name of this port within the service. This must be a DNS_LABEL. 4272 - // All ports within a ServiceSpec must have unique names. This maps to 4273 - // the 'Name' field in EndpointPort objects. 4320 + // All ports within a ServiceSpec must have unique names. When considering 4321 + // the endpoints for a Service, this must match the 'name' field in the 4322 + // EndpointPort. 4274 4323 // Optional if only one ServicePort is defined on this service. 4275 4324 // +optional 4276 4325 name?: string @go(Name) @protobuf(1,bytes,opt) ··· 4308 4357 // will answer requests sent through the proxy. 4309 4358 Service: metav1.TypeMeta & { 4310 4359 // Standard object's metadata. 4311 - // More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#metadata 4360 + // More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata 4312 4361 // +optional 4313 4362 metadata?: metav1.ObjectMeta @go(ObjectMeta) @protobuf(1,bytes,opt) 4314 4363 4315 4364 // Spec defines the behavior of a service. 4316 - // https://git.k8s.io/community/contributors/devel/api-conventions.md#spec-and-status 4365 + // https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#spec-and-status 4317 4366 // +optional 4318 4367 spec?: ServiceSpec @go(Spec) @protobuf(2,bytes,opt) 4319 4368 4320 4369 // Most recently observed status of the service. 4321 4370 // Populated by the system. 4322 4371 // Read-only. 4323 - // More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#spec-and-status 4372 + // More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#spec-and-status 4324 4373 // +optional 4325 4374 status?: ServiceStatus @go(Status) @protobuf(3,bytes,opt) 4326 4375 } ··· 4332 4381 // ServiceList holds a list of services. 4333 4382 ServiceList: metav1.TypeMeta & { 4334 4383 // Standard list metadata. 4335 - // More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#types-kinds 4384 + // More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds 4336 4385 // +optional 4337 4386 metadata?: metav1.ListMeta @go(ListMeta) @protobuf(1,bytes,opt) 4338 4387 ··· 4346 4395 // * a set of secrets 4347 4396 ServiceAccount: metav1.TypeMeta & { 4348 4397 // Standard object's metadata. 4349 - // More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#metadata 4398 + // More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata 4350 4399 // +optional 4351 4400 metadata?: metav1.ObjectMeta @go(ObjectMeta) @protobuf(1,bytes,opt) 4352 4401 ··· 4373 4422 // ServiceAccountList is a list of ServiceAccount objects 4374 4423 ServiceAccountList: metav1.TypeMeta & { 4375 4424 // Standard list metadata. 4376 - // More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#types-kinds 4425 + // More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds 4377 4426 // +optional 4378 4427 metadata?: metav1.ListMeta @go(ListMeta) @protobuf(1,bytes,opt) 4379 4428 ··· 4396 4445 // ] 4397 4446 Endpoints: metav1.TypeMeta & { 4398 4447 // Standard object's metadata. 4399 - // More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#metadata 4448 + // More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata 4400 4449 // +optional 4401 4450 metadata?: metav1.ObjectMeta @go(ObjectMeta) @protobuf(1,bytes,opt) 4402 4451 ··· 4463 4512 4464 4513 // EndpointPort is a tuple that describes a single port. 4465 4514 EndpointPort: { 4466 - // The name of this port (corresponds to ServicePort.Name). 4515 + // The name of this port. This must match the 'name' field in the 4516 + // corresponding ServicePort. 4467 4517 // Must be a DNS_LABEL. 4468 4518 // Optional only if one port is defined. 4469 4519 // +optional ··· 4482 4532 // EndpointsList is a list of endpoints. 4483 4533 EndpointsList: metav1.TypeMeta & { 4484 4534 // Standard list metadata. 4485 - // More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#types-kinds 4535 + // More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds 4486 4536 // +optional 4487 4537 metadata?: metav1.ListMeta @go(ListMeta) @protobuf(1,bytes,opt) 4488 4538 ··· 4921 4971 // Each node will have a unique identifier in the cache (i.e. in etcd). 4922 4972 Node: metav1.TypeMeta & { 4923 4973 // Standard object's metadata. 4924 - // More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#metadata 4974 + // More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata 4925 4975 // +optional 4926 4976 metadata?: metav1.ObjectMeta @go(ObjectMeta) @protobuf(1,bytes,opt) 4927 4977 4928 4978 // Spec defines the behavior of a node. 4929 - // https://git.k8s.io/community/contributors/devel/api-conventions.md#spec-and-status 4979 + // https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#spec-and-status 4930 4980 // +optional 4931 4981 spec?: NodeSpec @go(Spec) @protobuf(2,bytes,opt) 4932 4982 4933 4983 // Most recently observed status of the node. 4934 4984 // Populated by the system. 4935 4985 // Read-only. 4936 - // More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#spec-and-status 4986 + // More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#spec-and-status 4937 4987 // +optional 4938 4988 status?: NodeStatus @go(Status) @protobuf(3,bytes,opt) 4939 4989 } ··· 4941 4991 // NodeList is the whole list of all Nodes which have been registered with master. 4942 4992 NodeList: metav1.TypeMeta & { 4943 4993 // Standard list metadata. 4944 - // More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#types-kinds 4994 + // More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds 4945 4995 // +optional 4946 4996 metadata?: metav1.ListMeta @go(ListMeta) @protobuf(1,bytes,opt) 4947 4997 ··· 4971 5021 // More info: https://kubernetes.io/docs/tasks/administer-cluster/namespaces/ 4972 5022 // +optional 4973 5023 phase?: NamespacePhase @go(Phase) @protobuf(1,bytes,opt,casttype=NamespacePhase) 5024 + 5025 + // Represents the latest available observations of a namespace's current state. 5026 + // +optional 5027 + // +patchMergeKey=type 5028 + // +patchStrategy=merge 5029 + conditions?: [...NamespaceCondition] @go(Conditions,[]NamespaceCondition) @protobuf(2,bytes,rep) 4974 5030 } 4975 5031 4976 5032 NamespacePhase: string // enumNamespacePhase ··· 4985 5041 // NamespaceTerminating means the namespace is undergoing graceful termination 4986 5042 NamespaceTerminating: NamespacePhase & "Terminating" 4987 5043 5044 + NamespaceConditionType: string // enumNamespaceConditionType 5045 + 5046 + enumNamespaceConditionType: 5047 + NamespaceDeletionDiscoveryFailure | 5048 + NamespaceDeletionContentFailure | 5049 + NamespaceDeletionGVParsingFailure 5050 + 5051 + // NamespaceDeletionDiscoveryFailure contains information about namespace deleter errors during resource discovery. 5052 + NamespaceDeletionDiscoveryFailure: NamespaceConditionType & "NamespaceDeletionDiscoveryFailure" 5053 + 5054 + // NamespaceDeletionContentFailure contains information about namespace deleter errors during deletion of resources. 5055 + NamespaceDeletionContentFailure: NamespaceConditionType & "NamespaceDeletionContentFailure" 5056 + 5057 + // NamespaceDeletionGVParsingFailure contains information about namespace deleter errors parsing GV for legacy types. 5058 + NamespaceDeletionGVParsingFailure: NamespaceConditionType & "NamespaceDeletionGroupVersionParsingFailure" 5059 + 5060 + // NamespaceCondition contains details about state of namespace. 5061 + NamespaceCondition: { 5062 + // Type of namespace controller condition. 5063 + type: NamespaceConditionType @go(Type) @protobuf(1,bytes,opt,casttype=NamespaceConditionType) 5064 + 5065 + // Status of the condition, one of True, False, Unknown. 5066 + status: ConditionStatus @go(Status) @protobuf(2,bytes,opt,casttype=ConditionStatus) 5067 + 5068 + // +optional 5069 + lastTransitionTime?: metav1.Time @go(LastTransitionTime) @protobuf(4,bytes,opt) 5070 + 5071 + // +optional 5072 + reason?: string @go(Reason) @protobuf(5,bytes,opt) 5073 + 5074 + // +optional 5075 + message?: string @go(Message) @protobuf(6,bytes,opt) 5076 + } 5077 + 4988 5078 // Namespace provides a scope for Names. 4989 5079 // Use of multiple namespaces is optional. 4990 5080 Namespace: metav1.TypeMeta & { 4991 5081 // Standard object's metadata. 4992 - // More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#metadata 5082 + // More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata 4993 5083 // +optional 4994 5084 metadata?: metav1.ObjectMeta @go(ObjectMeta) @protobuf(1,bytes,opt) 4995 5085 4996 5086 // Spec defines the behavior of the Namespace. 4997 - // More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#spec-and-status 5087 + // More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#spec-and-status 4998 5088 // +optional 4999 5089 spec?: NamespaceSpec @go(Spec) @protobuf(2,bytes,opt) 5000 5090 5001 5091 // Status describes the current status of a Namespace. 5002 - // More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#spec-and-status 5092 + // More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#spec-and-status 5003 5093 // +optional 5004 5094 status?: NamespaceStatus @go(Status) @protobuf(3,bytes,opt) 5005 5095 } ··· 5007 5097 // NamespaceList is a list of Namespaces. 5008 5098 NamespaceList: metav1.TypeMeta & { 5009 5099 // Standard list metadata. 5010 - // More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#types-kinds 5100 + // More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds 5011 5101 // +optional 5012 5102 metadata?: metav1.ListMeta @go(ListMeta) @protobuf(1,bytes,opt) 5013 5103 ··· 5020 5110 // Deprecated in 1.7, please use the bindings subresource of pods instead. 5021 5111 Binding: metav1.TypeMeta & { 5022 5112 // Standard object's metadata. 5023 - // More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#metadata 5113 + // More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata 5024 5114 // +optional 5025 5115 metadata?: metav1.ObjectMeta @go(ObjectMeta) @protobuf(1,bytes,opt) 5026 5116 ··· 5028 5118 target: ObjectReference @go(Target) @protobuf(2,bytes,opt) 5029 5119 } 5030 5120 5031 - // A list of ephemeral containers used in API operations 5121 + // A list of ephemeral containers used with the Pod ephemeralcontainers subresource. 5032 5122 EphemeralContainers: metav1.TypeMeta & { 5033 5123 // +optional 5034 5124 metadata?: metav1.ObjectMeta @go(ObjectMeta) @protobuf(1,bytes,opt) 5035 5125 5036 - // The new set of ephemeral containers to use for a pod. 5126 + // A list of ephemeral containers associated with this pod. New ephemeral containers 5127 + // may be appended to this list, but existing ephemeral containers may not be removed 5128 + // or modified. 5037 5129 // +patchMergeKey=name 5038 5130 // +patchStrategy=merge 5039 5131 ephemeralContainers: [...EphemeralContainer] @go(EphemeralContainers,[]EphemeralContainer) @protobuf(2,bytes,rep) ··· 5201 5293 // +k8s:deepcopy-gen:interfaces=k8s.io/apimachinery/pkg/runtime.Object 5202 5294 ObjectReference: { 5203 5295 // Kind of the referent. 5204 - // More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#types-kinds 5296 + // More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds 5205 5297 // +optional 5206 5298 kind?: string @go(Kind) @protobuf(1,bytes,opt) 5207 5299 ··· 5225 5317 apiVersion?: string @go(APIVersion) @protobuf(5,bytes,opt) 5226 5318 5227 5319 // Specific resourceVersion to which this reference is made, if any. 5228 - // More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#concurrency-control-and-consistency 5320 + // More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#concurrency-control-and-consistency 5229 5321 // +optional 5230 5322 resourceVersion?: string @go(ResourceVersion) @protobuf(6,bytes,opt) 5231 5323 ··· 5294 5386 // Event is a report of an event somewhere in the cluster. 5295 5387 Event: metav1.TypeMeta & { 5296 5388 // Standard object's metadata. 5297 - // More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#metadata 5389 + // More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata 5298 5390 metadata: metav1.ObjectMeta @go(ObjectMeta) @protobuf(1,bytes,opt) 5299 5391 5300 5392 // The object that this event is about. ··· 5384 5476 // EventList is a list of events. 5385 5477 EventList: metav1.TypeMeta & { 5386 5478 // Standard list metadata. 5387 - // More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#types-kinds 5479 + // More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds 5388 5480 // +optional 5389 5481 metadata?: metav1.ListMeta @go(ListMeta) @protobuf(1,bytes,opt) 5390 5482 ··· 5448 5540 // LimitRange sets resource usage limits for each kind of resource in a Namespace. 5449 5541 LimitRange: metav1.TypeMeta & { 5450 5542 // Standard object's metadata. 5451 - // More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#metadata 5543 + // More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata 5452 5544 // +optional 5453 5545 metadata?: metav1.ObjectMeta @go(ObjectMeta) @protobuf(1,bytes,opt) 5454 5546 5455 5547 // Spec defines the limits enforced. 5456 - // More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#spec-and-status 5548 + // More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#spec-and-status 5457 5549 // +optional 5458 5550 spec?: LimitRangeSpec @go(Spec) @protobuf(2,bytes,opt) 5459 5551 } ··· 5461 5553 // LimitRangeList is a list of LimitRange items. 5462 5554 LimitRangeList: metav1.TypeMeta & { 5463 5555 // Standard list metadata. 5464 - // More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#types-kinds 5556 + // More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds 5465 5557 // +optional 5466 5558 metadata?: metav1.ListMeta @go(ListMeta) @protobuf(1,bytes,opt) 5467 5559 ··· 5625 5717 // ResourceQuota sets aggregate quota restrictions enforced per namespace 5626 5718 ResourceQuota: metav1.TypeMeta & { 5627 5719 // Standard object's metadata. 5628 - // More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#metadata 5720 + // More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata 5629 5721 // +optional 5630 5722 metadata?: metav1.ObjectMeta @go(ObjectMeta) @protobuf(1,bytes,opt) 5631 5723 5632 5724 // Spec defines the desired quota. 5633 - // https://git.k8s.io/community/contributors/devel/api-conventions.md#spec-and-status 5725 + // https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#spec-and-status 5634 5726 // +optional 5635 5727 spec?: ResourceQuotaSpec @go(Spec) @protobuf(2,bytes,opt) 5636 5728 5637 5729 // Status defines the actual enforced quota and its current usage. 5638 - // https://git.k8s.io/community/contributors/devel/api-conventions.md#spec-and-status 5730 + // https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#spec-and-status 5639 5731 // +optional 5640 5732 status?: ResourceQuotaStatus @go(Status) @protobuf(3,bytes,opt) 5641 5733 } ··· 5643 5735 // ResourceQuotaList is a list of ResourceQuota items. 5644 5736 ResourceQuotaList: metav1.TypeMeta & { 5645 5737 // Standard list metadata. 5646 - // More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#types-kinds 5738 + // More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds 5647 5739 // +optional 5648 5740 metadata?: metav1.ListMeta @go(ListMeta) @protobuf(1,bytes,opt) 5649 5741 ··· 5656 5748 // the Data field must be less than MaxSecretSize bytes. 5657 5749 Secret: metav1.TypeMeta & { 5658 5750 // Standard object's metadata. 5659 - // More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#metadata 5751 + // More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata 5660 5752 // +optional 5661 5753 metadata?: metav1.ObjectMeta @go(ObjectMeta) @protobuf(1,bytes,opt) 5662 5754 ··· 5787 5879 // SecretList is a list of Secret. 5788 5880 SecretList: metav1.TypeMeta & { 5789 5881 // Standard list metadata. 5790 - // More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#types-kinds 5882 + // More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds 5791 5883 // +optional 5792 5884 metadata?: metav1.ListMeta @go(ListMeta) @protobuf(1,bytes,opt) 5793 5885 ··· 5799 5891 // ConfigMap holds configuration data for pods to consume. 5800 5892 ConfigMap: metav1.TypeMeta & { 5801 5893 // Standard object's metadata. 5802 - // More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#metadata 5894 + // More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata 5803 5895 // +optional 5804 5896 metadata?: metav1.ObjectMeta @go(ObjectMeta) @protobuf(1,bytes,opt) 5805 5897 ··· 5824 5916 5825 5917 // ConfigMapList is a resource containing a list of ConfigMap objects. 5826 5918 ConfigMapList: metav1.TypeMeta & { 5827 - // More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#metadata 5919 + // More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata 5828 5920 // +optional 5829 5921 metadata?: metav1.ListMeta @go(ListMeta) @protobuf(1,bytes,opt) 5830 5922 ··· 5864 5956 // ComponentStatus (and ComponentStatusList) holds the cluster validation info. 5865 5957 ComponentStatus: metav1.TypeMeta & { 5866 5958 // Standard object's metadata. 5867 - // More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#metadata 5959 + // More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata 5868 5960 // +optional 5869 5961 metadata?: metav1.ObjectMeta @go(ObjectMeta) @protobuf(1,bytes,opt) 5870 5962 ··· 5878 5970 // Status of all the conditions for the component as a list of ComponentStatus objects. 5879 5971 ComponentStatusList: metav1.TypeMeta & { 5880 5972 // Standard list metadata. 5881 - // More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#types-kinds 5973 + // More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds 5882 5974 // +optional 5883 5975 metadata?: metav1.ListMeta @go(ListMeta) @protobuf(1,bytes,opt) 5884 5976 ··· 6069 6161 // RangeAllocation is not a public type. 6070 6162 RangeAllocation: metav1.TypeMeta & { 6071 6163 // Standard object's metadata. 6072 - // More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#metadata 6164 + // More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata 6073 6165 // +optional 6074 6166 metadata?: metav1.ObjectMeta @go(ObjectMeta) @protobuf(1,bytes,opt) 6075 6167

+6

doc/tutorial/kubernetes/quick/pkg/k8s.io/api/core/v1/well_known_labels_go_gen.cue

··· 19 19 20 20 // LabelNamespaceNodeRestriction is a forbidden label namespace that kubelets may not self-set when the NodeRestriction admission plugin is enabled 21 21 LabelNamespaceNodeRestriction: "node-restriction.kubernetes.io" 22 + 23 + // IsHeadlessService is added by Controller to an Endpoint denoting if its parent 24 + // Service is Headless. The existence of this label can be used further by other 25 + // controllers and kube-proxy to check if the Endpoint objects should be replicated when 26 + // using Headless Services 27 + IsHeadlessService: "service.kubernetes.io/headless"

-1

doc/tutorial/kubernetes/quick/pkg/k8s.io/api/extensions/v1beta1/types_go_gen.cue

··· 890 890 891 891 // AllowedCSIDrivers is a whitelist of inline CSI drivers that must be explicitly set to be embedded within a pod spec. 892 892 // An empty value indicates that any CSI driver can be used for inline ephemeral volumes. 893 - // This is an alpha field, and is only honored if the API server enables the CSIInlineVolume feature gate. 894 893 // +optional 895 894 allowedCSIDrivers?: [...AllowedCSIDriver] @go(AllowedCSIDrivers,[]AllowedCSIDriver) @protobuf(23,bytes,rep) 896 895

+1 -1

doc/tutorial/kubernetes/quick/pkg/k8s.io/apimachinery/pkg/api/resource/quantity_go_gen.cue

··· 6 6 7 7 // Quantity is a fixed-point representation of a number. 8 8 // It provides convenient marshaling/unmarshaling in JSON and YAML, 9 - // in addition to String() and Int64() accessors. 9 + // in addition to String() and AsInt64() accessors. 10 10 // 11 11 // The serialization format is: 12 12 //

+43 -23

doc/tutorial/kubernetes/quick/pkg/k8s.io/apimachinery/pkg/apis/meta/v1/types_go_gen.cue

··· 28 28 // Servers may infer this from the endpoint the client submits requests to. 29 29 // Cannot be updated. 30 30 // In CamelCase. 31 - // More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#types-kinds 31 + // More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds 32 32 // +optional 33 33 kind?: string @go(Kind) @protobuf(1,bytes,opt) 34 34 35 35 // APIVersion defines the versioned schema of this representation of an object. 36 36 // Servers should convert recognized schemas to the latest internal value, and 37 37 // may reject unrecognized values. 38 - // More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#resources 38 + // More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources 39 39 // +optional 40 40 apiVersion?: string @go(APIVersion) @protobuf(2,bytes,opt) 41 41 } ··· 46 46 // selfLink is a URL representing this object. 47 47 // Populated by the system. 48 48 // Read-only. 49 + // 50 + // DEPRECATED 51 + // Kubernetes will stop propagating this field in 1.20 release and the field is planned 52 + // to be removed in 1.21 release. 49 53 // +optional 50 54 selfLink?: string @go(SelfLink) @protobuf(1,bytes,opt) 51 55 ··· 54 58 // Value must be treated as opaque by clients and passed unmodified back to the server. 55 59 // Populated by the system. 56 60 // Read-only. 57 - // More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#concurrency-control-and-consistency 61 + // More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#concurrency-control-and-consistency 58 62 // +optional 59 63 resourceVersion?: string @go(ResourceVersion) @protobuf(2,bytes,opt) 60 64 ··· 76 80 // Servers older than v1.15 do not set this field. 77 81 // The intended use of the remainingItemCount is *estimating* the size of a collection. Clients 78 82 // should not rely on the remainingItemCount to be set or to be exact. 79 - // 80 - // This field is alpha and can be changed or removed without notice. 81 - // 82 83 // +optional 83 84 remainingItemCount?: null | int64 @go(RemainingItemCount,*int64) @protobuf(4,bytes,opt) 84 85 } ··· 112 113 // should retry (optionally after the time indicated in the Retry-After header). 113 114 // 114 115 // Applied only if Name is not specified. 115 - // More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#idempotency 116 + // More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#idempotency 116 117 // +optional 117 118 generateName?: string @go(GenerateName) @protobuf(2,bytes,opt) 118 119 ··· 130 131 // SelfLink is a URL representing this object. 131 132 // Populated by the system. 132 133 // Read-only. 134 + // 135 + // DEPRECATED 136 + // Kubernetes will stop propagating this field in 1.20 release and the field is planned 137 + // to be removed in 1.21 release. 133 138 // +optional 134 139 selfLink?: string @go(SelfLink) @protobuf(4,bytes,opt) 135 140 ··· 152 157 // Populated by the system. 153 158 // Read-only. 154 159 // Value must be treated as opaque by clients and . 155 - // More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#concurrency-control-and-consistency 160 + // More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#concurrency-control-and-consistency 156 161 // +optional 157 162 resourceVersion?: string @go(ResourceVersion) @protobuf(6,bytes,opt) 158 163 ··· 168 173 // Populated by the system. 169 174 // Read-only. 170 175 // Null for lists. 171 - // More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#metadata 176 + // More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata 172 177 // +optional 173 178 creationTimestamp?: Time @go(CreationTimestamp) @protobuf(8,bytes,opt) 174 179 ··· 189 194 // 190 195 // Populated by the system when a graceful deletion is requested. 191 196 // Read-only. 192 - // More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#metadata 197 + // More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata 193 198 // +optional 194 199 deletionTimestamp?: null | Time @go(DeletionTimestamp,*Time) @protobuf(9,bytes,opt) 195 200 ··· 274 279 apiVersion: string @go(APIVersion) @protobuf(5,bytes,opt) 275 280 276 281 // Kind of the referent. 277 - // More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#types-kinds 282 + // More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds 278 283 kind: string @go(Kind) @protobuf(1,bytes,opt) 279 284 280 285 // Name of the referent. ··· 547 552 // Status is a return value for calls that don't return other objects. 548 553 Status: TypeMeta & { 549 554 // Standard list metadata. 550 - // More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#types-kinds 555 + // More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds 551 556 // +optional 552 557 metadata?: ListMeta @go(ListMeta) @protobuf(1,bytes,opt) 553 558 554 559 // Status of the operation. 555 560 // One of: "Success" or "Failure". 556 - // More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#spec-and-status 561 + // More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#spec-and-status 557 562 // +optional 558 563 status?: string @go(Status) @protobuf(2,bytes,opt) 559 564 ··· 598 603 599 604 // The kind attribute of the resource associated with the status StatusReason. 600 605 // On some operations may differ from the requested resource Kind. 601 - // More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#types-kinds 606 + // More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds 602 607 // +optional 603 608 kind?: string @go(Kind) @protobuf(3,bytes,opt) 604 609 ··· 750 755 // doesn't make any sense, for example deleting a read-only object. This is different than 751 756 // StatusReasonInvalid above which indicates that the API call could possibly succeed, but the 752 757 // data was invalid. API calls that return BadRequest can never succeed. 758 + // Status code 400 753 759 StatusReasonBadRequest: StatusReason & "BadRequest" 754 760 755 761 // StatusReasonMethodNotAllowed means that the action the client attempted to perform on the 756 762 // resource was not supported by the code - for instance, attempting to delete a resource that 757 763 // can only be created. API calls that return MethodNotAllowed can never succeed. 764 + // Status code 405 758 765 StatusReasonMethodNotAllowed: StatusReason & "MethodNotAllowed" 759 766 760 767 // StatusReasonNotAcceptable means that the accept types indicated by the client were not acceptable ··· 864 871 // List holds a list of objects, which may not be known by the server. 865 872 List: TypeMeta & { 866 873 // Standard list metadata. 867 - // More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#types-kinds 874 + // More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds 868 875 // +optional 869 876 metadata?: ListMeta @go(ListMeta) @protobuf(1,bytes,opt) 870 877 ··· 1086 1093 // +optional 1087 1094 time?: null | Time @go(Time,*Time) @protobuf(4,bytes,opt) 1088 1095 1089 - // Fields identifies a set of fields. 1096 + // FieldsType is the discriminator for the different fields format and version. 1097 + // There is currently only one possible value: "FieldsV1" 1098 + fieldsType?: string @go(FieldsType) @protobuf(6,bytes,opt) 1099 + 1100 + // FieldsV1 holds the first JSON version format as described in the "FieldsV1" type. 1090 1101 // +optional 1091 - fields?: null | Fields @go(Fields,*Fields) @protobuf(5,bytes,opt,casttype=Fields) 1102 + fieldsV1?: null | FieldsV1 @go(FieldsV1,*FieldsV1) @protobuf(7,bytes,opt) 1092 1103 } 1093 1104 1094 1105 // ManagedFieldsOperationType is the type of operation which lead to a ManagedFieldsEntry being created. ··· 1101 1112 ManagedFieldsOperationApply: ManagedFieldsOperationType & "Apply" 1102 1113 ManagedFieldsOperationUpdate: ManagedFieldsOperationType & "Update" 1103 1114 1104 - // Fields stores a set of fields in a data structure like a Trie. 1105 - // To understand how this is used, see: https://github.com/kubernetes-sigs/structured-merge-diff 1106 - Fields: _ 1115 + // FieldsV1 stores a set of fields in a data structure like a Trie, in JSON format. 1116 + // 1117 + // Each key is either a '.' representing the field itself, and will always map to an empty set, 1118 + // or a string representing a sub-field or item. The string will follow one of these four formats: 1119 + // 'f:<name>', where <name> is the name of a field in a struct, or key in a map 1120 + // 'v:<value>', where <value> is the exact json formatted value of a list item 1121 + // 'i:<index>', where <index> is position of a item in a list 1122 + // 'k:<keys>', where <keys> is a map of a list item's key fields to their unique values 1123 + // If a key maps to an empty Fields value, the field that key represents is part of the set. 1124 + // 1125 + // The exact format is defined in sigs.k8s.io/structured-merge-diff 1126 + FieldsV1: _ 1107 1127 1108 1128 // Table is a tabular representation of a set of API resources. The server transforms the 1109 1129 // object into a set of preferred columns for quickly reviewing the objects. ··· 1111 1131 // +protobuf=false 1112 1132 Table: TypeMeta & { 1113 1133 // Standard list metadata. 1114 - // More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#types-kinds 1134 + // More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds 1115 1135 // +optional 1116 1136 metadata?: ListMeta @go(ListMeta) 1117 1137 ··· 1248 1268 // +k8s:deepcopy-gen:interfaces=k8s.io/apimachinery/pkg/runtime.Object 1249 1269 PartialObjectMetadata: TypeMeta & { 1250 1270 // Standard object's metadata. 1251 - // More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#metadata 1271 + // More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata 1252 1272 // +optional 1253 1273 metadata?: ObjectMeta @go(ObjectMeta) @protobuf(1,bytes,opt) 1254 1274 } ··· 1257 1277 // +k8s:deepcopy-gen:interfaces=k8s.io/apimachinery/pkg/runtime.Object 1258 1278 PartialObjectMetadataList: TypeMeta & { 1259 1279 // Standard list metadata. 1260 - // More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#types-kinds 1280 + // More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds 1261 1281 // +optional 1262 1282 metadata?: ListMeta @go(ListMeta) @protobuf(1,bytes,opt) 1263 1283

Configure Feed

Configure Feed