142 lines
4.8 KiB
YAML
142 lines
4.8 KiB
YAML
name: delete
|
|
synopsis: |
|
|
Delete resources by filenames, stdin, resources and names, or by resources and label selector.
|
|
description: |-
|
|
Delete resources by filenames, stdin, resources and names, or by resources and label selector.
|
|
|
|
JSON and YAML formats are accepted.
|
|
|
|
Only one type of the arguments may be specified: filenames, resources and names, or resources and label selector
|
|
|
|
Note that the delete command does NOT do resource version checks, so if someone
|
|
submits an update to a resource right when you submit a delete, their update
|
|
will be lost along with the rest of the resource.
|
|
options:
|
|
- name: all
|
|
default_value: "false"
|
|
usage: '[-all] to select all the specified resources.'
|
|
- name: cascade
|
|
default_value: "true"
|
|
usage: |
|
|
If true, cascade the deletion of the resources managed by this resource (e.g. Pods created by a ReplicationController). Default true.
|
|
- name: filename
|
|
shorthand: f
|
|
default_value: '[]'
|
|
usage: |
|
|
Filename, directory, or URL to a file containing the resource to delete.
|
|
- name: grace-period
|
|
default_value: "-1"
|
|
usage: |
|
|
Period of time in seconds given to the resource to terminate gracefully. Ignored if negative.
|
|
- name: ignore-not-found
|
|
default_value: "false"
|
|
usage: |
|
|
Treat "resource not found" as a successful delete. Defaults to "true" when --all is specified.
|
|
- name: include-extended-apis
|
|
default_value: "true"
|
|
usage: |
|
|
If true, include definitions of new APIs via calls to the API server. [default true]
|
|
- name: now
|
|
default_value: "false"
|
|
usage: |
|
|
If true, resources are force terminated without graceful deletion (same as --grace-period=0).
|
|
- name: output
|
|
shorthand: o
|
|
usage: |
|
|
Output mode. Use "-o name" for shorter output (resource/name).
|
|
- name: recursive
|
|
shorthand: R
|
|
default_value: "false"
|
|
usage: If true, process directory recursively.
|
|
- name: selector
|
|
shorthand: l
|
|
usage: Selector (label query) to filter on.
|
|
- name: timeout
|
|
default_value: "0"
|
|
usage: |
|
|
The length of time to wait before giving up on a delete, zero means determine a timeout from the size of the object
|
|
inherited_options:
|
|
- name: alsologtostderr
|
|
default_value: "false"
|
|
usage: log to standard error as well as files
|
|
- name: api-version
|
|
usage: |
|
|
DEPRECATED: The API version to use when talking to the server
|
|
- name: as
|
|
usage: Username to impersonate for the operation.
|
|
- name: certificate-authority
|
|
usage: Path to a cert. file for the certificate authority.
|
|
- name: client-certificate
|
|
usage: Path to a client certificate file for TLS.
|
|
- name: client-key
|
|
usage: Path to a client key file for TLS.
|
|
- name: cluster
|
|
usage: The name of the kubeconfig cluster to use
|
|
- name: context
|
|
usage: The name of the kubeconfig context to use
|
|
- name: insecure-skip-tls-verify
|
|
default_value: "false"
|
|
usage: |
|
|
If true, the server's certificate will not be checked for validity. This will make your HTTPS connections insecure.
|
|
- name: kubeconfig
|
|
usage: Path to the kubeconfig file to use for CLI requests.
|
|
- name: log-backtrace-at
|
|
default_value: :0
|
|
usage: when logging hits line file:N, emit a stack trace
|
|
- name: log-dir
|
|
usage: If non-empty, write log files in this directory
|
|
- name: log-flush-frequency
|
|
default_value: 5s
|
|
usage: Maximum number of seconds between log flushes
|
|
- name: logtostderr
|
|
default_value: "true"
|
|
usage: log to standard error instead of files
|
|
- name: match-server-version
|
|
default_value: "false"
|
|
usage: Require server version to match client version
|
|
- name: namespace
|
|
usage: If present, the namespace scope for this CLI request.
|
|
- name: password
|
|
usage: Password for basic authentication to the API server.
|
|
- name: server
|
|
shorthand: s
|
|
usage: The address and port of the Kubernetes API server
|
|
- name: stderrthreshold
|
|
default_value: "2"
|
|
usage: logs at or above this threshold go to stderr
|
|
- name: token
|
|
usage: Bearer token for authentication to the API server.
|
|
- name: user
|
|
usage: The name of the kubeconfig user to use
|
|
- name: username
|
|
usage: Username for basic authentication to the API server.
|
|
- name: v
|
|
default_value: "0"
|
|
usage: log level for V logs
|
|
- name: vmodule
|
|
usage: |
|
|
comma-separated list of pattern=N settings for file-filtered logging
|
|
example: |-
|
|
# Delete a pod using the type and name specified in pod.json.
|
|
kubectl delete -f ./pod.json
|
|
|
|
# Delete a pod based on the type and name in the JSON passed into stdin.
|
|
cat pod.json | kubectl delete -f -
|
|
|
|
# Delete pods and services with same names "baz" and "foo"
|
|
kubectl delete pod,service baz foo
|
|
|
|
# Delete pods and services with label name=myLabel.
|
|
kubectl delete pods,services -l name=myLabel
|
|
|
|
# Delete a pod immediately (no graceful shutdown)
|
|
kubectl delete pod foo --now
|
|
|
|
# Delete a pod with UID 1234-56-7890-234234-456456.
|
|
kubectl delete pod 1234-56-7890-234234-456456
|
|
|
|
# Delete all pods
|
|
kubectl delete pods --all
|
|
see_also:
|
|
- kubectl
|