Documentation
¶
Overview ¶
Package util implements various utility functions used in both testing and implementation of Kubernetes. Package util may not depend on any other package in the Kubernetes package tree.
Index ¶
- Variables
- func AllPtrFieldsNil(obj interface{}) bool
- func ApplyRLimitForSelf(maxOpenFiles uint64)
- func CertPoolFromFile(filename string) (*x509.CertPool, error)
- func CertsFromPEM(pemCerts []byte) ([]*x509.Certificate, error)
- func CompileRegexps(regexpStrings []string) ([]*regexp.Regexp, error)
- func DeadlockWatchdog(lock sync.Locker, name string, maxLockPeriod time.Duration)
- func DeadlockWatchdogReadLock(lock *sync.RWMutex, name string, maxLockPeriod time.Duration)
- func EncodePrivateKey(private *rsa.PrivateKey) []byte
- func EncodePublicKey(public *rsa.PublicKey) ([]byte, error)
- func EncodeSSHKey(public *rsa.PublicKey) ([]byte, error)
- func ExecuteTemplate(w io.Writer, templateText string, data interface{}) error
- func ExecuteTemplateToString(templateText string, data interface{}) (string, error)
- func FileExists(filename string) (bool, error)
- func FlushLogs()
- func Forever(f func(), period time.Duration)
- func GenerateKey(bits int) (*rsa.PrivateKey, *rsa.PublicKey, error)
- func GenerateSelfSignedCert(host, certPath, keyPath string, alternateIPs []net.IP, alternateDNS []string) error
- func GetIntOrPercentValue(intOrStr *intstr.IntOrString) (int, bool, error)
- func GetValueFromPercent(percent int, value int) int
- func InitFlags()
- func InitLogs()
- func IntPtr(i int) *int
- func IntPtrDerefOr(ptr *int, def int) int
- func MakePrivateKeySignerFromBytes(buffer []byte) (ssh.Signer, error)
- func MakePrivateKeySignerFromFile(key string) (ssh.Signer, error)
- func NewCRLFWriter(w io.Writer) io.Writer
- func NewLogger(prefix string) *log.Logger
- func NewUUID() types.UID
- func ObjectDiff(a, b interface{}) string
- func ObjectGoPrintDiff(a, b interface{}) string
- func ObjectGoPrintSideBySide(a, b interface{}) string
- func ParsePublicKeyFromFile(keyFile string) (*rsa.PublicKey, error)
- func ReadDirNoExit(dirname string) ([]os.FileInfo, []error, error)
- func RunInResourceContainer(containerName string) error
- func RunSSHCommand(cmd, user, host string, signer ssh.Signer) (string, string, int, error)
- func StringDiff(a, b string) string
- func Umask(mask int) (old int, err error)
- func Until(f func(), period time.Duration, stopCh <-chan struct{})
- func UsingSystemdInitSystem() bool
- func WarnWordSepNormalizeFunc(f *pflag.FlagSet, name string) pflag.NormalizedName
- func WordSepNormalizeFunc(f *pflag.FlagSet, name string) pflag.NormalizedName
- type Backoff
- func (p *Backoff) GC()
- func (p *Backoff) Get(id string) time.Duration
- func (p *Backoff) IsInBackOffSince(id string, eventTime time.Time) bool
- func (p *Backoff) IsInBackOffSinceUpdate(id string, eventTime time.Time) bool
- func (p *Backoff) Next(id string, eventTime time.Time)
- func (p *Backoff) Reset(id string)
- type BoolFlag
- type Cache
- type Clock
- type ConfigurationMap
- type FakeClock
- type GlogWriter
- type IntervalClock
- type LineDelimiter
- type RateLimiter
- type RealClock
- type Runner
- type SSHTunnel
- type SSHTunnelEntry
- type SSHTunnelList
- type StringFlag
- type Trace
Constants ¶
This section is empty.
Variables ¶
var ForeverTestTimeout = time.Second * 30
For any test of the style:
... <- time.After(timeout): t.Errorf("Timed out")
The value for timeout should effectively be "forever." Obviously we don't want our tests to truly lock up forever, but 30s is long enough that it is effectively forever for the things that can slow down a run on a heavily contended machine (GC, seeks, etc), but not so long as to make a developer ctrl-c a test run if they do happen to break that test.
var NeverStop <-chan struct{} = make(chan struct{})
NeverStop may be passed to Until to make it never stop.
Functions ¶
func AllPtrFieldsNil ¶ added in v0.8.2
func AllPtrFieldsNil(obj interface{}) bool
Tests whether all pointer fields in a struct are nil. This is useful when, for example, an API struct is handled by plugins which need to distinguish "no plugin accepted this spec" from "this spec is empty".
This function is only valid for structs and pointers to structs. Any other type will cause a panic. Passing a typed nil pointer will return true.
func ApplyRLimitForSelf ¶ added in v1.1.0
func ApplyRLimitForSelf(maxOpenFiles uint64)
func CertPoolFromFile ¶ added in v0.15.0
CertPoolFromFile returns an x509.CertPool containing the certificates in the given PEM-encoded file. Returns an error if the file could not be read, a certificate could not be parsed, or if the file does not contain any certificates
func CertsFromPEM ¶ added in v0.20.0
func CertsFromPEM(pemCerts []byte) ([]*x509.Certificate, error)
CertsFromPEM returns the x509.Certificates contained in the given PEM-encoded byte array Returns an error if a certificate could not be parsed, or if the data does not contain any certificates
func CompileRegexps ¶
Takes a list of strings and compiles them into a list of regular expressions
func DeadlockWatchdog ¶ added in v1.1.1
func DeadlockWatchdogReadLock ¶ added in v1.1.1
DeadlockWatchdogReadLock creates a watchdog on read/write mutex. If the mutex can not be acquired for read access within 'maxLockPeriod', the program exits via glog.Exitf() or os.Exit() if that fails 'name' is a semantic name that is useful for the user and is printed on exit.
func EncodePrivateKey ¶ added in v0.19.0
func EncodePrivateKey(private *rsa.PrivateKey) []byte
func ExecuteTemplate ¶ added in v0.10.0
ExecuteTemplate executes templateText with data and output written to w.
func ExecuteTemplateToString ¶ added in v0.10.0
func FileExists ¶ added in v0.19.0
func GenerateKey ¶ added in v0.19.0
func GenerateSelfSignedCert ¶ added in v0.8.2
func GenerateSelfSignedCert(host, certPath, keyPath string, alternateIPs []net.IP, alternateDNS []string) error
GenerateSelfSignedCert creates a self-signed certificate and key for the given host. Host may be an IP or a DNS name You may also specify additional subject alt names (either ip or dns names) for the certificate The certificate will be created with file mode 0644. The key will be created with file mode 0600. If the certificate or key files already exist, they will be overwritten. Any parent directories of the certPath or keyPath will be created as needed with file mode 0755.
func GetIntOrPercentValue ¶ added in v1.1.0
func GetIntOrPercentValue(intOrStr *intstr.IntOrString) (int, bool, error)
func GetValueFromPercent ¶ added in v1.1.0
func InitFlags ¶ added in v0.9.0
func InitFlags()
InitFlags normalizes and parses the command line flags
func IntPtrDerefOr ¶ added in v1.2.0
IntPtrDerefOr derefrence the int ptr and returns it i not nil, else returns def.
func MakePrivateKeySignerFromBytes ¶ added in v0.19.0
func MakePrivateKeySignerFromFile ¶ added in v0.19.0
func NewCRLFWriter ¶ added in v1.2.0
NewCRLFWriter implements a CR/LF line ending writer used for normalizing text for Windows platforms.
func ObjectDiff ¶
func ObjectDiff(a, b interface{}) string
ObjectDiff writes the two objects out as JSON and prints out the identical part of the objects followed by the remaining part of 'a' and finally the remaining part of 'b'. For debugging tests.
func ObjectGoPrintDiff ¶
func ObjectGoPrintDiff(a, b interface{}) string
ObjectGoPrintDiff is like ObjectDiff, but uses go-spew to print the objects, which shows absolutely everything by recursing into every single pointer (go's %#v formatters OTOH stop at a certain point). This is needed when you can't figure out why reflect.DeepEqual is returning false and nothing is showing you differences. This will.
func ObjectGoPrintSideBySide ¶ added in v0.7.0
func ObjectGoPrintSideBySide(a, b interface{}) string
ObjectGoPrintSideBySide prints a and b as textual dumps side by side, enabling easy visual scanning for mismatches.
func ParsePublicKeyFromFile ¶ added in v0.20.0
func ReadDirNoExit ¶ added in v1.1.0
borrowed from ioutil.ReadDir ReadDir reads the directory named by dirname and returns a list of directory entries, minus those with lstat errors
func RunInResourceContainer ¶ added in v0.16.0
Creates resource-only containerName if it does not already exist and moves the current process to it.
containerName must be an absolute container name.
func RunSSHCommand ¶ added in v0.19.0
RunSSHCommand returns the stdout, stderr, and exit code from running cmd on host as specific user, along with any SSH-level error. If user=="", it will default (like SSH) to os.Getenv("USER")
func StringDiff ¶
StringDiff diffs a and b and returns a human readable diff.
func Until ¶ added in v0.7.0
Until loops until stop channel is closed, running f every period. Catches any panics, and keeps going. f may not be invoked if stop channel is already closed. Pass NeverStop to Until if you don't want it stop.
func UsingSystemdInitSystem ¶ added in v0.20.0
func UsingSystemdInitSystem() bool
Detects if using systemd as the init system Please note that simply reading /proc/1/cmdline can be misleading because some installation of various init programs can automatically make /sbin/init a symlink or even a renamed version of their main program. TODO(dchen1107): realiably detects the init system using on the system: systemd, upstart, initd, etc.
func WarnWordSepNormalizeFunc ¶ added in v0.18.0
func WarnWordSepNormalizeFunc(f *pflag.FlagSet, name string) pflag.NormalizedName
WarnWordSepNormalizeFunc changes and warns for flags that contain "_" separators
func WordSepNormalizeFunc ¶ added in v0.17.0
func WordSepNormalizeFunc(f *pflag.FlagSet, name string) pflag.NormalizedName
WordSepNormalizeFunc changes all flags that contain "_" separators
Types ¶
type Backoff ¶ added in v1.1.0
func NewBackOff ¶ added in v1.1.0
func (*Backoff) GC ¶ added in v1.1.0
func (p *Backoff) GC()
Garbage collect records that have aged past maxDuration. Backoff users are expected to invoke this periodically.
func (*Backoff) IsInBackOffSince ¶ added in v1.1.0
Returns True if the elapsed time since eventTime is smaller than the current backoff window
func (*Backoff) IsInBackOffSinceUpdate ¶ added in v1.2.0
Returns True if time since lastupdate is less than the current backoff window.
type BoolFlag ¶ added in v0.10.0
type BoolFlag struct {
// contains filtered or unexported fields
}
BoolFlag is a boolean flag compatible with flags and pflags that keeps track of whether it had a value supplied or not. Getting this flag to act like a normal bool, where true/false are not required needs a little bit of extra code, example:
f := cmd.Flags().VarPF(&BoolFlagVar, "flagname", "", "help about the flag") f.NoOptDefVal = "true"
type Cache ¶ added in v0.17.0
type Cache []*cacheShard
type Clock ¶ added in v0.8.2
Clock allows for injecting fake or real clocks into code that needs to do arbitrary things based on time.
type ConfigurationMap ¶ added in v0.9.0
func (*ConfigurationMap) Set ¶ added in v0.9.0
func (m *ConfigurationMap) Set(value string) error
func (*ConfigurationMap) String ¶ added in v0.9.0
func (m *ConfigurationMap) String() string
func (*ConfigurationMap) Type ¶ added in v0.9.0
func (*ConfigurationMap) Type() string
type FakeClock ¶ added in v0.8.2
FakeClock implements Clock, but returns an arbitrary time.
type GlogWriter ¶
type GlogWriter struct{}
GlogWriter serves as a bridge between the standard log package and the glog package.
type IntervalClock ¶ added in v1.2.0
IntervalClock implements Clock, but each invocation of Now steps the clock forward the specified duration
func (*IntervalClock) Now ¶ added in v1.2.0
func (i *IntervalClock) Now() time.Time
Now returns i's time.
type LineDelimiter ¶ added in v1.0.0
type LineDelimiter struct {
// contains filtered or unexported fields
}
A Line Delimiter is a filter that will
func NewLineDelimiter ¶ added in v1.0.0
func NewLineDelimiter(output io.Writer, delimiter string) *LineDelimiter
NewLineDelimiter allocates a new io.Writer that will split input on lines and bracket each line with the delimiter string. This can be useful in output tests where it is difficult to see and test trailing whitespace.
func (*LineDelimiter) Flush ¶ added in v1.0.0
func (ld *LineDelimiter) Flush() (err error)
Flush all lines up until now. This will assume insert a linebreak at the current point of the stream.
type RateLimiter ¶
type RateLimiter interface { // TryAccept returns true if a token is taken immediately. Otherwise, // it returns false. TryAccept() bool // Accept returns once a token becomes available. Accept() // Stop stops the rate limiter, subsequent calls to CanAccept will return false Stop() // Saturation returns a percentage number which describes how saturated // this rate limiter is. // Usually we use token bucket rate limiter. In that case, // 1.0 means no tokens are available; 0.0 means we have a full bucket of tokens to use. Saturation() float64 }
func NewFakeRateLimiter ¶ added in v0.15.0
func NewFakeRateLimiter() RateLimiter
func NewTokenBucketRateLimiter ¶
func NewTokenBucketRateLimiter(qps float32, burst int) RateLimiter
NewTokenBucketRateLimiter creates a rate limiter which implements a token bucket approach. The rate limiter allows bursts of up to 'burst' to exceed the QPS, while still maintaining a smoothed qps rate of 'qps'. The bucket is initially filled with 'burst' tokens, and refills at a rate of 'qps'. The maximum number of tokens in the bucket is capped at 'burst'.
type RealClock ¶ added in v0.8.2
type RealClock struct{}
RealClock really calls time.Now()
type Runner ¶ added in v0.5.1
type Runner struct {
// contains filtered or unexported fields
}
Runner is an abstraction to make it easy to start and stop groups of things that can be described by a single function which waits on a channel close to exit.
type SSHTunnel ¶ added in v0.19.0
type SSHTunnel struct { Config *ssh.ClientConfig Host string SSHPort string // contains filtered or unexported fields }
TODO: Unit tests for this code, we can spin up a test SSH server with instructions here: https://godoc.org/golang.org/x/crypto/ssh#ServerConn
func NewSSHTunnel ¶ added in v0.19.0
func NewSSHTunnelFromBytes ¶ added in v0.19.0
type SSHTunnelEntry ¶ added in v0.19.0
Should be thread safe.
type SSHTunnelList ¶ added in v0.19.0
type SSHTunnelList struct {
// contains filtered or unexported fields
}
Not thread safe!
func MakeSSHTunnels ¶ added in v0.19.0
func MakeSSHTunnels(user, keyfile string, addresses []string) *SSHTunnelList
func (*SSHTunnelList) Close ¶ added in v0.19.0
func (l *SSHTunnelList) Close()
Close asynchronously closes all tunnels in the list after waiting for 1 minute. Tunnels will still be open upon this function's return, but should no longer be used.
func (*SSHTunnelList) Has ¶ added in v0.19.0
func (l *SSHTunnelList) Has(addr string) bool
func (*SSHTunnelList) Len ¶ added in v0.19.1
func (l *SSHTunnelList) Len() int
func (*SSHTunnelList) Open ¶ added in v0.19.0
func (l *SSHTunnelList) Open() error
Open attempts to open all tunnels in the list, and removes any tunnels that failed to open.
func (*SSHTunnelList) PickRandomTunnel ¶ added in v0.20.0
func (l *SSHTunnelList) PickRandomTunnel() (SSHTunnelEntry, error)
Returns a random tunnel, xor an error if there are none.
type StringFlag ¶ added in v0.10.0
type StringFlag struct {
// contains filtered or unexported fields
}
StringFlag is a string flag compatible with flags and pflags that keeps track of whether it had a value supplied or not.
func NewStringFlag ¶ added in v0.18.0
func NewStringFlag(defaultVal string) StringFlag
func (*StringFlag) Default ¶ added in v0.10.0
func (f *StringFlag) Default(value string)
func (StringFlag) Provided ¶ added in v0.10.0
func (f StringFlag) Provided() bool
func (*StringFlag) Set ¶ added in v0.10.0
func (f *StringFlag) Set(value string) error
func (StringFlag) String ¶ added in v0.10.0
func (f StringFlag) String() string
func (*StringFlag) Type ¶ added in v0.10.0
func (f *StringFlag) Type() string
func (StringFlag) Value ¶ added in v0.10.0
func (f StringFlag) Value() string
Source Files
¶
Directories
¶
Path | Synopsis |
---|---|
Package bandwidth provides utilities for bandwidth shaping
|
Package bandwidth provides utilities for bandwidth shaping |
Package chown provides an interface and implementations for things that run run the chmod system call.
|
Package chown provides an interface and implementations for things that run run the chmod system call. |
Package chown provides utilities to chown a path
|
Package chown provides utilities to chown a path |
Package config provides utility objects for decoupling sources of configuration and the actual configuration state.
|
Package config provides utility objects for decoupling sources of configuration and the actual configuration state. |
Package dbus provides an injectable interface and implementations for D-Bus communication
|
Package dbus provides an injectable interface and implementations for D-Bus communication |
Package errors implements various utility functions and types around errors.
|
Package errors implements various utility functions and types around errors. |
Package exec provides an injectable interface and implementations for running commands.
|
Package exec provides an injectable interface and implementations for running commands. |
Package flushwriter implements a wrapper for a writer that flushes on every write if that writer implements the io.Flusher interface
|
Package flushwriter implements a wrapper for a writer that flushes on every write if that writer implements the io.Flusher interface |
Package httpstream adds multiplexed streaming support to HTTP requests and responses via connection upgrades.
|
Package httpstream adds multiplexed streaming support to HTTP requests and responses via connection upgrades. |
Package iptables provides an interface and implementations for running iptables commands.
|
Package iptables provides an interface and implementations for running iptables commands. |
package jsonpath is a template engine using jsonpath syntax, which can be seen at http://goessner.net/articles/JsonPath/.
|
package jsonpath is a template engine using jsonpath syntax, which can be seen at http://goessner.net/articles/JsonPath/. |
Package labels provides utilities to work with Kubernetes labels.
|
Package labels provides utilities to work with Kubernetes labels. |
Package limitwriter provides a writer that only allows a certain number of bytes to be written.
|
Package limitwriter provides a writer that only allows a certain number of bytes to be written. |
Package mount defines an interface to mounting filesystems.
|
Package mount defines an interface to mounting filesystems. |
Package oom implements utility functions relating to out of memory management.
|
Package oom implements utility functions relating to out of memory management. |
Package pod provides utilities to work with Kubernetes pod and pod templates.
|
Package pod provides utilities to work with Kubernetes pod and pod templates. |
Package procfs implements utility functions relating to the /proc mount.
|
Package procfs implements utility functions relating to the /proc mount. |
Package proxy provides transport and upgrade support for proxies
|
Package proxy provides transport and upgrade support for proxies |
Package rand provides utilities related to randomization.
|
Package rand provides utilities related to randomization. |
Package selinux contains selinux utility functions.
|
Package selinux contains selinux utility functions. |
Package sets has auto-generated set types.
|
Package sets has auto-generated set types. |
types
Package types just provides input types to the set generator.
|
Package types just provides input types to the set generator. |
Package slice provides utility methods for common operations on slices.
|
Package slice provides utility methods for common operations on slices. |
Package wait provides tools for polling or listening for changes to a condition.
|
Package wait provides tools for polling or listening for changes to a condition. |
Package workqueue provides a simple queue that supports the following features: * Fair: items processed in the order in which they are added.
|
Package workqueue provides a simple queue that supports the following features: * Fair: items processed in the order in which they are added. |
Package wsstream contains utilities for streaming content over WebSockets.
|
Package wsstream contains utilities for streaming content over WebSockets. |