debug

Documentation

Index

• Constants
• func NewCmdDebug(restClientGetter genericclioptions.RESTClientGetter, ...) *cobra.Command
• type DebugAttachFunc
• type DebugOptions
  • func NewDebugOptions(streams genericiooptions.IOStreams) *DebugOptions
  • func (o *DebugOptions) AddFlags(cmd *cobra.Command)
  • func (o *DebugOptions) Complete(restClientGetter genericclioptions.RESTClientGetter, cmd *cobra.Command, ...) error
  • func (o *DebugOptions) Run(restClientGetter genericclioptions.RESTClientGetter, cmd *cobra.Command) error
  • func (o *DebugOptions) Validate() error
• type ProfileApplier
  • func NewProfileApplier(profile string) (ProfileApplier, error)

Constants

const (

	// ProfileLegacy represents the legacy debugging profile which is backwards-compatible with 1.23 behavior.
	ProfileLegacy = "legacy"
	// ProfileGeneral contains a reasonable set of defaults tailored for each debugging journey.
	ProfileGeneral = "general"
	// ProfileBaseline is identical to "general" but eliminates privileges that are disallowed under
	// the baseline security profile, such as host namespaces, host volume, mounts and SYS_PTRACE.
	ProfileBaseline = "baseline"
	// ProfileRestricted is identical to "baseline" but adds configuration that's required
	// under the restricted security profile, such as requiring a non-root user and dropping all capabilities.
	ProfileRestricted = "restricted"
	// ProfileNetadmin offers elevated privileges for network debugging.
	ProfileNetadmin = "netadmin"
	// ProfileSysadmin offers elevated privileges for debugging.
	ProfileSysadmin = "sysadmin"
)

Functions

func NewCmdDebug

func NewCmdDebug(restClientGetter genericclioptions.RESTClientGetter, streams genericiooptions.IOStreams) *cobra.Command

NewCmdDebug returns a cobra command that runs kubectl debug.

Types

type DebugAttachFunc

type DebugAttachFunc func(ctx context.Context, restClientGetter genericclioptions.RESTClientGetter, cmdPath string, ns, podName, containerName string) error

type DebugOptions

type DebugOptions struct {
	Args              []string
	ArgsOnly          bool
	Attach            bool
	AttachFunc        DebugAttachFunc
	Container         string
	CopyTo            string
	Replace           bool
	Env               []corev1.EnvVar
	Image             string
	Interactive       bool
	Namespace         string
	TargetNames       []string
	PullPolicy        corev1.PullPolicy
	Quiet             bool
	SameNode          bool
	SetImages         map[string]string
	ShareProcesses    bool
	TargetContainer   string
	TTY               bool
	Profile           string
	CustomProfileFile string
	CustomProfile     *corev1.Container
	Applier           ProfileApplier

	Builder *resource.Builder
	genericiooptions.IOStreams
	WarningPrinter *printers.WarningPrinter

	resource.FilenameOptions
	// contains filtered or unexported fields
}

DebugOptions holds the options for an invocation of kubectl debug.

func NewDebugOptions

func NewDebugOptions(streams genericiooptions.IOStreams) *DebugOptions

NewDebugOptions returns a DebugOptions initialized with default values.

func (*DebugOptions) AddFlags

func (o *DebugOptions) AddFlags(cmd *cobra.Command)

func (*DebugOptions) Complete

func (o *DebugOptions) Complete(restClientGetter genericclioptions.RESTClientGetter, cmd *cobra.Command, args []string) error

Complete finishes run-time initialization of debug.DebugOptions.

func (*DebugOptions) Run

func (o *DebugOptions) Run(restClientGetter genericclioptions.RESTClientGetter, cmd *cobra.Command) error

Run executes a kubectl debug.

func (*DebugOptions) Validate

func (o *DebugOptions) Validate() error

Validate checks that the provided debug options are specified.

type ProfileApplier

type ProfileApplier interface {
	// Apply applies the profile to the given container in the pod.
	Apply(pod *corev1.Pod, containerName string, target runtime.Object) error
}

func NewProfileApplier

func NewProfileApplier(profile string) (ProfileApplier, error)

NewProfileApplier returns a new Options for the given profile name.