mirror of
				https://github.com/k3s-io/kubernetes.git
				synced 2025-10-31 13:50:01 +00:00 
			
		
		
		
	
		
			
				
	
	
		
			166 lines
		
	
	
		
			3.3 KiB
		
	
	
	
		
			Groff
		
	
	
	
	
	
			
		
		
	
	
			166 lines
		
	
	
		
			3.3 KiB
		
	
	
	
		
			Groff
		
	
	
	
	
	
| .TH "KUBERNETES" "1" " kubernetes User Manuals" "Eric Paris" "Jan 2015"  ""
 | |
| 
 | |
| 
 | |
| .SH NAME
 | |
| .PP
 | |
| kubectl exec \- Execute a command in a container.
 | |
| 
 | |
| 
 | |
| .SH SYNOPSIS
 | |
| .PP
 | |
| \fBkubectl exec\fP [OPTIONS]
 | |
| 
 | |
| 
 | |
| .SH DESCRIPTION
 | |
| .PP
 | |
| Execute a command in a container.
 | |
| 
 | |
| 
 | |
| .SH OPTIONS
 | |
| .PP
 | |
| \fB\-c\fP, \fB\-\-container\fP=""
 | |
|     Container name
 | |
| 
 | |
| .PP
 | |
| \fB\-h\fP, \fB\-\-help\fP=false
 | |
|     help for exec
 | |
| 
 | |
| .PP
 | |
| \fB\-p\fP, \fB\-\-pod\fP=""
 | |
|     Pod name
 | |
| 
 | |
| .PP
 | |
| \fB\-i\fP, \fB\-\-stdin\fP=false
 | |
|     Pass stdin to the container
 | |
| 
 | |
| .PP
 | |
| \fB\-t\fP, \fB\-\-tty\fP=false
 | |
|     Stdin is a TTY
 | |
| 
 | |
| 
 | |
| .SH OPTIONS INHERITED FROM PARENT COMMANDS
 | |
| .PP
 | |
| \fB\-\-alsologtostderr\fP=false
 | |
|     log to standard error as well as files
 | |
| 
 | |
| .PP
 | |
| \fB\-\-api\-version\fP=""
 | |
|     The API version to use when talking to the server
 | |
| 
 | |
| .PP
 | |
| \fB\-a\fP, \fB\-\-auth\-path\fP=""
 | |
|     Path to the auth info file. If missing, prompt the user. Only used if using https.
 | |
| 
 | |
| .PP
 | |
| \fB\-\-certificate\-authority\fP=""
 | |
|     Path to a cert. file for the certificate authority.
 | |
| 
 | |
| .PP
 | |
| \fB\-\-client\-certificate\fP=""
 | |
|     Path to a client key file for TLS.
 | |
| 
 | |
| .PP
 | |
| \fB\-\-client\-key\fP=""
 | |
|     Path to a client key file for TLS.
 | |
| 
 | |
| .PP
 | |
| \fB\-\-cluster\fP=""
 | |
|     The name of the kubeconfig cluster to use
 | |
| 
 | |
| .PP
 | |
| \fB\-\-context\fP=""
 | |
|     The name of the kubeconfig context to use
 | |
| 
 | |
| .PP
 | |
| \fB\-\-insecure\-skip\-tls\-verify\fP=false
 | |
|     If true, the server's certificate will not be checked for validity. This will make your HTTPS connections insecure.
 | |
| 
 | |
| .PP
 | |
| \fB\-\-kubeconfig\fP=""
 | |
|     Path to the kubeconfig file to use for CLI requests.
 | |
| 
 | |
| .PP
 | |
| \fB\-\-log\_backtrace\_at\fP=:0
 | |
|     when logging hits line file:N, emit a stack trace
 | |
| 
 | |
| .PP
 | |
| \fB\-\-log\_dir\fP=""
 | |
|     If non\-empty, write log files in this directory
 | |
| 
 | |
| .PP
 | |
| \fB\-\-log\_flush\_frequency\fP=5s
 | |
|     Maximum number of seconds between log flushes
 | |
| 
 | |
| .PP
 | |
| \fB\-\-logtostderr\fP=true
 | |
|     log to standard error instead of files
 | |
| 
 | |
| .PP
 | |
| \fB\-\-match\-server\-version\fP=false
 | |
|     Require server version to match client version
 | |
| 
 | |
| .PP
 | |
| \fB\-\-namespace\fP=""
 | |
|     If present, the namespace scope for this CLI request.
 | |
| 
 | |
| .PP
 | |
| \fB\-\-password\fP=""
 | |
|     Password for basic authentication to the API server.
 | |
| 
 | |
| .PP
 | |
| \fB\-s\fP, \fB\-\-server\fP=""
 | |
|     The address and port of the Kubernetes API server
 | |
| 
 | |
| .PP
 | |
| \fB\-\-stderrthreshold\fP=2
 | |
|     logs at or above this threshold go to stderr
 | |
| 
 | |
| .PP
 | |
| \fB\-\-token\fP=""
 | |
|     Bearer token for authentication to the API server.
 | |
| 
 | |
| .PP
 | |
| \fB\-\-user\fP=""
 | |
|     The name of the kubeconfig user to use
 | |
| 
 | |
| .PP
 | |
| \fB\-\-username\fP=""
 | |
|     Username for basic authentication to the API server.
 | |
| 
 | |
| .PP
 | |
| \fB\-\-v\fP=0
 | |
|     log level for V logs
 | |
| 
 | |
| .PP
 | |
| \fB\-\-validate\fP=false
 | |
|     If true, use a schema to validate the input before sending it
 | |
| 
 | |
| .PP
 | |
| \fB\-\-vmodule\fP=
 | |
|     comma\-separated list of pattern=N settings for file\-filtered logging
 | |
| 
 | |
| 
 | |
| .SH EXAMPLE
 | |
| .PP
 | |
| .RS
 | |
| 
 | |
| .nf
 | |
| // get output from running 'date' in ruby\-container from pod 123456\-7890
 | |
| $ kubectl exec \-p 123456\-7890 \-c ruby\-container date
 | |
| 
 | |
| //switch to raw terminal mode, sends stdin to 'bash' in ruby\-container from pod 123456\-780 and sends stdout/stderr from 'bash' back to the client
 | |
| $ kubectl exec \-p 123456\-7890 \-c ruby\-container \-i \-t \-\- bash \-il
 | |
| 
 | |
| .fi
 | |
| .RE
 | |
| 
 | |
| 
 | |
| .SH SEE ALSO
 | |
| .PP
 | |
| \fBkubectl(1)\fP,
 | |
| 
 | |
| 
 | |
| .SH HISTORY
 | |
| .PP
 | |
| January 2015, Originally compiled by Eric Paris (eparis at redhat dot com) based on the kubernetes source material, but hopefully they have been automatically generated since!
 |