protocol

Documentation

Overview

Package protocol implements the agent that injects disruptors in protocols. The protocol disruptors run as a proxy. The agent redirects the traffic to the proxy using iptables.

Index

• type Disruptor
  • func NewDisruptor(executor runtime.Executor, proxy Proxy, redirector TrafficRedirector) (Disruptor, error)
• type Proxy
• type TrafficRedirector
  • func NoopTrafficRedirector() TrafficRedirector

Types

type Disruptor

type Disruptor interface {
	Apply(context.Context, time.Duration) error
}

Disruptor defines the interface agent

func NewDisruptor

func NewDisruptor(
	executor runtime.Executor,
	proxy Proxy,
	redirector TrafficRedirector,
) (Disruptor, error)

NewDisruptor creates a new instance of a Disruptor that applies a disruptions to a target The configuration controls how the disruptor operates.

type Proxy

type Proxy interface {
	Start() error
	Stop() error
	Force() error
}

Proxy defines an interface for a proxy

type TrafficRedirector

type TrafficRedirector interface {
	// Start initiates the redirection of traffic and resets existing connections
	Start() error
	// Stop restores the traffic to the original target and resets existing connections
	// to the redirection target
	Stop() error
}

TrafficRedirector defines the interface for a traffic redirector

func NoopTrafficRedirector

func NoopTrafficRedirector() TrafficRedirector

NoopTrafficRedirector returns a dummy traffic redirector that has no effect