downwardapi

Documentation

Overview

Package downwardapi declares the types used to expose job configuration to the jobs themselves

Index

• Constants
• func EnvForSpec(spec JobSpec) (map[string]string, error)
• func EnvForType(jobType prowapi.ProwJobType) []string
• func GetRevisionFromRefs(refs *prowapi.Refs, extra []prowapi.Refs) string
• func GetRevisionFromSpec(jobSpec *JobSpec) string
• func PjToStarted(pj *prowv1.ProwJob, cloneRecords []clone.Record) metadata.Started
• func SpecToStarted(spec *JobSpec, cloneRecords []clone.Record) metadata.Started
• type JobSpec
  • func NewJobSpec(spec prowapi.ProwJobSpec, buildID, prowJobID string) JobSpec
  • func ResolveSpecFromEnv() (*JobSpec, error)

Constants

const (

	// JobSpecEnv is the name that contains JobSpec marshaled into a string.
	JobSpecEnv = "JOB_SPEC"
)

Functions

func EnvForSpec

func EnvForSpec(spec JobSpec) (map[string]string, error)

EnvForSpec returns a mapping of environment variables to their values that should be available for a job spec

func EnvForType

func EnvForType(jobType prowapi.ProwJobType) []string

EnvForType returns the slice of environment variables to export for jobType

func GetRevisionFromRefs

func GetRevisionFromRefs(refs *prowapi.Refs, extra []prowapi.Refs) string

func GetRevisionFromSpec

func GetRevisionFromSpec(jobSpec *JobSpec) string

GetRevisionFromSpec returns a main ref or sha from a spec object

func PjToStarted

func PjToStarted(pj *prowv1.ProwJob, cloneRecords []clone.Record) metadata.Started

func SpecToStarted

func SpecToStarted(spec *JobSpec, cloneRecords []clone.Record) metadata.Started

Types

type JobSpec

type JobSpec struct {
	Type      prowapi.ProwJobType `json:"type,omitempty"`
	Job       string              `json:"job,omitempty"`
	BuildID   string              `json:"buildid,omitempty"`
	ProwJobID string              `json:"prowjobid,omitempty"`

	// refs & extra_refs from the full spec
	Refs      *prowapi.Refs  `json:"refs,omitempty"`
	ExtraRefs []prowapi.Refs `json:"extra_refs,omitempty"`

	DecorationConfig *prowapi.DecorationConfig `json:"decoration_config,omitempty"`
	// contains filtered or unexported fields
}

JobSpec is the full downward API that we expose to jobs that realize a ProwJob. We will provide this data to jobs with environment variables in two ways:

• the full spec, in serialized JSON in one variable
• individual fields of the spec in their own variables

func NewJobSpec

func NewJobSpec(spec prowapi.ProwJobSpec, buildID, prowJobID string) JobSpec

NewJobSpec converts a prowapi.ProwJobSpec invocation into a JobSpec

func ResolveSpecFromEnv

func ResolveSpecFromEnv() (*JobSpec, error)

ResolveSpecFromEnv will determine the Refs being tested in by parsing Prow environment variable contents