scplugins

Documentation

Index

• func ListInternalPlugin(pluginType PluginType, config BasicAndOLMPluginConfig) (scapiv1alpha1.ScorecardOutput, error)
• func NewBasicTestSuite(conf BasicTestConfig) *schelpers.TestSuite
• func NewOLMTestSuite(conf OLMTestConfig) *schelpers.TestSuite
• func RunInternalPlugin(pluginType PluginType, config BasicAndOLMPluginConfig, logFile io.Writer) (scapiv1alpha1.ScorecardOutput, error)
• type BasicAndOLMPluginConfig
• type BasicTestConfig
• type BundleValidationTest
  • func NewBundleValidationTest(conf OLMTestConfig) *BundleValidationTest
  • func (t *BundleValidationTest) Run(ctx context.Context) *schelpers.TestResult
• type CRDsHaveResourcesTest
  • func NewCRDsHaveResourcesTest(conf OLMTestConfig) *CRDsHaveResourcesTest
  • func (t *CRDsHaveResourcesTest) Run(ctx context.Context) *schelpers.TestResult
• type CRDsHaveValidationTest
  • func NewCRDsHaveValidationTest(conf OLMTestConfig) *CRDsHaveValidationTest
  • func (t *CRDsHaveValidationTest) Run(ctx context.Context) *schelpers.TestResult
• type CheckSpecTest
  • func NewCheckSpecTest(conf BasicTestConfig) *CheckSpecTest
  • func (t *CheckSpecTest) Run(ctx context.Context) *schelpers.TestResult
• type CheckStatusTest
  • func NewCheckStatusTest(conf BasicTestConfig) *CheckStatusTest
  • func (t *CheckStatusTest) Run(ctx context.Context) *schelpers.TestResult
• type OLMTestConfig
• type PluginType
• type SpecDescriptorsTest
  • func NewSpecDescriptorsTest(conf OLMTestConfig) *SpecDescriptorsTest
  • func (t *SpecDescriptorsTest) Run(ctx context.Context) *schelpers.TestResult
• type StatusDescriptorsTest
  • func NewStatusDescriptorsTest(conf OLMTestConfig) *StatusDescriptorsTest
  • func (t *StatusDescriptorsTest) Run(ctx context.Context) *schelpers.TestResult
• type WritingIntoCRsHasEffectTest
  • func NewWritingIntoCRsHasEffectTest(conf BasicTestConfig) *WritingIntoCRsHasEffectTest
  • func (t *WritingIntoCRsHasEffectTest) Run(ctx context.Context) *schelpers.TestResult

Functions

func ListInternalPlugin

func ListInternalPlugin(pluginType PluginType, config BasicAndOLMPluginConfig) (scapiv1alpha1.ScorecardOutput, error)

func NewBasicTestSuite

func NewBasicTestSuite(conf BasicTestConfig) *schelpers.TestSuite

NewBasicTestSuite returns a new schelpers.TestSuite object containing basic, functional operator tests

func NewOLMTestSuite

func NewOLMTestSuite(conf OLMTestConfig) *schelpers.TestSuite

NewOLMTestSuite returns a new schelpers.TestSuite object containing CSV best practice checks

func RunInternalPlugin

func RunInternalPlugin(pluginType PluginType, config BasicAndOLMPluginConfig, logFile io.Writer) (scapiv1alpha1.ScorecardOutput, error)

Types

type BasicAndOLMPluginConfig

type BasicAndOLMPluginConfig struct {
	Namespace          string          `mapstructure:"namespace"`
	Kubeconfig         string          `mapstructure:"kubeconfig"`
	InitTimeout        int             `mapstructure:"init-timeout"`
	NamespacedManifest string          `mapstructure:"namespaced-manifest"`
	GlobalManifest     string          `mapstructure:"global-manifest"`
	CRManifest         []string        `mapstructure:"cr-manifest"`
	CSVManifest        string          `mapstructure:"csv-path"`
	ProxyImage         string          `mapstructure:"proxy-image"`
	ProxyPullPolicy    v1.PullPolicy   `mapstructure:"proxy-pull-policy"`
	CRDsDir            string          `mapstructure:"crds-dir"`
	DeployDir          string          `mapstructure:"deploy-dir"`
	Bundle             string          `mapstructure:"bundle"`
	Selector           labels.Selector `mapstructure:"selector"`
	Version            string          `mapstructure:"version"`
	ListOpt            bool            `mapstructure:"list"`
	OLMDeployed        bool            `mapstructure:"olm-deployed"`
}

type BasicTestConfig

type BasicTestConfig struct {
	Client   client.Client
	CR       *unstructured.Unstructured
	ProxyPod *v1.Pod
}

BasicTestConfig contains all variables required by the BasicTest schelpers.TestSuite

type BundleValidationTest

type BundleValidationTest struct {
	schelpers.TestInfo
	OLMTestConfig
}

BundleValidationTest is a scorecard test that validates a bundle

func NewBundleValidationTest

func NewBundleValidationTest(conf OLMTestConfig) *BundleValidationTest

NewBundleValidationTest returns a new BundleValidationTest object

func (*BundleValidationTest) Run

func (t *BundleValidationTest) Run(ctx context.Context) *schelpers.TestResult

Run - implements Test interface

type CRDsHaveResourcesTest

type CRDsHaveResourcesTest struct {
	schelpers.TestInfo
	OLMTestConfig
}

CRDsHaveResourcesTest is a scorecard test that verifies that the CSV lists used resources in its owned CRDs section

func NewCRDsHaveResourcesTest

func NewCRDsHaveResourcesTest(conf OLMTestConfig) *CRDsHaveResourcesTest

NewCRDsHaveResourcesTest returns a new CRDsHaveResourcesTest object

func (*CRDsHaveResourcesTest) Run

func (t *CRDsHaveResourcesTest) Run(ctx context.Context) *schelpers.TestResult

Run - implements Test interface

type CRDsHaveValidationTest

type CRDsHaveValidationTest struct {
	schelpers.TestInfo
	OLMTestConfig
}

CRDsHaveValidationTest is a scorecard test that verifies that all CRDs have a validation section

func NewCRDsHaveValidationTest

func NewCRDsHaveValidationTest(conf OLMTestConfig) *CRDsHaveValidationTest

NewCRDsHaveValidationTest returns a new CRDsHaveValidationTest object

func (*CRDsHaveValidationTest) Run

func (t *CRDsHaveValidationTest) Run(ctx context.Context) *schelpers.TestResult

Run - implements Test interface

type CheckSpecTest

type CheckSpecTest struct {
	schelpers.TestInfo
	BasicTestConfig
}

CheckSpecTest is a scorecard test that verifies that the CR has a spec block

func NewCheckSpecTest

func NewCheckSpecTest(conf BasicTestConfig) *CheckSpecTest

NewCheckSpecTest returns a new CheckSpecTest object

func (*CheckSpecTest) Run

func (t *CheckSpecTest) Run(ctx context.Context) *schelpers.TestResult

Run - implements Test interface

type CheckStatusTest

type CheckStatusTest struct {
	schelpers.TestInfo
	BasicTestConfig
}

CheckStatusTest is a scorecard test that verifies that the CR has a status block

func NewCheckStatusTest

func NewCheckStatusTest(conf BasicTestConfig) *CheckStatusTest

NewCheckStatusTest returns a new CheckStatusTest object

func (*CheckStatusTest) Run

func (t *CheckStatusTest) Run(ctx context.Context) *schelpers.TestResult

Run - implements Test interface

type OLMTestConfig

type OLMTestConfig struct {
	Client   client.Client
	CR       *unstructured.Unstructured
	CSV      *olmapiv1alpha1.ClusterServiceVersion
	CRDsDir  string
	ProxyPod *v1.Pod
	Bundle   string
}

OLMTestConfig contains all variables required by the OLMTest schelpers.TestSuite

type PluginType

type PluginType int

const (
	BasicOperator  PluginType = 0
	OLMIntegration PluginType = 1
)

type SpecDescriptorsTest

type SpecDescriptorsTest struct {
	schelpers.TestInfo
	OLMTestConfig
}

SpecDescriptorsTest is a scorecard test that verifies that all spec fields have descriptors

func NewSpecDescriptorsTest

func NewSpecDescriptorsTest(conf OLMTestConfig) *SpecDescriptorsTest

NewSpecDescriptorsTest returns a new SpecDescriptorsTest object

func (*SpecDescriptorsTest) Run

func (t *SpecDescriptorsTest) Run(ctx context.Context) *schelpers.TestResult

Run - implements Test interface

type StatusDescriptorsTest

type StatusDescriptorsTest struct {
	schelpers.TestInfo
	OLMTestConfig
}

StatusDescriptorsTest is a scorecard test that verifies that all status fields have descriptors

func NewStatusDescriptorsTest

func NewStatusDescriptorsTest(conf OLMTestConfig) *StatusDescriptorsTest

NewStatusDescriptorsTest returns a new StatusDescriptorsTest object

func (*StatusDescriptorsTest) Run

func (t *StatusDescriptorsTest) Run(ctx context.Context) *schelpers.TestResult

Run - implements Test interface

type WritingIntoCRsHasEffectTest

type WritingIntoCRsHasEffectTest struct {
	schelpers.TestInfo
	BasicTestConfig
}

WritingIntoCRsHasEffectTest is a scorecard test that verifies that the operator is making PUT and/or POST requests to the API server

func NewWritingIntoCRsHasEffectTest

func NewWritingIntoCRsHasEffectTest(conf BasicTestConfig) *WritingIntoCRsHasEffectTest

NewWritingIntoCRsHasEffectTest returns a new WritingIntoCRsHasEffectTest object

func (*WritingIntoCRsHasEffectTest) Run

func (t *WritingIntoCRsHasEffectTest) Run(ctx context.Context) *schelpers.TestResult

Run - implements Test interface