Skip to content

kcp workspace

kcp 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

      --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
  -n, --namespace string               If present, the namespace scope for this CLI request
      --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
      --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

Options inherited from parent commands

      --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)
      --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)
      --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)
      --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)
  -v, --v Level                          number for the log level verbosity
      --vmodule moduleSpec               comma-separated list of pattern=N settings for file-filtered logging

SEE ALSO