/usr/local/bin/kubectl-ws

Manages kcp workspaces

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

Aliases:
  workspace, ws, workspaces

Examples:

# shows the workspace you are currently using
kubectl workspace .

# interactive workspace tree browser
kubectl workspace -i

# 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


Available Commands:
  completion     Generate the autocompletion script for the specified shell
  create-context Create a kubeconfig context for the current workspace
  current        Print the current workspace. Same as 'kubectl ws .'.
  help           Help about any command
  tree           Print the current workspace tree.
  use            Uses the given workspace as the current workspace. Using - means previous workspace, .. means parent workspace, . mean current, ~ means home workspace

Flags:
      --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)
      --alsologtostderrthreshold severity   logs at or above this threshold go to stderr when -alsologtostderr=true (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
  -i, --interactive                         Interactive workspace tree browser
      --kubeconfig string                   Path to the kubeconfig file
      --legacy_stderr_threshold_behavior    If true, stderrthreshold is ignored when logtostderr=true (legacy behavior). If false, stderrthreshold is honored even when logtostderr=true
      --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 unless -legacy_stderr_threshold_behavior=false)
      --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
      --version                             version for workspace
      --vmodule moduleSpec                  comma-separated list of pattern=N settings for file-filtered logging

Use "workspace [command] --help" for more information about a command.