workspace

workspace [create|create-context|use|current|<workspace>|..|.|-|~|<root:absolute:workspace>] [flags]

Examples

# shows the workspace you are currently using
kubectl workspace .

# enter a given workspace (this will change the current-context of your current KUBECONFIG)
kubectl workspace use my-workspace

# short-hand for the use syntax
kubectl workspace my-workspace

# enter a given absolute workspace
kubectl workspace :root:default:my-workspace

# short-hand for the current root workspace
kubectl workspace :

# enter a given relative workspace
kubectl workspace some:nested:workspace

# enter the parent workspace
kubectl workspace ..

# enter the grand parent workspace
kubectl workspace ..:..

# enter the previous workspace
kubectl workspace -

# go to your home workspace
kubectl workspace

# create a workspace and immediately enter it
kubectl workspace create my-workspace --enter

# create a context with the current workspace, e.g. root:default:my-workspace
kubectl workspace create-context

# create a context with the current workspace, named context-name
kubectl workspace create-context context-name

Options

      --add_dir_header                   If true, adds the file directory to the header of the log messages
      --alsologtostderr                  log to standard error as well as files (no effect when -logtostderr=true)
      --as-uid string                    UID to impersonate for the operation
      --certificate-authority string     Path to a cert file for the certificate authority
      --context string                   The name of the kubeconfig context to use
      --disable-compression              If true, opt-out of response compression for all requests to the server
  -h, --help                             help for workspace
      --insecure-skip-tls-verify         If true, the server's certificate will not be checked for validity. This will make your HTTPS connections insecure
      --kubeconfig string                path to the kubeconfig file
      --log_backtrace_at traceLocation   when logging hits line file:N, emit a stack trace (default :0)
      --log_dir string                   If non-empty, write log files in this directory (no effect when -logtostderr=true)
      --log_file string                  If non-empty, use this log file (no effect when -logtostderr=true)
      --log_file_max_size uint           Defines the maximum size a log file can grow to (no effect when -logtostderr=true). Unit is megabytes. If the value is 0, the maximum file size is unlimited. (default 1800)
      --logtostderr                      log to standard error instead of files (default true)
  -n, --namespace string                 If present, the namespace scope for this CLI request
      --one_output                       If true, only write logs to their native severity level (vs also writing to each lower severity level; no effect when -logtostderr=true)
      --password string                  Password for basic authentication to the API server
      --proxy-url string                 If provided, this URL will be used to connect via proxy
      --server string                    The address and port of the Kubernetes API server
      --short                            Print only the name of the workspace, e.g. for integration into the shell prompt
      --skip_headers                     If true, avoid header prefixes in the log messages
      --skip_log_headers                 If true, avoid headers when opening log files (no effect when -logtostderr=true)
      --stderrthreshold severity         logs at or above this threshold go to stderr when writing to files and stderr (no effect when -logtostderr=true or -alsologtostderr=true) (default 2)
      --tls-server-name string           If provided, this name will be used to validate server certificate. If this is not provided, hostname used to contact the server is used.
      --token string                     Bearer token for authentication to the API server
      --user string                      The name of the kubeconfig user to use
      --username string                  Username for basic authentication to the API server
  -v, --v Level                          number for the log level verbosity
      --vmodule moduleSpec               comma-separated list of pattern=N settings for file-filtered logging

See Also

• workspace create-context – Create a kubeconfig context for the current workspace
• workspace current – Print the current workspace. Same as 'kubectl ws .'.
• workspace tree – Print the current workspace tree.
• workspace use – Uses the given workspace as the current workspace. Using - means previous workspace, .. means parent workspace, . mean current, ~ means home workspace