kubernetes.v0: gopkg.in/kubernetes/kubernetes.v0/pkg/client/clientcmd/api Index | Files | Directories

package api

import "gopkg.in/kubernetes/kubernetes.v0/pkg/client/clientcmd/api"

Index

Package Files

helpers.go register.go types.go

Variables

var Scheme = runtime.NewScheme()

Scheme is the default instance of runtime.Scheme to which types in the Kubernetes API are already registered.

func FlattenConfig Uses

func FlattenConfig(config *Config) error

Flatten changes the config object into a self contained config (useful for making secrets)

func FlattenContent Uses

func FlattenContent(path *string, contents *[]byte, baseDir string) error

func MakeAbs Uses

func MakeAbs(path, base string) (string, error)

func MinifyConfig Uses

func MinifyConfig(config *Config) error

MinifyConfig read the current context and uses that to keep only the relevant pieces of config This is useful for making secrets based on kubeconfig files

func ResolvePath Uses

func ResolvePath(path string, base string) string

ResolvePath returns the path as an absolute paths, relative to the given base directory

func ShortenConfig Uses

func ShortenConfig(config *Config)

Flatten redacts raw data entries from the config object for a human-readable view.

type AuthInfo Uses

type AuthInfo struct {
    // LocationOfOrigin indicates where this object came from.  It is used for round tripping config post-merge, but never serialized.
    LocationOfOrigin string
    // ClientCertificate is the path to a client cert file for TLS.
    ClientCertificate string `json:"client-certificate,omitempty"`
    // ClientCertificateData contains PEM-encoded data from a client cert file for TLS. Overrides ClientCertificate
    ClientCertificateData []byte `json:"client-certificate-data,omitempty"`
    // ClientKey is the path to a client key file for TLS.
    ClientKey string `json:"client-key,omitempty"`
    // ClientKeyData contains PEM-encoded data from a client key file for TLS. Overrides ClientKey
    ClientKeyData []byte `json:"client-key-data,omitempty"`
    // Token is the bearer token for authentication to the kubernetes cluster.
    Token string `json:"token,omitempty"`
    // Username is the username for basic authentication to the kubernetes cluster.
    Username string `json:"username,omitempty"`
    // Password is the password for basic authentication to the kubernetes cluster.
    Password string `json:"password,omitempty"`
    // Extensions holds additional information. This is useful for extenders so that reads and writes don't clobber unknown fields
    Extensions map[string]runtime.EmbeddedObject `json:"extensions,omitempty"`
}

AuthInfo contains information that describes identity information. This is use to tell the kubernetes cluster who you are.

func NewAuthInfo Uses

func NewAuthInfo() *AuthInfo

NewConfig is a convenience function that returns a new Config object with non-nil maps

type Cluster Uses

type Cluster struct {
    // LocationOfOrigin indicates where this object came from.  It is used for round tripping config post-merge, but never serialized.
    LocationOfOrigin string
    // Server is the address of the kubernetes cluster (https://hostname:port).
    Server string `json:"server"`
    // APIVersion is the preferred api version for communicating with the kubernetes cluster (v1beta1, v1beta2, v1beta3, etc).
    APIVersion string `json:"api-version,omitempty"`
    // InsecureSkipTLSVerify skips the validity check for the server's certificate. This will make your HTTPS connections insecure.
    InsecureSkipTLSVerify bool `json:"insecure-skip-tls-verify,omitempty"`
    // CertificateAuthority is the path to a cert file for the certificate authority.
    CertificateAuthority string `json:"certificate-authority,omitempty"`
    // CertificateAuthorityData contains PEM-encoded certificate authority certificates. Overrides CertificateAuthority
    CertificateAuthorityData []byte `json:"certificate-authority-data,omitempty"`
    // Extensions holds additional information. This is useful for extenders so that reads and writes don't clobber unknown fields
    Extensions map[string]runtime.EmbeddedObject `json:"extensions,omitempty"`
}

Cluster contains information about how to communicate with a kubernetes cluster

func NewCluster Uses

func NewCluster() *Cluster

NewConfig is a convenience function that returns a new Config object with non-nil maps

type Config Uses

type Config struct {
    // Legacy field from pkg/api/types.go TypeMeta.
    // TODO(jlowdermilk): remove this after eliminating downstream dependencies.
    Kind string `json:"kind,omitempty"`
    // Version of the schema for this config object.
    APIVersion string `json:"apiVersion,omitempty"`
    // Preferences holds general information to be use for cli interactions
    Preferences Preferences `json:"preferences"`
    // Clusters is a map of referencable names to cluster configs
    Clusters map[string]Cluster `json:"clusters"`
    // AuthInfos is a map of referencable names to user configs
    AuthInfos map[string]AuthInfo `json:"users"`
    // Contexts is a map of referencable names to context configs
    Contexts map[string]Context `json:"contexts"`
    // CurrentContext is the name of the context that you would like to use by default
    CurrentContext string `json:"current-context"`
    // Extensions holds additional information. This is useful for extenders so that reads and writes don't clobber unknown fields
    Extensions map[string]runtime.EmbeddedObject `json:"extensions,omitempty"`
}

Config holds the information needed to build connect to remote kubernetes clusters as a given user

func NewConfig Uses

func NewConfig() *Config

NewConfig is a convenience function that returns a new Config object with non-nil maps

func (*Config) IsAnAPIObject Uses

func (*Config) IsAnAPIObject()

type Context Uses

type Context struct {
    // LocationOfOrigin indicates where this object came from.  It is used for round tripping config post-merge, but never serialized.
    LocationOfOrigin string
    // Cluster is the name of the cluster for this context
    Cluster string `json:"cluster"`
    // AuthInfo is the name of the authInfo for this context
    AuthInfo string `json:"user"`
    // Namespace is the default namespace to use on unspecified requests
    Namespace string `json:"namespace,omitempty"`
    // Extensions holds additional information. This is useful for extenders so that reads and writes don't clobber unknown fields
    Extensions map[string]runtime.EmbeddedObject `json:"extensions,omitempty"`
}

Context is a tuple of references to a cluster (how do I communicate with a kubernetes cluster), a user (how do I identify myself), and a namespace (what subset of resources do I want to work with)

func NewContext Uses

func NewContext() *Context

NewConfig is a convenience function that returns a new Config object with non-nil maps

type Preferences Uses

type Preferences struct {
    Colors bool `json:"colors,omitempty"`
    // Extensions holds additional information. This is useful for extenders so that reads and writes don't clobber unknown fields
    Extensions map[string]runtime.EmbeddedObject `json:"extensions,omitempty"`
}

func NewPreferences Uses

func NewPreferences() *Preferences

NewConfig is a convenience function that returns a new Config object with non-nil maps

Directories

PathSynopsis
latest
v1

Package api imports 8 packages (graph). Updated 2016-07-25. Refresh now. Tools for package owners.