Skip to content

Commit fe2f1e2

Browse files
committed
fixup rc text
1 parent 6bff481 commit fe2f1e2

File tree

1 file changed

+10
-9
lines changed

1 file changed

+10
-9
lines changed

content/en/docs/concepts/workloads/controllers/replicationcontroller.md

Lines changed: 10 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -54,7 +54,9 @@ Run the example job by downloading the example file and then running this comman
5454
```shell
5555
kubectl apply -f https://k8s.io/examples/controllers/replication.yaml
5656
```
57+
5758
The output is similar to this:
59+
5860
```
5961
replicationcontroller/nginx created
6062
```
@@ -64,7 +66,9 @@ Check on the status of the ReplicationController using this command:
6466
```shell
6567
kubectl describe replicationcontrollers/nginx
6668
```
69+
6770
The output is similar to this:
71+
6872
```
6973
Name: nginx
7074
Namespace: default
@@ -103,7 +107,9 @@ To list all the pods that belong to the ReplicationController in a machine reada
103107
pods=$(kubectl get pods --selector=app=nginx --output=jsonpath={.items..metadata.name})
104108
echo $pods
105109
```
110+
106111
The output is similar to this:
112+
107113
```
108114
nginx-3ntk0 nginx-4ok8v nginx-qrm3m
109115
```
@@ -117,7 +123,7 @@ specifies an expression with the name from each pod in the returned list.
117123
As with all other Kubernetes config, a ReplicationController needs `apiVersion`, `kind`, and `metadata` fields.
118124
The name of a ReplicationController object must be a valid
119125
[DNS subdomain name](/docs/concepts/overview/working-with-objects/names#dns-subdomain-names).
120-
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/).
121127

122128
A ReplicationController also needs a [`.spec` section](https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#spec-and-status).
123129

@@ -139,7 +145,7 @@ for example the [Kubelet](/docs/reference/command-line-tools-reference/kubelet/)
139145

140146
The ReplicationController can itself have labels (`.metadata.labels`). Typically, you
141147
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
143149
different, and the `.metadata.labels` do not affect the behavior of the ReplicationController.
144150

145151
### Pod Selector
@@ -197,7 +203,7 @@ To update pods to a new spec in a controlled way, use a [rolling update](#rollin
197203

198204
### Isolating pods from a ReplicationController
199205

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).
201207

202208
## Common usage patterns
203209

@@ -207,8 +213,7 @@ As mentioned above, whether you have 1 pod you want to keep running, or 1000, a
207213

208214
### Scaling
209215

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.
212217

213218
### Rolling updates
214219

@@ -245,7 +250,6 @@ The ReplicationController is forever constrained to this narrow responsibility.
245250

246251
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.
247252

248-
249253
## API Object
250254

251255
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:
260264
It's mainly used by [Deployment](/docs/concepts/workloads/controllers/deployment/) as a mechanism to orchestrate pod creation, deletion and updates.
261265
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.
262266

263-
264267
### Deployment (Recommended)
265268

266269
[`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.
284287
## For more information
285288

286289
Read [Run Stateless Application Deployment](/docs/tasks/run-application/run-stateless-application-deployment/).
287-
288-

0 commit comments

Comments
 (0)