etcd

Documentation

Index

• Constants
• func GetEndpoints(ctx context.Context, resources state.State) ([]string, error)
• func GetLocalMemberID(ctx context.Context, s state.State) (uint64, error)
• func WithLock(ctx context.Context, key string, logger *zap.Logger, f func() error) error
• type CertificateGenerator
  • func (gen *CertificateGenerator) GenerateClientCert(commonName string) (*x509.PEMEncodedCertificateAndKey, error)
  • func (gen *CertificateGenerator) GeneratePeerCert() (*x509.PEMEncodedCertificateAndKey, error)
  • func (gen *CertificateGenerator) GenerateServerCert() (*x509.PEMEncodedCertificateAndKey, error)
• type Client
  • func NewClient(endpoints []string) (client *Client, err error)
  • func NewClientFromControlPlaneIPs(ctx context.Context, resources state.State) (client *Client, err error)
  • func NewLocalClient() (client *Client, err error)
  • func (c *Client) ForfeitLeadership(ctx context.Context, memberID string) (string, error)
  • func (c *Client) GetMemberID(ctx context.Context) (uint64, error)
  • func (c *Client) LeaveCluster(ctx context.Context, st state.State) error
  • func (c *Client) RemoveMemberByHostname(ctx context.Context, hostname string) error
  • func (c *Client) RemoveMemberByMemberID(ctx context.Context, memberID uint64) error
  • func (c *Client) ValidateForUpgrade(ctx context.Context, config config.Provider, preserve bool) error
  • func (c *Client) ValidateQuorum(ctx context.Context) (err error)

Constants

const QuorumCheckTimeout = 15 * time.Second

QuorumCheckTimeout is the amount of time to allow for KV operations before quorum is declared invalid.

Functions

func GetEndpoints

func GetEndpoints(ctx context.Context, resources state.State) ([]string, error)

GetEndpoints returns expected endpoints of etcd cluster members.

It is not guaranteed that etcd is running on each listed endpoint.

func GetLocalMemberID

func GetLocalMemberID(ctx context.Context, s state.State) (uint64, error)

GetLocalMemberID gets the etcd member id of the local node via resources.

func WithLock

func WithLock(ctx context.Context, key string, logger *zap.Logger, f func() error) error

WithLock executes the given function exclusively by acquiring an Etcd lock with the given key.

Types

type CertificateGenerator

type CertificateGenerator struct {
	CA *x509.PEMEncodedCertificateAndKey

	NodeAddresses  *network.NodeAddress
	HostnameStatus *network.HostnameStatus
}

CertificateGenerator contains etcd certificate options.

func (*CertificateGenerator) GenerateClientCert

func (gen *CertificateGenerator) GenerateClientCert(commonName string) (*x509.PEMEncodedCertificateAndKey, error)

GenerateClientCert generates client certificate and key from etcd CA.

func (*CertificateGenerator) GeneratePeerCert

func (gen *CertificateGenerator) GeneratePeerCert() (*x509.PEMEncodedCertificateAndKey, error)

GeneratePeerCert generates etcd peer certificate and key from etcd CA.

func (*CertificateGenerator) GenerateServerCert

func (gen *CertificateGenerator) GenerateServerCert() (*x509.PEMEncodedCertificateAndKey, error)

GenerateServerCert generates server etcd certificate and key from etcd CA.

type Client

type Client struct {
	*clientv3.Client
}

Client is a wrapper around the official etcd client.

func NewClient

func NewClient(endpoints []string) (client *Client, err error)

NewClient initializes and returns an etcd client configured to talk to a list of endpoints.

func NewClientFromControlPlaneIPs

func NewClientFromControlPlaneIPs(ctx context.Context, resources state.State) (client *Client, err error)

NewClientFromControlPlaneIPs initializes and returns an etcd client configured to talk to all members.

func NewLocalClient

func NewLocalClient() (client *Client, err error)

NewLocalClient initializes and returns etcd client configured to talk to localhost endpoint.

func (*Client) ForfeitLeadership

func (c *Client) ForfeitLeadership(ctx context.Context, memberID string) (string, error)

ForfeitLeadership transfers leadership from the current member to another member.

func (*Client) GetMemberID

func (c *Client) GetMemberID(ctx context.Context) (uint64, error)

GetMemberID returns the member ID of the node client is connected to.

func (*Client) LeaveCluster

func (c *Client) LeaveCluster(ctx context.Context, st state.State) error

LeaveCluster removes the current member from the etcd cluster and nukes etcd data directory.

func (*Client) RemoveMemberByHostname

func (c *Client) RemoveMemberByHostname(ctx context.Context, hostname string) error

RemoveMemberByHostname removes the member from the etcd cluster.

Deprecated: use RemoveMemberByMemberID instead.

func (*Client) RemoveMemberByMemberID

func (c *Client) RemoveMemberByMemberID(ctx context.Context, memberID uint64) error

RemoveMemberByMemberID removes the member from the etcd cluster.

func (*Client) ValidateForUpgrade

func (c *Client) ValidateForUpgrade(ctx context.Context, config config.Provider, preserve bool) error

ValidateForUpgrade validates the etcd cluster state to ensure that performing an upgrade is safe.

func (*Client) ValidateQuorum

func (c *Client) ValidateQuorum(ctx context.Context) (err error)

ValidateQuorum performs a KV operation to make certain that quorum is good.