1 KIND:     ReplicaSet
  2 VERSION:  apps/v1
  3 
  4 RESOURCE: template <Object>
  5 
  6 DESCRIPTION:
  7      Template is the object that describes the pod that will be created if
  8      insufficient replicas are detected. More info:
  9      https://kubernetes.io/docs/concepts/workloads/controllers/replicationcontroller#pod-template
 10 
 11      PodTemplateSpec describes the data a pod should have when created from a
 12      template
 13 
 14 FIELDS:
 15    metadata    <Object>
 16      Standard object‘s metadata. More info:
 17      https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata
 18 
 19    spec    <Object>
 20      Specification of the desired behavior of the pod. More info:
 21      https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#spec-and-status
 22 
 23 [root@kmaster manifests]# kubectl explain rs.spec.template.spec
 24 KIND:     ReplicaSet
 25 VERSION:  apps/v1
 26 
 27 RESOURCE: spec <Object>
 28 
 29 DESCRIPTION:
 30      Specification of the desired behavior of the pod. More info:
 31      https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#spec-and-status
 32 
 33      PodSpec is a description of a pod.
 34 
 35 FIELDS:
 36    activeDeadlineSeconds    <integer>
 37      Optional duration in seconds the pod may be active on the node relative to
 38      StartTime before the system will actively try to mark it failed and kill
 39      associated containers. Value must be a positive integer.
 40 
 41    affinity    <Object>
 42      If specified, the pod‘s scheduling constraints
 43 
 44    automountServiceAccountToken    <boolean>
 45      AutomountServiceAccountToken indicates whether a service account token
 46      should be automatically mounted.
 47 
 48    containers    <[]Object> -required-
 49      List of containers belonging to the pod. Containers cannot currently be
 50      added or removed. There must be at least one container in a Pod. Cannot be
 51      updated.
 52 
 53    dnsConfig    <Object>
 54      Specifies the DNS parameters of a pod. Parameters specified here will be
 55      merged to the generated DNS configuration based on DNSPolicy.
 56 
 57    dnsPolicy    <string>
 58      Set DNS policy for the pod. Defaults to "ClusterFirst". Valid values are
 59      ‘ClusterFirstWithHostNet‘, ‘ClusterFirst‘, ‘Default‘ or ‘None‘. DNS
 60      parameters given in DNSConfig will be merged with the policy selected with
 61      DNSPolicy. To have DNS options set along with hostNetwork, you have to
 62      specify DNS policy explicitly to ‘ClusterFirstWithHostNet‘.
 63 
 64    enableServiceLinks    <boolean>
 65      EnableServiceLinks indicates whether information about services should be
 66      injected into pod‘s environment variables, matching the syntax of Docker
 67      links. Optional: Defaults to true.
 68 
 69    ephemeralContainers    <[]Object>
 70      List of ephemeral containers run in this pod. Ephemeral containers may be
 71      run in an existing pod to perform user-initiated actions such as debugging.
 72      This list cannot be specified when creating a pod, and it cannot be
 73      modified by updating the pod spec. In order to add an ephemeral container
 74      to an existing pod, use the pod‘s ephemeralcontainers subresource. This
 75      field is alpha-level and is only honored by servers that enable the
 76      EphemeralContainers feature.
 77 
 78    hostAliases    <[]Object>
 79      HostAliases is an optional list of hosts and IPs that will be injected into
 80      the pod‘s hosts file if specified. This is only valid for non-hostNetwork
 81      pods.
 82 
 83    hostIPC    <boolean>
 84      Use the host‘s ipc namespace. Optional: Default to false.
 85 
 86    hostNetwork    <boolean>
 87      Host networking requested for this pod. Use the host‘s network namespace.
 88      If this option is set, the ports that will be used must be specified.
 89      Default to false.
 90 
 91    hostPID    <boolean>
 92      Use the host‘s pid namespace. Optional: Default to false.
 93 
 94    hostname    <string>
 95      Specifies the hostname of the Pod If not specified, the pod‘s hostname will
 96      be set to a system-defined value.
 97 
 98    imagePullSecrets    <[]Object>
 99      ImagePullSecrets is an optional list of references to secrets in the same
100      namespace to use for pulling any of the images used by this PodSpec. If
101      specified, these secrets will be passed to individual puller
102      implementations for them to use. For example, in the case of docker, only
103      DockerConfig type secrets are honored. More info:
104      https://kubernetes.io/docs/concepts/containers/images#specifying-imagepullsecrets-on-a-pod
105 
106    initContainers    <[]Object>
107      List of initialization containers belonging to the pod. Init containers are
108      executed in order prior to containers being started. If any init container
109      fails, the pod is considered to have failed and is handled according to its
110      restartPolicy. The name for an init container or normal container must be
111      unique among all containers. Init containers may not have Lifecycle
112      actions, Readiness probes, Liveness probes, or Startup probes. The
113      resourceRequirements of an init container are taken into account during
114      scheduling by finding the highest request/limit for each resource type, and
115      then using the max of of that value or the sum of the normal containers.
116      Limits are applied to init containers in a similar fashion. Init containers
117      cannot currently be added or removed. Cannot be updated. More info:
118      https://kubernetes.io/docs/concepts/workloads/pods/init-containers/
119 
120    nodeName    <string>
121      NodeName is a request to schedule this pod onto a specific node. If it is
122      non-empty, the scheduler simply schedules this pod onto that node, assuming
123      that it fits resource requirements.
124 
125    nodeSelector    <map[string]string>
126      NodeSelector is a selector which must be true for the pod to fit on a node.
127      Selector which must match a node‘s labels for the pod to be scheduled on
128      that node. More info:
129      https://kubernetes.io/docs/concepts/configuration/assign-pod-node/
130 
131    overhead    <map[string]string>
132      Overhead represents the resource overhead associated with running a pod for
133      a given RuntimeClass. This field will be autopopulated at admission time by
134      the RuntimeClass admission controller. If the RuntimeClass admission
135      controller is enabled, overhead must not be set in Pod create requests. The
136      RuntimeClass admission controller will reject Pod create requests which
137      have the overhead already set. If RuntimeClass is configured and selected
138      in the PodSpec, Overhead will be set to the value defined in the
139      corresponding RuntimeClass, otherwise it will remain unset and treated as
140      zero. More info:
141      https://git.k8s.io/enhancements/keps/sig-node/20190226-pod-overhead.md This
142      field is alpha-level as of Kubernetes v1.16, and is only honored by servers
143      that enable the PodOverhead feature.
144 
145    preemptionPolicy    <string>
146      PreemptionPolicy is the Policy for preempting pods with lower priority. One
147      of Never, PreemptLowerPriority. Defaults to PreemptLowerPriority if unset.
148      This field is alpha-level and is only honored by servers that enable the
149      NonPreemptingPriority feature.
150 
151    priority    <integer>
152      The priority value. Various system components use this field to find the
153      priority of the pod. When Priority Admission Controller is enabled, it
154      prevents users from setting this field. The admission controller populates
155      this field from PriorityClassName. The higher the value, the higher the
156      priority.
157 
158    priorityClassName    <string>
159      If specified, indicates the pod‘s priority. "system-node-critical" and
160      "system-cluster-critical" are two special keywords which indicate the
161      highest priorities with the former being the highest priority. Any other
162      name must be defined by creating a PriorityClass object with that name. If
163      not specified, the pod priority will be default or zero if there is no
164      default.
165 
166    readinessGates    <[]Object>
167      If specified, all readiness gates will be evaluated for pod readiness. A
168      pod is ready when all its containers are ready AND all conditions specified
169      in the readiness gates have status equal to "True" More info:
170      https://git.k8s.io/enhancements/keps/sig-network/0007-pod-ready%2B%2B.md
171 
172    restartPolicy    <string>
173      Restart policy for all containers within the pod. One of Always, OnFailure,
174      Never. Default to Always. More info:
175      https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle/#restart-policy
176 
177    runtimeClassName    <string>
178      RuntimeClassName refers to a RuntimeClass object in the node.k8s.io group,
179      which should be used to run this pod. If no RuntimeClass resource matches
180      the named class, the pod will not be run. If unset or empty, the "legacy"
181      RuntimeClass will be used, which is an implicit class with an empty
182      definition that uses the default runtime handler. More info:
183      https://git.k8s.io/enhancements/keps/sig-node/runtime-class.md This is a
184      beta feature as of Kubernetes v1.14.
185 
186    schedulerName    <string>
187      If specified, the pod will be dispatched by specified scheduler. If not
188      specified, the pod will be dispatched by default scheduler.
189 
190    securityContext    <Object>
191      SecurityContext holds pod-level security attributes and common container
192      settings. Optional: Defaults to empty. See type description for default
193      values of each field.
194 
195    serviceAccount    <string>
196      DeprecatedServiceAccount is a depreciated alias for ServiceAccountName.
197      Deprecated: Use serviceAccountName instead.
198 
199    serviceAccountName    <string>
200      ServiceAccountName is the name of the ServiceAccount to use to run this
201      pod. More info:
202      https://kubernetes.io/docs/tasks/configure-pod-container/configure-service-account/
203 
204    shareProcessNamespace    <boolean>
205      Share a single process namespace between all of the containers in a pod.
206      When this is set containers will be able to view and signal processes from
207      other containers in the same pod, and the first process in each container
208      will not be assigned PID 1. HostPID and ShareProcessNamespace cannot both
209      be set. Optional: Default to false.
210 
211    subdomain    <string>
212      If specified, the fully qualified Pod hostname will be
213      "<hostname>.<subdomain>.<pod namespace>.svc.<cluster domain>". If not
214      specified, the pod will not have a domainname at all.
215 
216    terminationGracePeriodSeconds    <integer>
217      Optional duration in seconds the pod needs to terminate gracefully. May be
218      decreased in delete request. Value must be non-negative integer. The value
219      zero indicates delete immediately. If this value is nil, the default grace
220      period will be used instead. The grace period is the duration in seconds
221      after the processes running in the pod are sent a termination signal and
222      the time when the processes are forcibly halted with a kill signal. Set
223      this value longer than the expected cleanup time for your process. Defaults
224      to 30 seconds.
225 
226    tolerations    <[]Object>
227      If specified, the pod‘s tolerations.
228 
229    topologySpreadConstraints    <[]Object>
230      TopologySpreadConstraints describes how a group of pods ought to spread
231      across topology domains. Scheduler will schedule pods in a way which abides
232      by the constraints. This field is only honored by clusters that enable the
233      EvenPodsSpread feature. All topologySpreadConstraints are ANDed.
234 
235    volumes    <[]Object>
236      List of volumes that can be mounted by containers belonging to the pod.
237      More info: https://kubernetes.io/docs/concepts/storage/volumes