starboard

Documentation

Overview

Package starboard provides primitives for working with Starboard toolkit.

Index

• Constants
• func GetDefaultConftestConfig() map[string]string
• func GetDefaultPolarisConfig() map[string]string
• func GetPluginConfigMapName(pluginName string) string
• func GetVersionFromImageRef(imageRef string) (string, error)
• func LinuxNodeAffinity() *corev1.Affinity
• func NewScheme() *runtime.Scheme
• type BuildInfo
• type ConfigData
  • func GetDefaultConfig() ConfigData
  • func (c ConfigData) GetAquaImageRef() (string, error)
  • func (c ConfigData) GetConfigAuditReportsScanner() (Scanner, error)
  • func (c ConfigData) GetConftestImageRef() (string, error)
  • func (c ConfigData) GetKubeBenchImageRef() (string, error)
  • func (c ConfigData) GetKubeHunterImageRef() (string, error)
  • func (c ConfigData) GetKubeHunterQuick() (bool, error)
  • func (c ConfigData) GetPolarisImageRef() (string, error)
  • func (c ConfigData) GetTrivyImageRef() (string, error)
  • func (c ConfigData) GetTrivyInsecureRegistries() map[string]bool
  • func (c ConfigData) GetTrivyMode() (TrivyMode, error)
  • func (c ConfigData) GetTrivyServerURL() (string, error)
  • func (c ConfigData) GetVulnerabilityReportsScanner() (Scanner, error)
• type ConfigManager
  • func NewConfigManager(client kubernetes.Interface, namespace string) ConfigManager
• type PluginContext
• type PluginContextBuilder
  • func NewPluginContext() *PluginContextBuilder
  • func (b *PluginContextBuilder) Get() PluginContext
  • func (b *PluginContextBuilder) WithClient(client client.Client) *PluginContextBuilder
  • func (b *PluginContextBuilder) WithName(name string) *PluginContextBuilder
  • func (b *PluginContextBuilder) WithNamespace(namespace string) *PluginContextBuilder
  • func (b *PluginContextBuilder) WithServiceAccountName(name string) *PluginContextBuilder
• type Scanner
• type TrivyMode

Constants

const (
	// NamespaceName the name of the namespace in which Starboard stores its
	// configuration and where it runs scan jobs.
	NamespaceName = "starboard"

	// ServiceAccountName the name of the service account used to provide
	// identity for scan jobs run by Starboard.
	ServiceAccountName = "starboard"

	// ConfigMapName the name of the ConfigMap where Starboard stores its
	// configuration.
	ConfigMapName = "starboard"

	// SecretName the name of the secret where Starboard stores is sensitive
	// configuration.
	SecretName = "starboard"
)

const (
	LabelResourceKind      = "starboard.resource.kind"
	LabelResourceName      = "starboard.resource.name"
	LabelResourceNamespace = "starboard.resource.namespace"
	LabelContainerName     = "starboard.container.name"
	LabelPodSpecHash       = "pod-spec-hash"
	LabelPluginConfigHash  = "plugin-config-hash"

	LabelConfigAuditReportScanner   = "configAuditReport.scanner"
	LabelVulnerabilityReportScanner = "vulnerabilityReport.scanner"
	LabelKubeBenchReportScanner     = "kubeBenchReport.scanner"

	LabelK8SAppManagedBy = "app.kubernetes.io/managed-by"
	AppStarboard         = "starboard"
)

const (
	AnnotationContainerImages = "starboard.container-images"
)

Functions

func GetDefaultConftestConfig

func GetDefaultConftestConfig() map[string]string

GetDefaultConftestConfig return the defautl Conftest configuration.

func GetDefaultPolarisConfig

func GetDefaultPolarisConfig() map[string]string

GetDefaultPolarisConfig returns the default Polaris configuration.

func GetPluginConfigMapName

func GetPluginConfigMapName(pluginName string) string

GetPluginConfigMapName returns the name of a ConfigMap used to configure a plugin with the given name.

func GetVersionFromImageRef

func GetVersionFromImageRef(imageRef string) (string, error)

GetVersionFromImageRef returns the image identifier for the specified image reference.

func LinuxNodeAffinity

func LinuxNodeAffinity() *corev1.Affinity

LinuxNodeAffinity constructs a new Affinity resource with linux supported nodes.

func NewScheme

func NewScheme() *runtime.Scheme

Types

type BuildInfo

type BuildInfo struct {
	Version    string
	Commit     string
	Date       string
	Executable string
}

BuildInfo holds build info such as Git revision, Git SHA-1, build datetime, and the name of the executable binary.

type ConfigData

type ConfigData map[string]string

ConfigData holds Starboard configuration settings as a set of key-value pairs.

func GetDefaultConfig

func GetDefaultConfig() ConfigData

GetDefaultConfig returns the default configuration settings.

func (ConfigData) GetAquaImageRef

func (c ConfigData) GetAquaImageRef() (string, error)

func (ConfigData) GetConfigAuditReportsScanner

func (c ConfigData) GetConfigAuditReportsScanner() (Scanner, error)

func (ConfigData) GetConftestImageRef

func (c ConfigData) GetConftestImageRef() (string, error)

func (ConfigData) GetKubeBenchImageRef

func (c ConfigData) GetKubeBenchImageRef() (string, error)

func (ConfigData) GetKubeHunterImageRef

func (c ConfigData) GetKubeHunterImageRef() (string, error)

func (ConfigData) GetKubeHunterQuick

func (c ConfigData) GetKubeHunterQuick() (bool, error)

func (ConfigData) GetPolarisImageRef

func (c ConfigData) GetPolarisImageRef() (string, error)

func (ConfigData) GetTrivyImageRef

func (c ConfigData) GetTrivyImageRef() (string, error)

func (ConfigData) GetTrivyInsecureRegistries

func (c ConfigData) GetTrivyInsecureRegistries() map[string]bool

func (ConfigData) GetTrivyMode

func (c ConfigData) GetTrivyMode() (TrivyMode, error)

func (ConfigData) GetTrivyServerURL

func (c ConfigData) GetTrivyServerURL() (string, error)

func (ConfigData) GetVulnerabilityReportsScanner

func (c ConfigData) GetVulnerabilityReportsScanner() (Scanner, error)

type ConfigManager

type ConfigManager interface {
	EnsureDefault(ctx context.Context) error
	Read(ctx context.Context) (ConfigData, error)
	Delete(ctx context.Context) error
}

ConfigManager defines methods for managing ConfigData.

func NewConfigManager

func NewConfigManager(client kubernetes.Interface, namespace string) ConfigManager

NewConfigManager constructs a new ConfigManager that is using kubernetes.Interface to manage ConfigData backed by the ConfigMap stored in the specified namespace.

type PluginContext

type PluginContext interface {
	// GetName returns the name of the plugin.
	GetName() string
	// GetConfig returns the v1.ConfigMap object that holds configuration settings of the plugin.
	GetConfig() (*corev1.ConfigMap, error)
	// GetNamespace return the name of the K8s Namespace where Starboard creates Jobs
	// and other helper objects.
	GetNamespace() string
	// GetServiceAccountName return the name of the K8s Service Account used to run workloads
	// created by Starboard.
	GetServiceAccountName() string
}

PluginContext is plugin's execution context within the Starboard toolkit. The context is used to grant access to other methods so that this plugin can interact with the toolkit.

type PluginContextBuilder

type PluginContextBuilder struct {
	// contains filtered or unexported fields
}

func NewPluginContext

func NewPluginContext() *PluginContextBuilder

func (*PluginContextBuilder) Get

func (b *PluginContextBuilder) Get() PluginContext

func (*PluginContextBuilder) WithClient

func (b *PluginContextBuilder) WithClient(client client.Client) *PluginContextBuilder

func (*PluginContextBuilder) WithName

func (b *PluginContextBuilder) WithName(name string) *PluginContextBuilder

func (*PluginContextBuilder) WithNamespace

func (b *PluginContextBuilder) WithNamespace(namespace string) *PluginContextBuilder

func (*PluginContextBuilder) WithServiceAccountName

func (b *PluginContextBuilder) WithServiceAccountName(name string) *PluginContextBuilder

type Scanner

type Scanner string

Scanner represents unique, human readable identifier of a security scanner.

const (
	Trivy    Scanner = "Trivy"
	Aqua     Scanner = "Aqua"
	Polaris  Scanner = "Polaris"
	Conftest Scanner = "Conftest"
)

type TrivyMode

type TrivyMode string

TrivyMode describes mode in which Trivy client operates.

const (
	Standalone   TrivyMode = "Standalone"
	ClientServer TrivyMode = "ClientServer"
)