debug

Documentation

Index

• Constants
• Variables
• func EncodeConfigurations(configurations map[string]types.ContainerDebugConfiguration) string
• func NewDlvTransformer() containerTransformer
• func NewJDWPTransformer() containerTransformer
• func NewNetcoreTransformer() containerTransformer
• func NewNodeTransformer() containerTransformer
• func NewPythonTransformer() containerTransformer
• func RegisterContainerTransformer(t containerTransformer)
• func TransformContainer(adapter types.ContainerAdapter, config ImageConfiguration, ...) (types.ContainerDebugConfiguration, string, error)
• func UnregisterContainerTransformer(t containerTransformer)
• type Config
• type ConfigurationRetriever
• type Debugger
• type DebuggerMux
  • func (d DebuggerMux) Name() string
  • func (d DebuggerMux) Start(ctx context.Context) error
  • func (d DebuggerMux) Stop()
• type ImageConfiguration
  • func RetrieveImageConfiguration(ctx context.Context, artifact *graph.Artifact, ...) (ImageConfiguration, error)
• type NoopDebugger
  • func (n *NoopDebugger) Name() string
  • func (n *NoopDebugger) Start(context.Context) error
  • func (n *NoopDebugger) Stop()
• type PortAllocator

Constants

const (
	// DebuggingSupportVolume is the name of the volume used to hold language runtime debugging support files.
	DebuggingSupportFilesVolume = "debugging-support-files"
)

Variables

var ConfigRetriever = func(ctx context.Context, image string, builds []graph.Artifact, registries map[string]bool) (ImageConfiguration, error) {
	if artifact := findArtifact(image, builds); artifact != nil {
		return RetrieveImageConfiguration(ctx, artifact, registries)
	}
	return ImageConfiguration{}, fmt.Errorf("no build artifact for %q", image)
}

var Protocols = []string{}

Functions

func EncodeConfigurations

func EncodeConfigurations(configurations map[string]types.ContainerDebugConfiguration) string

func NewDlvTransformer

func NewDlvTransformer() containerTransformer

func NewJDWPTransformer

func NewJDWPTransformer() containerTransformer

func NewNetcoreTransformer

func NewNetcoreTransformer() containerTransformer

func NewNodeTransformer

func NewNodeTransformer() containerTransformer

func NewPythonTransformer

func NewPythonTransformer() containerTransformer

func RegisterContainerTransformer

func RegisterContainerTransformer(t containerTransformer)

RegisterContainerTransformer allows calling packages to register their own transformer implementation with the global transform list.

func TransformContainer

func TransformContainer(adapter types.ContainerAdapter, config ImageConfiguration, portAlloc PortAllocator) (types.ContainerDebugConfiguration, string, error)

TransformContainer rewrites the container definition to enable debugging. Returns a debugging configuration description with associated language runtime support container image, or an error if the rewrite was unsuccessful.

func UnregisterContainerTransformer

func UnregisterContainerTransformer(t containerTransformer)

UnregisterContainerTransformer removes the provided transformer from the global transformer set.

Types

type Config

type Config interface {
	Mode() config.RunMode
}

type ConfigurationRetriever

type ConfigurationRetriever func(string) (ImageConfiguration, error)

configurationRetriever retrieves an container image configuration

type Debugger

type Debugger interface {
	// Start starts the debugger.
	Start(context.Context) error

	// Stop stops the debugger.
	Stop()

	// Name returns an identifier string for the debugger.
	Name() string
}

Debugger defines the behavior for any implementation of a component that attaches to and helps debug deployed resources from Skaffold.

type DebuggerMux

type DebuggerMux []Debugger

func (DebuggerMux) Name

func (d DebuggerMux) Name() string

func (DebuggerMux) Start

func (d DebuggerMux) Start(ctx context.Context) error

func (DebuggerMux) Stop

func (d DebuggerMux) Stop()

type ImageConfiguration

type ImageConfiguration struct {
	// Artifact is the corresponding Artifact's image name (`pkg/skaffold/build.Artifact.ImageName`)
	Artifact string

	Author     string
	Labels     map[string]string
	Env        map[string]string
	Entrypoint []string
	Arguments  []string
	WorkingDir string
}

ImageConfiguration captures information from a docker/oci image configuration. It also includes a "artifact", usually containing the corresponding artifact's' image name from `skaffold.yaml`.

func RetrieveImageConfiguration

func RetrieveImageConfiguration(ctx context.Context, artifact *graph.Artifact, insecureRegistries map[string]bool) (ImageConfiguration, error)

RetrieveImageConfiguration retrieves the image container configuration for the given build artifact

type NoopDebugger

type NoopDebugger struct{}

func (*NoopDebugger) Name

func (n *NoopDebugger) Name() string

func (*NoopDebugger) Start

func (n *NoopDebugger) Start(context.Context) error

func (*NoopDebugger) Stop

func (n *NoopDebugger) Stop()

type PortAllocator

type PortAllocator func(int32) int32

PortAllocator is a function that takes a desired port and returns an available port Ports are normally uint16 but Kubernetes types.ContainerPort is an integer