Skip to content

Commit e9e5759

Browse files
authored
kubectl*: standardize pages (#18527)
1 parent 91106ac commit e9e5759

12 files changed

+31
-31
lines changed

pages/common/kubectl-api-resources.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -25,4 +25,4 @@
2525

2626
- Print the supported API resources with a specific API group:
2727

28-
`kubectl api-resources --api-group={{api_group}}`
28+
`kubectl api-resources --api-group {{api_group}}`

pages/common/kubectl-autoscale.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -5,8 +5,8 @@
55
66
- Auto scale a deployment with no target CPU utilization specified:
77

8-
`kubectl autoscale {{[deploy|deployment]}} {{deployment_name}} --min={{min_replicas}} --max={{max_replicas}}`
8+
`kubectl autoscale {{[deploy|deployment]}} {{deployment_name}} --min {{min_replicas}} --max {{max_replicas}}`
99

1010
- Auto scale a deployment with target CPU utilization:
1111

12-
`kubectl autoscale {{[deploy|deployment]}} {{deployment_name}} --max={{max_replicas}} --cpu-percent={{target_cpu}}`
12+
`kubectl autoscale {{[deploy|deployment]}} {{deployment_name}} --max {{max_replicas}} --cpu-percent {{target_cpu}}`

pages/common/kubectl-create.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -13,15 +13,15 @@
1313

1414
- Create a deployment:
1515

16-
`kubectl create {{[deploy|deployment]}} {{deployment_name}} --image={{image}}`
16+
`kubectl create {{[deploy|deployment]}} {{deployment_name}} --image {{image}}`
1717

1818
- Create a deployment with replicas:
1919

20-
`kubectl create {{[deploy|deployment]}} {{deployment_name}} --image={{image}} --replicas={{number_of_replicas}}`
20+
`kubectl create {{[deploy|deployment]}} {{deployment_name}} --image {{image}} --replicas {{number_of_replicas}}`
2121

2222
- Create a service:
2323

24-
`kubectl create {{[svc|service]}} {{service_type}} {{service_name}} --tcp={{port}}:{{target_port}}`
24+
`kubectl create {{[svc|service]}} {{service_type}} {{service_name}} --tcp {{port}}:{{target_port}}`
2525

2626
- Create a namespace:
2727

pages/common/kubectl-delete.md

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -5,23 +5,23 @@
55
66
- Delete a specific pod:
77

8-
`kubectl delete {{[po|pod]}} {{pod_name}}`
8+
`kubectl delete {{[po|pods]}} {{pod_name}}`
99

1010
- Delete a specific deployment:
1111

12-
`kubectl delete {{[deploy|deployment]}} {{deployment_name}}`
12+
`kubectl delete {{[deploy|deployments]}} {{deployment_name}}`
1313

1414
- Delete a specific node:
1515

16-
`kubectl delete {{[no|node]}} {{node_name}}`
16+
`kubectl delete {{[no|nodes]}} {{node_name}}`
1717

1818
- Delete all pods in a specified namespace:
1919

2020
`kubectl delete {{[po|pods]}} --all {{[-n|--namespace]}} {{namespace}}`
2121

2222
- Delete all deployments and services in a specified namespace:
2323

24-
`kubectl delete {{[deploy|deployment]}},{{[svc|services]}} --all {{[-n|--namespace]}} {{namespace}}`
24+
`kubectl delete {{[deploy|deployments]}},{{[svc|services]}} --all {{[-n|--namespace]}} {{namespace}}`
2525

2626
- Delete all nodes:
2727

pages/common/kubectl-edit.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,7 @@
55
66
- Edit a pod in the default namespace:
77

8-
`kubectl edit {{[po|pod]}}/{{pod_name}}`
8+
`kubectl edit {{[po|pods]}}/{{pod_name}}`
99

1010
- Edit a deployment in the default namespace:
1111

pages/common/kubectl-expose.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -5,12 +5,12 @@
55
66
- Create a service for a resource, which will be served from container port to node port:
77

8-
`kubectl expose {{resource_type}} {{resource_name}} --port={{node_port}} --target-port={{container_port}}`
8+
`kubectl expose {{resource_type}} {{resource_name}} --port {{node_port}} --target-port {{container_port}}`
99

1010
- Create a service for a resource identified by a file:
1111

12-
`kubectl expose {{[-f|--filename]}} {{path/to/file.yml}} --port={{node_port}} --target-port={{container_port}}`
12+
`kubectl expose {{[-f|--filename]}} {{path/to/file.yml}} --port {{node_port}} --target-port {{container_port}}`
1313

1414
- Create a service with a name, to serve to a node port which will be same for container port:
1515

16-
`kubectl expose {{resource_type}} {{resource_name}} --port={{node_port}} --name={{service_name}}`
16+
`kubectl expose {{resource_type}} {{resource_name}} --port {{node_port}} --name {{service_name}}`

pages/common/kubectl-label.md

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -5,20 +5,20 @@
55
66
- Label a pod:
77

8-
`kubectl label {{[po|pod]}} {{pod_name}} {{key}}={{value}}`
8+
`kubectl label {{[po|pods]}} {{pod_name}} {{key}}={{value}}`
99

1010
- Update a pod label by overwriting the existing value:
1111

12-
`kubectl label --overwrite pod {{pod_name}} {{key}}={{value}}`
12+
`kubectl label {{[po|pods]}} {{pod_name}} {{key}}={{value}} --overwrite`
1313

1414
- Label all pods in the namespace:
1515

16-
`kubectl label {{[po|pods]}} --all {{key}}={{value}}`
16+
`kubectl label {{[po|pods]}} {{key}}={{value}} --all`
1717

1818
- Label a pod identified by the pod definition file:
1919

2020
`kubectl label {{[-f|--filename]}} {{pod_definition_file}} {{key}}={{value}}`
2121

2222
- Remove the label from a pod:
2323

24-
`kubectl label {{[po|pod]}} {{pod_name}} {{key}}-`
24+
`kubectl label {{[po|pods]}} {{pod_name}} {{key}}-`

pages/common/kubectl-logs.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -21,12 +21,12 @@
2121

2222
- Show pod logs newer than a relative time like `10s`, `5m`, or `1h`:
2323

24-
`kubectl logs --since={{relative_time}} {{pod_name}}`
24+
`kubectl logs --since {{relative_time}} {{pod_name}}`
2525

2626
- Show the 10 most recent logs in a pod:
2727

28-
`kubectl logs --tail={{10}} {{pod_name}}`
28+
`kubectl logs --tail {{10}} {{pod_name}}`
2929

3030
- Show all pod logs for a given deployment:
3131

32-
`kubectl logs deployment/{{deployment_name}}`
32+
`kubectl logs {{[deploy|deployment]}}/{{deployment_name}}`

pages/common/kubectl-replace.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -13,4 +13,4 @@
1313

1414
- Force replace, delete and then re-create the resource:
1515

16-
`kubectl replace --force {{[-f|--filename]}} {{path/to/file.yml}}`
16+
`kubectl replace {{[-f|--filename]}} {{path/to/file.yml}} --force`

pages/common/kubectl-run.md

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -5,20 +5,20 @@
55
66
- Run an nginx pod and expose port 80:
77

8-
`kubectl run {{nginx-dev}} --image=nginx --port 80`
8+
`kubectl run {{nginx-dev}} --image nginx --port 80`
99

1010
- Run an nginx pod, setting the TEST_VAR environment variable:
1111

12-
`kubectl run {{nginx-dev}} --image=nginx --env="{{TEST_VAR}}={{testing}}"`
12+
`kubectl run {{nginx-dev}} --image nginx --env "{{TEST_VAR}}={{testing}}"`
1313

1414
- Show API calls that would be made to create an nginx container:
1515

16-
`kubectl run {{nginx-dev}} --image=nginx --dry-run={{none|server|client}}`
16+
`kubectl run {{nginx-dev}} --image nginx --dry-run={{none|server|client}}`
1717

1818
- Run an Ubuntu pod interactively, never restart it, and remove it when it exits:
1919

20-
`kubectl run {{temp-ubuntu}} --image=ubuntu:22.04 --restart=Never --rm -- /bin/bash`
20+
`kubectl run {{temp-ubuntu}} --image ubuntu:22.04 --restart Never --rm -- /bin/bash`
2121

2222
- Run an Ubuntu pod, overriding the default command with echo, and specifying custom arguments:
2323

24-
`kubectl run {{temp-ubuntu}} --image=ubuntu:22.04 --command -- echo {{argument1 argument2 ...}}`
24+
`kubectl run {{temp-ubuntu}} --image ubuntu:22.04 --command -- echo {{argument1 argument2 ...}}`

0 commit comments

Comments
 (0)