entrypoint

package

v0.0.5 Latest Latest Go to latest Published: Sep 7, 2018 License: Apache-2.0 Imports: 15 Imported by: 0

Details

Valid go.mod file

The Go module system was introduced in Go 1.11 and is the official dependency management solution for Go.
Redistributable license

Redistributable licenses place minimal restrictions on how software can be used, modified, and redistributed.
Tagged version

Modules with tagged versions give importers more predictable builds.
Stable version

When a project reaches major version v1 it is considered stable.
Learn more about best practices

Repository

github.com/abayer/test-infra

Links

Open Source Insights

Documentation ¶

Overview ¶

Package entrypoint is a library that knows how to wrap a process and write it's output and exit code to disk

Index ¶

Constants
func Encode(options Options) (string, error)
type Options
- func NewOptions() *Options

Constants ¶

View Source

const (
	// InternalErrorCode is what we write to the marker file to
	// indicate that we failed to start the wrapped command
	InternalErrorCode = 127
	// AbortedErrorCode is what we write to the marker file to
	// indicate that we were terminated via a signal.
	AbortedErrorCode = 130

	// DefaultTimeout is the default timeout for the test
	// process before SIGINT is sent
	DefaultTimeout = 120 * time.Minute

	// DefaultGracePeriod is the default timeout for the test
	// process after SIGINT is sent before SIGKILL is sent
	DefaultGracePeriod = 15 * time.Second
)

View Source

const (
	// JSONConfigEnvVar is the environment variable that
	// utilities expect to find a full JSON configuration
	// in when run.
	JSONConfigEnvVar = "ENTRYPOINT_OPTIONS"
)

Variables ¶

This section is empty.

Functions ¶

func Encode ¶

func Encode(options Options) (string, error)

Encode will encode the set of options in the format that is expected for the configuration environment variable

Types ¶

type Options ¶

type Options struct {
	// Args is the process and args to run
	Args []string `json:"args"`
	// Timeout determines how long to wait before the
	// entrypoint sends SIGINT to the process
	Timeout time.Duration `json:"timeout"`
	// GracePeriod determines how long to wait after
	// sending SIGINT before the entrypoint sends
	// SIGKILL.
	GracePeriod time.Duration `json:"grace_period"`
	// ArtifactDir is a directory where test processes can dump artifacts
	// for upload to persistent storage (courtesy of sidecar).
	// If specified, it is created by entrypoint before starting the test process.
	// May be ignored if not using sidecar.
	ArtifactDir string `json:"artifact_dir,omitempty"`

	*wrapper.Options
}

Options exposes the configuration necessary for defining the process being watched and where in GCS an upload will land.

func NewOptions ¶

func NewOptions() *Options

NewOptions returns an empty Options with no nil fields

func (*Options) BindOptions ¶

func (o *Options) BindOptions(flags *flag.FlagSet)

BindOptions binds flags to options

func (*Options) Complete ¶

func (o *Options) Complete(args []string)

Complete internalizes command line arguments

func (*Options) ConfigVar ¶

func (o *Options) ConfigVar() string

ConfigVar exposes the environment variable used to store serialized configuration

func (Options) ExecuteProcess ¶

func (o Options) ExecuteProcess() (int, error)

ExecuteProcess creates the artifact directory then executes the process as configured, writing the output to the process log.

func (*Options) LoadConfig ¶

func (o *Options) LoadConfig(config string) error

LoadConfig loads options from serialized config

func (Options) Run ¶

func (o Options) Run() int

Run executes the test process then writes the exit code to the marker file. This function returns the status code that should be passed to os.Exit().

func (*Options) Validate ¶

func (o *Options) Validate() error

Validate ensures that the set of options are self-consistent and valid

Source Files ¶

View all Source files

?	: This menu
/	: Search site
f or F	: Jump to
y or Y	: Canonical URL