kong

package
v0.9.0 Latest Latest
Warning

This package is not in the latest version of its module.

 Go to latest Published: Oct 18, 2021 License: Apache-2.0 Imports: 16 Imported by: 2

Documentation

Index

Constants

View Source 
const (
	// AddonName is the unique name of the Kong cluster.Addon
	AddonName clusters.AddonName = "kong"

	// DefaultEnterpriseImageRepo default kong enterprise image
	DefaultEnterpriseImageRepo = "kong/kong-gateway"

	// DefaultEnterpriseImageTag latest kong enterprise image tag
	DefaultEnterpriseImageTag = "2.5.0.0-alpine"

	// DefaultEnterpriseLicenseSecretName is the name that will be used by default for the
	// Kubernetes secret containing the Kong enterprise license that will be
	// deployed when enterprise mode is enabled.
	DefaultEnterpriseLicenseSecretName = "kong-enterprise-license"

	// DefaultEnterpriseAdminPasswordSecretName is the secret name that will be used
	// by default for the Kubernetes secret that will be deployed containing the
	// superuser admin password in enterprise mode.
	DefaultEnterpriseAdminPasswordSecretName = "kong-enterprise-superuser-password"

	// DefaultAdminGUISessionConfSecretName is the secret name that will be used by
	// default for the Kbuernetes secret that will be deployed containing the
	// session configuration for the Kong Admin GUI in enterprise mode.
	DefaultAdminGUISessionConfSecretName = "kong-session-config"
)
View Source 
const (
	// KongHelmRepoURL indicates the URL that will be used for pulling Kong Helm charts.
	KongHelmRepoURL = "https://charts.konghq.com"

	// DefaultDBMode indicates which dbmode for the Kong proxy should be used if no other is specified.
	DefaultDBMode = "none"

	// DefaultNamespace is the default namespace where the Kong proxy is expected to be deployed
	DefaultNamespace = "kong-system"

	// DefaultDeploymentName is the default name of the Kong proxy deployment
	DefaultDeploymentName = "ingress-controller"

	// DefaultReleaseName is the Helm release name of the Kong proxy
	DefaultReleaseName = DefaultDeploymentName + "-kong"

	// DefaultAdminServiceName indicates the name of the Service that's serving the Admin API
	DefaultAdminServiceName = DefaultReleaseName + "-admin"

	// DefaultAdminServicePort is the port on the service at which the Kong Admin API can be reached by default.
	DefaultAdminServicePort = 8001

	// DefaultProxyServiceName indicates the name of the Service that's serving the Proxy
	DefaultProxyServiceName = DefaultReleaseName + "-proxy"

	// DefaultProxyTCPServicePort is the port on the service at which the Kong proxy can be reached by default.
	DefaultProxyTCPServicePort = 80

	// DefaultProxyTLSServicePort is the port on the service at which the Kong proxy can be reached by default.
	DefaultProxyTLSServicePort = 443

	// DefaultUDPServiceName provides the name of the LoadBalancer service the proxy uses for UDP traffic.
	// TODO: this is a hack in place to workaround problems in the Kong helm chart when UDP ports are in use:
	//       See: https://github.com/Kong/charts/issues/329
	DefaultUDPServiceName = DefaultReleaseName + "-udp"

	// DefaultUDPServicePort indicates the default open port to be found on the Kong proxy's UDP service.
	DefaultUDPServicePort = 9999
)

Variables

This section is empty.

Functions

This section is empty.

Types

type Addon 

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

Addon is a Kong Proxy addon which can be deployed on a clusters.Cluster.

func New 

func New() *Addon

New produces a new clusters.Addon for Kong but uses a very opionated set of default configurations (see the defaults() function for more details). If you need to customize your Kong deployment, use the kong.Builder instead.

func (*Addon) Delete 

func (a *Addon) Delete(ctx context.Context, cluster clusters.Cluster) error

func (*Addon) Deploy 

func (a *Addon) Deploy(ctx context.Context, cluster clusters.Cluster) error

func (*Addon) Name 

func (a *Addon) Name() clusters.AddonName

func (*Addon) Namespace added in v0.2.0 

func (a *Addon) Namespace() string

Namespace indicates the operational namespace of Kong addon components, e.g. where the controller and proxy pods live.

func (*Addon) ProxyAdminURL 

func (a *Addon) ProxyAdminURL(ctx context.Context, cluster clusters.Cluster) (*url.URL, error)

ProxyAdminURL provides a routable *url.URL for accessing the Kong Admin API.

func (*Addon) ProxyUDPURL 

func (a *Addon) ProxyUDPURL(ctx context.Context, cluster clusters.Cluster) (*url.URL, error)

ProxyUDPURL provides a routable *url.URL for accessing the default UDP service for the Kong Proxy.

func (*Addon) ProxyURL 

func (a *Addon) ProxyURL(ctx context.Context, cluster clusters.Cluster) (*url.URL, error)

ProxyURL provides a routable *url.URL for accessing the Kong proxy.

func (*Addon) Ready 

func (a *Addon) Ready(ctx context.Context, cluster clusters.Cluster) (waitForObjects []runtime.Object, ready bool, err error)

type Builder 

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

Builder is a configuration tool for Kong cluster.Addons

func NewBuilder 

func NewBuilder() *Builder

NewBuilder provides a new Builder object for configuring and generating Kong Addon objects which can be deployed to cluster.Clusters

func (*Builder) Build 

func (b *Builder) Build() *Addon

Build generates a new kong cluster.Addon which can be loaded and deployed into a test Environment's cluster.Cluster.

func (*Builder) WithControllerDisabled added in v0.2.0 

func (b *Builder) WithControllerDisabled() *Builder

WithControllerDisabled configures the Addon in proxy only mode (bring your own control plane).

func (*Builder) WithDBLess 

func (b *Builder) WithDBLess() *Builder

WithDBLess configures the resulting Addon to deploy a DBLESS proxy backend.

func (*Builder) WithLogger added in v0.7.0 

func (b *Builder) WithLogger(logger *logrus.Logger) *Builder

WithLogger adds a logger that will provide extra information about the build step of the addon at various configured log levels.

func (*Builder) WithPostgreSQL 

func (b *Builder) WithPostgreSQL() *Builder

WithPostgreSQL configures the resulting Addon to deploy a PostgreSQL proxy backend.

func (*Builder) WithProxyAdminServiceTypeLoadBalancer added in v0.7.0 

func (b *Builder) WithProxyAdminServiceTypeLoadBalancer() *Builder

WithProxyAdminServiceTypeLoadBalancer sets the Kong proxy's admin API's Kubernetes Service type to a "LoadBalancer" type for access outside of the cluster.

WARNING: Keep in mind that depending on your cluster provider and configuration using this option may expose your admin api endpoint to the internet.

func (*Builder) WithProxyEnterpriseEnabled added in v0.7.0 

func (b *Builder) WithProxyEnterpriseEnabled(licenseJSON string) *Builder

WithProxyEnterpriseEnabled configures the resulting Addon to deploy the enterprise version of the Kong proxy. See: https://docs.konghq.com/enterprise/

func (*Builder) WithProxyEnterpriseSuperAdminPassword added in v0.7.0 

func (b *Builder) WithProxyEnterpriseSuperAdminPassword(password string) *Builder

WithProxyEnterpriseSuperAdminPassword specify kong admin password

func (*Builder) WithProxyImage added in v0.7.0 

func (b *Builder) WithProxyImage(repo, tag string) *Builder

WithProxyImage configures the container image name and tag for the Kong proxy.

type DBMode 

type DBMode string

DBMode indicate which storage backend the Kong Proxy should be deployed with (e.g. DBLESS, Postgres, e.t.c.) 

const (
	// DBLESS indicates that the Kong Proxy should be deployed with the DBLESS storage backend.
	DBLESS DBMode = "dbless"

	// PostgreSQL indicates that the Kong Proxy should be deployed with a PostgreSQL storage backend.
	PostgreSQL DBMode = "postgres"
)

Source Files

View all Source files

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL
go.dev uses cookies from Google to deliver and enhance the quality of its services and to analyze traffic. Learn more.