runtime

Documentation

Overview

Package runtime handles runtime errors Wraps and reconfigures functionality in apimachinery/pkg/runtime

Index

• Variables
• func EnableAllFeatures()
• func EncodeFeatures() string
• func FeatureEnabled(feature Feature) bool
• func FeaturesBindEnv() error
• func FeaturesBindFlags()
• func HandleError(logger *logrus.Entry, err error)
• func Must(err error)
• func NewLoggerWithSource(source string) *logrus.Entry
• func NewLoggerWithType(obj interface{}) *logrus.Entry
• func ParseFeatures(queryString string) error
• func ParseFeaturesFromEnv() error
• func SetLevel(level logrus.Level)
• type Feature

Variables

var (

	// FeatureTestMutex is a mutex to be shared between tests to ensure that a test that involves changing featureGates
	// cannot accidentally run at the same time as another test that also changing feature flags.
	FeatureTestMutex sync.Mutex
)

Functions

func EnableAllFeatures

func EnableAllFeatures()

EnableAllFeatures turns on all feature flags. This is useful for libraries/processes/tests that want to enable all Alpha/Beta features without having to track all the current feature flags.

func EncodeFeatures

func EncodeFeatures() string

EncodeFeatures returns the feature set as a URL encoded query string

func FeatureEnabled

func FeatureEnabled(feature Feature) bool

FeatureEnabled returns if a Feature is enabled or not

func FeaturesBindEnv

func FeaturesBindEnv() error

FeaturesBindEnv binds the environment variables, based on the flags provided. call after viper.SetEnvKeyReplacer(...) if it is being set.

func FeaturesBindFlags

func FeaturesBindFlags()

FeaturesBindFlags does the Viper arguments configuration. Call before running pflag.Parse()

func HandleError

func HandleError(logger *logrus.Entry, err error)

HandleError wraps runtime.HandleError so that it is possible to use WithField with logrus.

func Must

func Must(err error)

Must panics if there is an error

func NewLoggerWithSource

func NewLoggerWithSource(source string) *logrus.Entry

NewLoggerWithSource returns a logrus.Entry to use when you want to specify an source

func NewLoggerWithType

func NewLoggerWithType(obj interface{}) *logrus.Entry

NewLoggerWithType returns a logrus.Entry to use when you want to use a data type as the source such as when you have a struct with methods

func ParseFeatures

func ParseFeatures(queryString string) error

ParseFeatures parses the url encoded query string of features and stores the value for later retrieval

func ParseFeaturesFromEnv

func ParseFeaturesFromEnv() error

ParseFeaturesFromEnv will parse the feature flags from the Viper args configured by FeaturesBindFlags() and FeaturesBindEnv()

func SetLevel

func SetLevel(level logrus.Level)

SetLevel select level to filter logger output

Types

type Feature

type Feature string

Feature is a type for defining feature gates.

const (
	// FeatureGateFlag is a name of a command line flag, which turns on specific tests for FeatureGates
	FeatureGateFlag = "feature-gates"

	// FeatureExample is an example feature gate flag, used for testing and demonstrative purposes
	FeatureExample Feature = "Example"

	// FeaturePlayerTracking is a feature flag to enable/disable player tracking features.
	FeaturePlayerTracking Feature = "PlayerTracking"

	// FeatureSDKWatchSendOnExecute is a feature flag to enable/disable immediate game server return after SDK.WatchGameServer is called
	FeatureSDKWatchSendOnExecute Feature = "SDKWatchSendOnExecute"

	// FeatureRollingUpdateOnReady is a feature flag to enable/disable rolling update fix of scale down, when ReadyReplicas
	// count is taken into account
	FeatureRollingUpdateOnReady Feature = "RollingUpdateOnReady"

	// NodeExternalDNS is a feature flag to enable/disable node ExternalDNS and InternalDNS use as GameServer address
	NodeExternalDNS Feature = "NodeExternalDNS"
)