Documentation
¶
Overview ¶
Code generated by go generate; DO NOT EDIT.
Index ¶
- Constants
- func Get(fileContent *Content, opt RenderConfig) (*utils.KongRawState, error)
- func GetForKonnect(fileContent *Content, opt RenderConfig) (*utils.KongRawState, *utils.KonnectRawState, error)
- func KongStateToFile(kongState *state.KongState, config WriteConfig) error
- func KonnectStateToFile(kongState *state.KongState, config WriteConfig) error
- func WriteContentToFile(content *Content, filename string, format Format) error
- type Content
- type FCACertificate
- type FCertificate
- type FConsumer
- type FDocument
- type FPlugin
- func (in *FPlugin) DeepCopy() *FPlugin
- func (in *FPlugin) DeepCopyInto(out *FPlugin)
- func (p FPlugin) MarshalJSON() ([]byte, error)
- func (p FPlugin) MarshalYAML() (interface{}, error)
- func (p *FPlugin) UnmarshalJSON(b []byte) error
- func (p *FPlugin) UnmarshalYAML(unmarshal func(interface{}) error) error
- type FRBACEndpointPermission
- type FRBACRole
- type FRoute
- type FService
- func (in *FService) DeepCopy() *FService
- func (in *FService) DeepCopyInto(out *FService)
- func (s FService) MarshalJSON() ([]byte, error)
- func (s FService) MarshalYAML() (interface{}, error)
- func (s *FService) UnmarshalJSON(b []byte) error
- func (s *FService) UnmarshalYAML(unmarshal func(interface{}) error) error
- type FServicePackage
- type FServiceVersion
- type FTarget
- type FUpstream
- type Format
- type Implementation
- type Info
- type Kong
- type RenderConfig
- type WriteConfig
Constants ¶
const ( // JSON is JSON file format. JSON = "JSON" // YAML if YAML file format. YAML = "YAML" )
Variables ¶
This section is empty.
Functions ¶
func Get ¶
func Get(fileContent *Content, opt RenderConfig) (*utils.KongRawState, error)
Get process the fileContent and renders a RawState. IDs of entities are matches based on currentState.
func GetForKonnect ¶ added in v1.5.0
func GetForKonnect(fileContent *Content, opt RenderConfig) (*utils.KongRawState, *utils.KonnectRawState, error)
func KongStateToFile ¶
func KongStateToFile(kongState *state.KongState, config WriteConfig) error
KongStateToFile writes a state object to file with filename. It will omit timestamps and IDs while writing.
func KonnectStateToFile ¶ added in v1.5.0
func KonnectStateToFile(kongState *state.KongState, config WriteConfig) error
Types ¶
type Content ¶
type Content struct {
FormatVersion string `json:"_format_version,omitempty" yaml:"_format_version,omitempty"`
Info *Info `json:"_info,omitempty" yaml:"_info,omitempty"`
Workspace string `json:"_workspace,omitempty" yaml:"_workspace,omitempty"`
Services []FService `json:"services,omitempty" yaml:",omitempty"`
Routes []FRoute `json:"routes,omitempty" yaml:",omitempty"`
Consumers []FConsumer `json:"consumers,omitempty" yaml:",omitempty"`
Plugins []FPlugin `json:"plugins,omitempty" yaml:",omitempty"`
Upstreams []FUpstream `json:"upstreams,omitempty" yaml:",omitempty"`
Certificates []FCertificate `json:"certificates,omitempty" yaml:",omitempty"`
CACertificates []FCACertificate `json:"ca_certificates,omitempty" yaml:"ca_certificates,omitempty"`
RBACRoles []FRBACRole `json:"rbac_roles,omitempty" yaml:"rbac_roles,omitempty"`
PluginConfigs map[string]kong.Configuration `json:"_plugin_configs,omitempty" yaml:"_plugin_configs,omitempty"`
ServicePackages []FServicePackage `json:"service_packages,omitempty" yaml:"service_packages,omitempty"`
}
Content represents a serialized Kong state. +k8s:deepcopy-gen=true
func GetContentFromFiles ¶
GetContentFromFiles reads in a file with a slice of filenames and constructs a state. If filename is `-`, then it will read from os.Stdin. If filename represents a directory, it will traverse the tree rooted at filename, read all the files with .yaml, .yml and .json extensions and generate a content after a merge of the content from all the files.
It will return an error if the file representation is invalid or if there is any error during processing.
func (*Content) DeepCopy ¶ added in v1.7.0
DeepCopy is an autogenerated deepcopy function, copying the receiver, creating a new Content.
func (*Content) DeepCopyInto ¶ added in v1.7.0
DeepCopyInto is an autogenerated deepcopy function, copying the receiver, writing into out. in must be non-nil.
func (Content) PopulateDocumentContent ¶ added in v1.7.0
PopulateDocumentContent updates the Documents contained within a Content with the contents of their files on disk. Document files are stored at <root>/ServicePackage.Name/Document.Path and <root>/ServicePackage.Name/ServiceVersion.Version/Document.Path, where <root> is the directory containing the first state file.
func (Content) StripLocalDocumentPath ¶ added in v1.7.0
func (c Content) StripLocalDocumentPath()
StripLocalDocumentPath removes local path information from a target state document, returning the base path with a prepended slash. These path values match typical path values for documents created in the Konnect GUI, whereas path values in decK state files are local relative paths with service package and service version directories.
type FCACertificate ¶
type FCACertificate struct {
kong.CACertificate `yaml:",inline,omitempty"`
}
FCACertificate represents a Kong CACertificate. +k8s:deepcopy-gen=true
func (*FCACertificate) DeepCopy ¶ added in v1.7.0
func (in *FCACertificate) DeepCopy() *FCACertificate
DeepCopy is an autogenerated deepcopy function, copying the receiver, creating a new FCACertificate.
func (*FCACertificate) DeepCopyInto ¶ added in v1.7.0
func (in *FCACertificate) DeepCopyInto(out *FCACertificate)
DeepCopyInto is an autogenerated deepcopy function, copying the receiver, writing into out. in must be non-nil.
type FCertificate ¶
type FCertificate struct {
ID *string `json:"id,omitempty" yaml:"id,omitempty"`
Cert *string `json:"cert,omitempty" yaml:"cert,omitempty"`
Key *string `json:"key,omitempty" yaml:"key,omitempty"`
CreatedAt *int64 `json:"created_at,omitempty" yaml:"created_at,omitempty"`
Tags []*string `json:"tags,omitempty" yaml:"tags,omitempty"`
SNIs []kong.SNI `json:"snis,omitempty" yaml:"snis,omitempty"`
}
FCertificate represents a Kong Certificate. +k8s:deepcopy-gen=true
func (*FCertificate) DeepCopy ¶ added in v1.7.0
func (in *FCertificate) DeepCopy() *FCertificate
DeepCopy is an autogenerated deepcopy function, copying the receiver, creating a new FCertificate.
func (*FCertificate) DeepCopyInto ¶ added in v1.7.0
func (in *FCertificate) DeepCopyInto(out *FCertificate)
DeepCopyInto is an autogenerated deepcopy function, copying the receiver, writing into out. in must be non-nil.
type FConsumer ¶
type FConsumer struct {
kong.Consumer `yaml:",inline,omitempty"`
Plugins []*FPlugin `json:"plugins,omitempty" yaml:",omitempty"`
KeyAuths []*kong.KeyAuth `json:"keyauth_credentials,omitempty" yaml:"keyauth_credentials,omitempty"`
HMACAuths []*kong.HMACAuth `json:"hmacauth_credentials,omitempty" yaml:"hmacauth_credentials,omitempty"`
JWTAuths []*kong.JWTAuth `json:"jwt_secrets,omitempty" yaml:"jwt_secrets,omitempty"`
BasicAuths []*kong.BasicAuth `json:"basicauth_credentials,omitempty" yaml:"basicauth_credentials,omitempty"`
Oauth2Creds []*kong.Oauth2Credential `json:"oauth2_credentials,omitempty" yaml:"oauth2_credentials,omitempty"`
ACLGroups []*kong.ACLGroup `json:"acls,omitempty" yaml:"acls,omitempty"`
MTLSAuths []*kong.MTLSAuth `json:"mtls_auth_credentials,omitempty" yaml:"mtls_auth_credentials,omitempty"`
}
FConsumer represents a consumer in Kong. +k8s:deepcopy-gen=true
func (*FConsumer) DeepCopy ¶ added in v1.7.0
DeepCopy is an autogenerated deepcopy function, copying the receiver, creating a new FConsumer.
func (*FConsumer) DeepCopyInto ¶ added in v1.7.0
DeepCopyInto is an autogenerated deepcopy function, copying the receiver, writing into out. in must be non-nil.
type FDocument ¶ added in v1.7.0
type FDocument struct {
ID *string `json:"id,omitempty" yaml:"id,omitempty"`
Path *string `json:"path,omitempty" yaml:"path,omitempty"`
Published *bool `json:"published,omitempty" yaml:"published,omitempty"`
Content *string `json:"-" yaml:"-"`
}
+k8s:deepcopy-gen=true
func (*FDocument) DeepCopy ¶ added in v1.7.0
DeepCopy is an autogenerated deepcopy function, copying the receiver, creating a new FDocument.
func (*FDocument) DeepCopyInto ¶ added in v1.7.0
DeepCopyInto is an autogenerated deepcopy function, copying the receiver, writing into out. in must be non-nil.
type FPlugin ¶
type FPlugin struct {
kong.Plugin `yaml:",inline,omitempty"`
ConfigSource *string `json:"_config,omitempty" yaml:"_config,omitempty"`
}
FPlugin represents a plugin in Kong. +k8s:deepcopy-gen=true
func (*FPlugin) DeepCopy ¶ added in v1.7.0
DeepCopy is an autogenerated deepcopy function, copying the receiver, creating a new FPlugin.
func (*FPlugin) DeepCopyInto ¶ added in v1.7.0
DeepCopyInto is an autogenerated deepcopy function, copying the receiver, writing into out. in must be non-nil.
func (FPlugin) MarshalJSON ¶
MarshalJSON is a custom marshal method to handle foreign references.
func (FPlugin) MarshalYAML ¶
MarshalYAML is a custom marshal method to handle foreign references.
func (*FPlugin) UnmarshalJSON ¶
UnmarshalJSON is a custom marshal method to handle foreign references.
func (*FPlugin) UnmarshalYAML ¶
UnmarshalYAML is a custom marshal method to handle foreign references.
type FRBACEndpointPermission ¶ added in v1.5.0
type FRBACEndpointPermission struct {
kong.RBACEndpointPermission `yaml:",inline,omitempty"`
}
+k8s:deepcopy-gen=true
func (*FRBACEndpointPermission) DeepCopy ¶ added in v1.7.0
func (in *FRBACEndpointPermission) DeepCopy() *FRBACEndpointPermission
DeepCopy is an autogenerated deepcopy function, copying the receiver, creating a new FRBACEndpointPermission.
func (*FRBACEndpointPermission) DeepCopyInto ¶ added in v1.7.0
func (in *FRBACEndpointPermission) DeepCopyInto(out *FRBACEndpointPermission)
DeepCopyInto is an autogenerated deepcopy function, copying the receiver, writing into out. in must be non-nil.
type FRBACRole ¶ added in v1.5.0
type FRBACRole struct {
kong.RBACRole `yaml:",inline,omitempty"`
EndpointPermissions []*FRBACEndpointPermission `json:"endpoint_permissions,omitempty" yaml:"endpoint_permissions,omitempty"` //nolint
}
FRBACRole represents an RBACRole in Kong +k8s:deepcopy-gen=true
func (*FRBACRole) DeepCopy ¶ added in v1.7.0
DeepCopy is an autogenerated deepcopy function, copying the receiver, creating a new FRBACRole.
func (*FRBACRole) DeepCopyInto ¶ added in v1.7.0
DeepCopyInto is an autogenerated deepcopy function, copying the receiver, writing into out. in must be non-nil.
type FRoute ¶
type FRoute struct {
kong.Route `yaml:",inline,omitempty"`
Plugins []*FPlugin `json:"plugins,omitempty" yaml:",omitempty"`
}
FRoute represents a Kong Route and it's associated plugins. +k8s:deepcopy-gen=true
func (*FRoute) DeepCopy ¶ added in v1.7.0
DeepCopy is an autogenerated deepcopy function, copying the receiver, creating a new FRoute.
func (*FRoute) DeepCopyInto ¶ added in v1.7.0
DeepCopyInto is an autogenerated deepcopy function, copying the receiver, writing into out. in must be non-nil.
type FService ¶
type FService struct {
kong.Service
Routes []*FRoute `json:"routes,omitempty" yaml:",omitempty"`
Plugins []*FPlugin `json:"plugins,omitempty" yaml:",omitempty"`
// sugar property
URL *string `json:"url,omitempty" yaml:",omitempty"`
}
FService represents a Kong Service and it's associated routes and plugins. +k8s:deepcopy-gen=true
func (*FService) DeepCopy ¶ added in v1.7.0
DeepCopy is an autogenerated deepcopy function, copying the receiver, creating a new FService.
func (*FService) DeepCopyInto ¶ added in v1.7.0
DeepCopyInto is an autogenerated deepcopy function, copying the receiver, writing into out. in must be non-nil.
func (FService) MarshalJSON ¶
MarshalJSON is a custom marshal method to handle foreign references.
func (FService) MarshalYAML ¶
MarshalYAML is a custom marshal to handle SNI.
func (*FService) UnmarshalJSON ¶
UnmarshalJSON is a custom marshal method to handle foreign references.
func (*FService) UnmarshalYAML ¶
UnmarshalYAML is a custom marshal method to handle foreign references.
type FServicePackage ¶ added in v1.5.0
type FServicePackage struct {
ID *string `json:"id,omitempty" yaml:"id,omitempty"`
Name *string `json:"name,omitempty" yaml:"name,omitempty"`
Description *string `json:"description,omitempty" yaml:"description,omitempty"`
Versions []FServiceVersion `json:"versions,omitempty" yaml:"versions,omitempty"`
Document *FDocument `json:"document,omitempty" yaml:"document,omitempty"`
}
+k8s:deepcopy-gen=true
func (*FServicePackage) DeepCopy ¶ added in v1.7.0
func (in *FServicePackage) DeepCopy() *FServicePackage
DeepCopy is an autogenerated deepcopy function, copying the receiver, creating a new FServicePackage.
func (*FServicePackage) DeepCopyInto ¶ added in v1.7.0
func (in *FServicePackage) DeepCopyInto(out *FServicePackage)
DeepCopyInto is an autogenerated deepcopy function, copying the receiver, writing into out. in must be non-nil.
type FServiceVersion ¶ added in v1.5.0
type FServiceVersion struct {
ID *string `json:"id,omitempty" yaml:"id,omitempty"`
Version *string `json:"version,omitempty" yaml:"version,omitempty"`
Implementation *Implementation `json:"implementation,omitempty" yaml:"implementation,omitempty"`
Document *FDocument `json:"document,omitempty" yaml:"document,omitempty"`
}
+k8s:deepcopy-gen=true
func (*FServiceVersion) DeepCopy ¶ added in v1.7.0
func (in *FServiceVersion) DeepCopy() *FServiceVersion
DeepCopy is an autogenerated deepcopy function, copying the receiver, creating a new FServiceVersion.
func (*FServiceVersion) DeepCopyInto ¶ added in v1.7.0
func (in *FServiceVersion) DeepCopyInto(out *FServiceVersion)
DeepCopyInto is an autogenerated deepcopy function, copying the receiver, writing into out. in must be non-nil.
type FTarget ¶
FTarget represents a Kong Target. +k8s:deepcopy-gen=true
func (*FTarget) DeepCopy ¶ added in v1.7.0
DeepCopy is an autogenerated deepcopy function, copying the receiver, creating a new FTarget.
func (*FTarget) DeepCopyInto ¶ added in v1.7.0
DeepCopyInto is an autogenerated deepcopy function, copying the receiver, writing into out. in must be non-nil.
type FUpstream ¶
type FUpstream struct {
kong.Upstream `yaml:",inline,omitempty"`
Targets []*FTarget `json:"targets,omitempty" yaml:",omitempty"`
}
FUpstream represents a Kong Upstream and it's associated targets. +k8s:deepcopy-gen=true
func (*FUpstream) DeepCopy ¶ added in v1.7.0
DeepCopy is an autogenerated deepcopy function, copying the receiver, creating a new FUpstream.
func (*FUpstream) DeepCopyInto ¶ added in v1.7.0
DeepCopyInto is an autogenerated deepcopy function, copying the receiver, writing into out. in must be non-nil.
type Implementation ¶ added in v1.5.0
type Implementation struct {
Type string `json:"type,omitempty" yaml:"type,omitempty"`
Kong *Kong `json:"kong,omitempty" yaml:"kong,omitempty"`
}
+k8s:deepcopy-gen=true
func (*Implementation) DeepCopy ¶ added in v1.7.0
func (in *Implementation) DeepCopy() *Implementation
DeepCopy is an autogenerated deepcopy function, copying the receiver, creating a new Implementation.
func (*Implementation) DeepCopyInto ¶ added in v1.7.0
func (in *Implementation) DeepCopyInto(out *Implementation)
DeepCopyInto is an autogenerated deepcopy function, copying the receiver, writing into out. in must be non-nil.
type Info ¶
type Info struct {
SelectorTags []string `json:"select_tags,omitempty" yaml:"select_tags,omitempty"`
}
Info contains meta-data of the file. +k8s:deepcopy-gen=true
func (*Info) DeepCopy ¶ added in v1.7.0
DeepCopy is an autogenerated deepcopy function, copying the receiver, creating a new Info.
func (*Info) DeepCopyInto ¶ added in v1.7.0
DeepCopyInto is an autogenerated deepcopy function, copying the receiver, writing into out. in must be non-nil.
type Kong ¶ added in v1.5.0
type Kong struct {
Service *FService `json:"service,omitempty" yaml:"service,omitempty"`
}
+k8s:deepcopy-gen=true
func (*Kong) DeepCopy ¶ added in v1.7.0
DeepCopy is an autogenerated deepcopy function, copying the receiver, creating a new Kong.
func (*Kong) DeepCopyInto ¶ added in v1.7.0
DeepCopyInto is an autogenerated deepcopy function, copying the receiver, writing into out. in must be non-nil.
type RenderConfig ¶
RenderConfig contains necessary information to render a correct KongConfig from a file.