recovery

Documentation

Overview

Package recovery provides tooling to help with control plane disaster recovery. Recover() uses a Backend to extract the control plane from a store, such as etcd, and use those to write assets that can be used by `bootkube start` to reboot the control plane.

The recovery tool assumes that the component names for the control plane elements are the same as what is output by `bootkube render`. The `bootkube start` command also makes this assumption. It also assumes that kubeconfig on the kubelet is located at /etc/kubernetes/kubeconfig, though that can be changed in the bootstrap manifests that are rendered.

Index

• func Recover(ctx context.Context, backend Backend, kubeConfigPath string) (asset.Assets, error)
• type Backend
  • func NewAPIServerBackend(kubeConfigPath string) (Backend, error)
  • func NewEtcdBackend(client *clientv3.Client, pathPrefix string) Backend

Functions

func Recover

func Recover(ctx context.Context, backend Backend, kubeConfigPath string) (asset.Assets, error)

Recover recovers a control plane using the provided backend and kubeConfigPath, returning assets for the existing control plane and a bootstrap control plane that can be used with `bootkube start` to re-bootstrap the control plane.

Types

type Backend

type Backend interface {
	// contains filtered or unexported methods
}

Backend defines an interface for any backend that can populate a controlPlane struct.

func NewAPIServerBackend

func NewAPIServerBackend(kubeConfigPath string) (Backend, error)

NewAPIServerBackend constructs a new backend to talk to the API server using the given kubeConfig.

TODO(diegs): support using a service account instead of a kubeconfig.

func NewEtcdBackend

func NewEtcdBackend(client *clientv3.Client, pathPrefix string) Backend

NewEtcdBackend constructs a new etcdBackend for the given client and pathPrefix.