Design docs, concept definitions, and references for APIs and CLIs.

Documentation for Kubernetes v1.9 is no longer actively maintained. The version you are currently viewing is a static snapshot. For up-to-date documentation, see the latest version.

Edit This Page

kubefed unjoin


Unjoin a cluster from a federation.

Current context is assumed to be a federation endpoint.
Please use the --context flag otherwise.
kubefed unjoin CLUSTER_NAME --host-cluster-context=HOST_CONTEXT


  # Unjoin the specified cluster from a federation.
  # Federation control plane's host cluster context name
  # must be specified via the --host-cluster-context flag
  # to properly cleanup the credentials.
  kubectl unjoin foo --host-cluster-context=bar --cluster-context=baz


      --cluster-context string               Name of the cluster's context in the local kubeconfig. Defaults to cluster name if unspecified.
      --federation-system-namespace string   Namespace in the host cluster where the federation system components are installed (default "federation-system")
      --host-cluster-context string          Host cluster context
      --kubeconfig string                    Path to the kubeconfig file to use for CLI requests.

Options inherited from parent commands

      --alsologtostderr                         log to standard error as well as files
      --as string                               Username to impersonate for the operation
      --as-group stringArray                    Group to impersonate for the operation, this flag can be repeated to specify multiple groups.
      --cache-dir string                        Default HTTP cache directory (default "/home/stevepe/.kube/http-cache")
      --certificate-authority string            Path to a cert file for the certificate authority
      --client-certificate string               Path to a client certificate file for TLS
      --client-key string                       Path to a client key file for TLS
      --cloud-provider-gce-lb-src-cidrs cidrs   CIDRs opened in GCE firewall for LB traffic proxy & health checks (default,,,
      --cluster string                          The name of the kubeconfig cluster to use
      --context string                          The name of the kubeconfig context to use
      --insecure-skip-tls-verify                If true, the server's certificate will not be checked for validity. This will make your HTTPS connections insecure
      --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
      --log-flush-frequency duration            Maximum number of seconds between log flushes (default 5s)
      --logtostderr                             log to standard error instead of files (default true)
      --match-server-version                    Require server version to match client version
  -n, --namespace string                        If present, the namespace scope for this CLI request
      --password string                         Password for basic authentication to the API server
      --request-timeout string                  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. (default "0")
  -s, --server string                           The address and port of the Kubernetes API server
      --stderrthreshold severity                logs at or above this threshold go to stderr (default 2)
      --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                                 log level for V logs
      --vmodule moduleSpec                      comma-separated list of pattern=N settings for file-filtered logging


Auto generated by spf13/cobra on 12-Dec-2017


Create an Issue Edit this Page