certificates

Documentation

Index

• Constants
• type Suite
  • func (s *Suite) Define()

Constants

const (
	IstioDomainSuffixType   = "istio"
	IngressDomainSuffixType = "ingress"

	IstioIPAddressType   = "istio"
	IngressIPAddressType = "ingress"
)

Types

type Suite

type Suite struct {
	// Name is the name of the issuer being tested, e.g. SelfSigned, CA, ACME
	// This field must be provided.
	Name string

	// CreateIssuerFunc is a function that provisions a new issuer resource and
	// returns an ObjectReference to that Issuer that will be used as the
	// IssuerRef on Certificate resources that this suite creates.
	// This field must be provided.
	CreateIssuerFunc func(*framework.Framework) cmmeta.ObjectReference

	// DeleteIssuerFunc is a function that is run after the test has completed
	// in order to clean up resources created for a test (e.g. the resources
	// created in CreateIssuerFunc).
	// This function will be run regardless whether the test passes or fails.
	// If not specified, this function will be skipped.
	DeleteIssuerFunc func(*framework.Framework, cmmeta.ObjectReference)

	// DomainSuffix is a suffix used on all domain requests.
	// This is useful when the issuer being tested requires special
	// configuration for a set of domains in order for certificates to be
	// issued, such as the ACME issuer.
	// If not set, this will be defaulted to the configured 'domain' for the
	// nginx-ingress addon.
	DomainSuffix string

	// DomainSuffixType is a string used to detect what DomainSuffix to use
	// in case DomainSuffix is left empty.
	DomainSuffixType string

	// IPAddress is an IP used on all IPAddress requests.
	// This is useful when the issuer being tested requires special
	// configuration for a set of IPAddresses in order for certificates to be
	// issued, such as the ACME issuer.
	// If not set, this will be defaulted to "127.0.0.1".
	IPAddress string

	// IPAddressType is a string used to detect what IPAddress to use
	// in case IPAddress is left empty.
	IPAddressType string

	// UnsupportedFeatures is a list of features that are not supported by this
	// invocation of the test suite.
	// This is useful if a particular issuers explicitly does not support
	// certain features due to restrictions in their implementation.
	UnsupportedFeatures featureset.FeatureSet
	// contains filtered or unexported fields
}

Suite defines a reusable conformance test suite that can be used against any Issuer implementation.

func (*Suite) Define

func (s *Suite) Define()

Defines simple conformance tests that can be run against any issuer type. If Complete has not been called on this Suite before Define, it will be automatically called.