You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
For general information about working with config files, see [object management](/docs/concepts/overview/working-with-objects/object-management/).
126
+
For general information about working with configuration files, see [object management](/docs/concepts/overview/working-with-objects/object-management/).
121
127
122
128
A ReplicationController also needs a [`.spec` section](https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#spec-and-status).
123
129
@@ -139,7 +145,7 @@ for example the [Kubelet](/docs/reference/command-line-tools-reference/kubelet/)
139
145
140
146
The ReplicationController can itself have labels (`.metadata.labels`). Typically, you
141
147
would set these the same as the `.spec.template.metadata.labels`; if `.metadata.labels` is not specified
142
-
then it defaults to `.spec.template.metadata.labels`. However, they are allowed to be
148
+
then it defaults to `.spec.template.metadata.labels`. However, they are allowed to be
143
149
different, and the `.metadata.labels` do not affect the behavior of the ReplicationController.
144
150
145
151
### Pod Selector
@@ -197,7 +203,7 @@ To update pods to a new spec in a controlled way, use a [rolling update](#rollin
197
203
198
204
### Isolating pods from a ReplicationController
199
205
200
-
Pods may be removed from a ReplicationController's target set by changing their labels. This technique may be used to remove pods from service for debugging, data recovery, etc. Pods that are removed in this way will be replaced automatically (assuming that the number of replicas is not also changed).
206
+
Pods may be removed from a ReplicationController's target set by changing their labels. This technique may be used to remove pods from service for debugging and data recovery. Pods that are removed in this way will be replaced automatically (assuming that the number of replicas is not also changed).
201
207
202
208
## Common usage patterns
203
209
@@ -207,8 +213,7 @@ As mentioned above, whether you have 1 pod you want to keep running, or 1000, a
207
213
208
214
### Scaling
209
215
210
-
The ReplicationController scales the number of replicas up or down by setting the `replicas` field.
211
-
You can configure the ReplicationController to manage the replicas manually or by an auto-scaling control agent.
216
+
The ReplicationController enables scaling the number of replicas up or down, either manually or by an auto-scaling control agent, by updating the `replicas` field.
212
217
213
218
### Rolling updates
214
219
@@ -245,7 +250,6 @@ The ReplicationController is forever constrained to this narrow responsibility.
245
250
246
251
The ReplicationController is intended to be a composable building-block primitive. We expect higher-level APIs and/or tools to be built on top of it and other complementary primitives for user convenience in the future. The "macro" operations currently supported by kubectl (run, scale) are proof-of-concept examples of this. For instance, we could imagine something like [Asgard](https://techblog.netflix.com/2012/06/asgard-web-based-cloud-management-and.html) managing ReplicationControllers, auto-scalers, services, scheduling policies, canaries, etc.
247
252
248
-
249
253
## API Object
250
254
251
255
Replication controller is a top-level resource in the Kubernetes REST API. More details about the
@@ -260,7 +264,6 @@ API object can be found at:
260
264
It's mainly used by [Deployment](/docs/concepts/workloads/controllers/deployment/) as a mechanism to orchestrate pod creation, deletion and updates.
261
265
Note that we recommend using Deployments instead of directly using Replica Sets, unless you require custom update orchestration or don't require updates at all.
262
266
263
-
264
267
### Deployment (Recommended)
265
268
266
269
[`Deployment`](/docs/concepts/workloads/controllers/deployment/) is a higher-level API object that updates its underlying Replica Sets and their Pods. Deployments are recommended if you want this rolling update functionality because, they are declarative, server-side, and have additional features.
@@ -284,5 +287,3 @@ safe to terminate when the machine is otherwise ready to be rebooted/shutdown.
0 commit comments