.TH "OPENSHIFT ADMIN" "1" " Openshift CLI User Manuals" "Openshift" "June 2016"  ""


.SH NAME
.PP
openshift admin manage\-node \- Manage nodes \- list pods, evacuate, or mark ready


.SH SYNOPSIS
.PP
\fBopenshift admin manage\-node\fP [OPTIONS]


.SH DESCRIPTION
.PP
Manage nodes

.PP
This command provides common operations on nodes for administrators.

.PP
schedulable: Marking node schedulable will allow pods to be schedulable on the node and marking node unschedulable will block pods to be scheduled on the node.

.PP
evacuate: Migrate all/selected pod on the provided nodes.

.PP
list\-pods: List all/selected pods on given/selected nodes. It can list the output in json/yaml format.


.SH OPTIONS
.PP
\fB\-\-dry\-run\fP=false
    Show pods that will be migrated. Optional param for \-\-evacuate

.PP
\fB\-\-evacuate\fP=false
    Migrate all/selected pods on the node.

.PP
\fB\-\-force\fP=false
    Delete pods not backed by replication controller. Optional param for \-\-evacuate

.PP
\fB\-\-grace\-period\fP=30
    Grace period (seconds) for pods being deleted. Ignored if negative. Optional param for \-\-evacuate

.PP
\fB\-\-list\-pods\fP=false
    List all/selected pods on the node. Printer flags \-\-output, etc. are only valid for this option.

.PP
\fB\-\-no\-headers\fP=false
    When using the default or custom\-column output format, don't print headers.

.PP
\fB\-o\fP, \fB\-\-output\fP=""
    Output format. One of: json|yaml|wide|name|custom\-columns=...|custom\-columns\-file=...|go\-template=...|go\-template\-file=...|jsonpath=...|jsonpath\-file=... See custom columns [
\[la]http://kubernetes.io/docs/user-guide/kubectl-overview/#custom-columns\[ra]], golang template [
\[la]http://golang.org/pkg/text/template/#pkg-overview\[ra]] and jsonpath template [
\[la]http://kubernetes.io/docs/user-guide/jsonpath\[ra]].

.PP
\fB\-\-output\-version\fP=""
    Output the formatted object with the given group version (for ex: 'extensions/v1beta1').

.PP
\fB\-\-pod\-selector\fP=""
    Label selector to filter pods on the node. Optional param for \-\-evacuate or \-\-list\-pods

.PP
\fB\-\-schedulable\fP=false
    Control pod schedulability on the node.

.PP
\fB\-\-selector\fP=""
    Label selector to filter nodes. Either pass one/more nodes as arguments or use this node selector

.PP
\fB\-a\fP, \fB\-\-show\-all\fP=false
    When printing, show all resources (default hide terminated pods.)

.PP
\fB\-\-show\-labels\fP=false
    When printing, show all labels as the last column (default hide labels column)

.PP
\fB\-\-sort\-by\fP=""
    If non\-empty, sort list types using this field specification.  The field specification is expressed as a JSONPath expression (e.g. '{.metadata.name}'). The field in the API resource specified by this JSONPath expression must be an integer or a string.

.PP
\fB\-\-template\fP=""
    Template string or path to template file to use when \-o=go\-template, \-o=go\-template\-file. The template format is golang templates [
\[la]http://golang.org/pkg/text/template/#pkg-overview\[ra]].


.SH OPTIONS INHERITED FROM PARENT COMMANDS
.PP
\fB\-\-api\-version\fP=""
    DEPRECATED: The API version to use when talking to the server

.PP
\fB\-\-as\fP=""
    Username to impersonate for the operation

.PP
\fB\-\-certificate\-authority\fP=""
    Path to a cert. file for the certificate authority

.PP
\fB\-\-client\-certificate\fP=""
    Path to a client certificate 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\-\-config\fP=""
    Path to the config file to use for CLI requests.

.PP
\fB\-\-context\fP=""
    The name of the kubeconfig context to use

.PP
\fB\-\-google\-json\-key\fP=""
    The Google Cloud Platform Service Account JSON Key to use for authentication.

.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\-\-log\-flush\-frequency\fP=0
    Maximum number of seconds between log flushes

.PP
\fB\-\-match\-server\-version\fP=false
    Require server version to match client version

.PP
\fB\-n\fP, \fB\-\-namespace\fP=""
    If present, the namespace scope for this CLI request

.PP
\fB\-\-request\-timeout\fP="0"
    The length of time to wait before giving up on a single server request. Non\-zero values should contain a corresponding time unit (e.g. 1s, 2m, 3h). A value of zero means don't timeout requests.

.PP
\fB\-\-server\fP=""
    The address and port of the Kubernetes API server

.PP
\fB\-\-token\fP=""
    Bearer token for authentication to the API server

.PP
\fB\-\-user\fP=""
    The name of the kubeconfig user to use


.SH EXAMPLE
.PP
.RS

.nf
  # Block accepting any pods on given nodes
  openshift admin manage\-node <mynode> \-\-schedulable=false
  
  # Mark selected nodes as schedulable
  openshift admin manage\-node \-\-selector="<env=dev>" \-\-schedulable=true
  
  # Migrate selected pods
  openshift admin manage\-node <mynode> \-\-evacuate \-\-pod\-selector="<service=myapp>"
  
  # Migrate selected pods, use a grace period of 60 seconds
  openshift admin manage\-node <mynode> \-\-evacuate \-\-grace\-period=60 \-\-pod\-selector="<service=myapp>"
  
  # Migrate selected pods not backed by replication controller
  openshift admin manage\-node <mynode> \-\-evacuate \-\-force \-\-pod\-selector="<service=myapp>"
  
  # Show pods that will be migrated
  openshift admin manage\-node <mynode> \-\-evacuate \-\-dry\-run \-\-pod\-selector="<service=myapp>"
  
  # List all pods on given nodes
  openshift admin manage\-node <mynode1> <mynode2> \-\-list\-pods

.fi
.RE


.SH SEE ALSO
.PP
\fBopenshift\-admin(1)\fP,


.SH HISTORY
.PP
June 2016, Ported from the Kubernetes man\-doc generator