i2gw

Documentation

Index

• Constants
• Variables
• func CastToUnstructured(obj runtime.Object) (*unstructured.Unstructured, error)
• func GetProviderSpecificFlagDefinitions() map[ProviderName]map[string]ProviderSpecificFlag
• func GetSupportedProviders() []string
• func RegisterProviderSpecificFlag(provider ProviderName, flag ProviderSpecificFlag)
• type CustomResourceReader
• type FeatureParser
• type GatewayResources
  • func ToGatewayAPIResources(ctx context.Context, namespace string, inputFile string, providers []string, ...) ([]GatewayResources, map[string]string, error)
• type IRToGatewayAPIConverter
• type ImplementationSpecificHTTPPathTypeMatchConverter
• type Provider
• type ProviderConf
• type ProviderConstructor
• type ProviderImplementationSpecificOptions
• type ProviderName
• type ProviderSpecificFlag
• type ResourcesToIRConverter

Constants

const GeneratorAnnotationKey = "gateway.networking.k8s.io/generator"

Variables

var CurrentVersion = "0.4.0"

var ProviderConstructorByName = map[ProviderName]ProviderConstructor{}

ProviderConstructorByName is a map of ProviderConstructor functions by a provider name. Different Provider implementations should add their construction func at startup.

Functions

func CastToUnstructured

func CastToUnstructured(obj runtime.Object) (*unstructured.Unstructured, error)

func GetProviderSpecificFlagDefinitions

func GetProviderSpecificFlagDefinitions() map[ProviderName]map[string]ProviderSpecificFlag

GetProviderSpecificFlagDefinitions returns the provider specific confs registered by the providers.

func GetSupportedProviders

func GetSupportedProviders() []string

GetSupportedProviders returns the names of all providers that are supported now

func RegisterProviderSpecificFlag

func RegisterProviderSpecificFlag(provider ProviderName, flag ProviderSpecificFlag)

RegisterProviderSpecificFlag registers a provider-specific flag. Each provider-specific flag is exposed to the user as an optional command-line flag --<provider>-<flag>. If the flag is not provided, it is up to the provider to decide to use the default value or raise an error. The provider can read the values of provider-specific flags input by the user from the ProviderConf. RegisterProviderSpecificFlag is thread-safe.

Types

type CustomResourceReader

type CustomResourceReader interface {

	// ReadResourcesFromCluster reads custom resources associated with
	// the underlying Provider implementation from the kubernetes cluster.
	ReadResourcesFromCluster(ctx context.Context) error

	// ReadResourcesFromFile reads custom resources associated with
	// the underlying Provider implementation from the file.
	ReadResourcesFromFile(ctx context.Context, filename string) error
}

type FeatureParser

type FeatureParser func([]networkingv1.Ingress, *intermediate.IR) field.ErrorList

FeatureParser is a function that reads the Ingresses, and applies the appropriate modifications to the GatewayResources.

Different FeatureParsers will run in undetermined order. The function must modify / create only the required fields of the gateway resources and nothing else.

type GatewayResources

type GatewayResources struct {
	Gateways       map[types.NamespacedName]gatewayv1.Gateway
	GatewayClasses map[types.NamespacedName]gatewayv1.GatewayClass

	HTTPRoutes map[types.NamespacedName]gatewayv1.HTTPRoute
	TLSRoutes  map[types.NamespacedName]gatewayv1alpha2.TLSRoute
	TCPRoutes  map[types.NamespacedName]gatewayv1alpha2.TCPRoute
	UDPRoutes  map[types.NamespacedName]gatewayv1alpha2.UDPRoute

	ReferenceGrants map[types.NamespacedName]gatewayv1beta1.ReferenceGrant

	GatewayExtensions []unstructured.Unstructured
}

GatewayResources contains all Gateway-API objects and provider Gateway extensions.

func ToGatewayAPIResources

func ToGatewayAPIResources(ctx context.Context, namespace string, inputFile string, providers []string, providerSpecificFlags map[string]map[string]string) ([]GatewayResources, map[string]string, error)

type IRToGatewayAPIConverter

type IRToGatewayAPIConverter interface {
	// ToGatewayResources converts stored IR with the Provider into
	// Gateway API resources and extensions
	ToGatewayResources(intermediate.IR) (GatewayResources, field.ErrorList)
}

The IRToGatewayAPIConverter interface specifies conversion functions from IR into Gateway and Gateway extensions.

type ImplementationSpecificHTTPPathTypeMatchConverter

type ImplementationSpecificHTTPPathTypeMatchConverter func(*gatewayv1.HTTPPathMatch)

ImplementationSpecificHTTPPathTypeMatchConverter is an option to customize the ingress implementationSpecific match type conversion.

type Provider

type Provider interface {
	CustomResourceReader
	ResourcesToIRConverter
	IRToGatewayAPIConverter
}

The Provider interface specifies the required functionality which needs to be implemented by every concrete Ingress/Gateway-API provider, in order for it to be used.

type ProviderConf

type ProviderConf struct {
	Client                client.Client
	Namespace             string
	ProviderSpecificFlags map[string]map[string]string
}

ProviderConf contains all the configuration required for every concrete Provider implementation.

type ProviderConstructor

type ProviderConstructor func(conf *ProviderConf) Provider

ProviderConstructor is a construction function that constructs concrete implementations of the Provider interface.

type ProviderImplementationSpecificOptions

type ProviderImplementationSpecificOptions struct {
	ToImplementationSpecificHTTPPathTypeMatch ImplementationSpecificHTTPPathTypeMatchConverter
}

ProviderImplementationSpecificOptions contains customized implementation-specific fields and functions. These will be used by the common package to customize the provider-specific behavior for all the implementation-specific fields of the ingress API.

type ProviderName

type ProviderName string

ProviderName is a string alias that stores the concrete Provider name.

type ProviderSpecificFlag

type ProviderSpecificFlag struct {
	Name         string
	Description  string
	DefaultValue string
}

type ResourcesToIRConverter

type ResourcesToIRConverter interface {
	// ToIR converts stored API entities associated with the Provider into IR.
	ToIR() (intermediate.IR, field.ErrorList)
}

The ResourcesToIRConverter interface specifies conversion functions from Ingress and extensions into IR.