kubeconfig

Documentation

Index

• Constants
• func AppendAuthenticator(config *clientcmdapi.Config, clusterMeta *api.ClusterMeta, ...)
• func AuthenticatorCommands() []string
• func AutoPath(name string) string
• func DefaultPath() string
• func LookupAuthenticator() (string, bool)
• func MaybeDeleteConfig(meta *api.ClusterMeta)
• func NewForKubectl(spec *api.ClusterConfig, username, roleARN, profile string) *clientcmdapi.Config
• func NewForUser(spec *api.ClusterConfig, username string) *clientcmdapi.Config
• func Write(path string, newConfig clientcmdapi.Config, setContext bool) (string, error)
• type ConfigBuilder
  • func NewBuilder(metadata *api.ClusterMeta, status *api.ClusterStatus, username string) *ConfigBuilder
  • func (cb *ConfigBuilder) Build() *clientcmdapi.Config
  • func (cb *ConfigBuilder) UseCertificateAuthorityFile(path string) *ConfigBuilder
  • func (cb *ConfigBuilder) UseSystemCA() *ConfigBuilder

Constants

const (
	// AWSIAMAuthenticator defines the name of the AWS IAM authenticator
	AWSIAMAuthenticator = "aws-iam-authenticator"
	// HeptioAuthenticatorAWS defines the old name of AWS IAM authenticator
	HeptioAuthenticatorAWS = "heptio-authenticator-aws"
	// AWSEKSAuthenticator defines the recently added `aws eks get-token` command
	AWSEKSAuthenticator = "aws"
	// Shadowing the default kubeconfig path environment variable
	RecommendedConfigPathEnvVar = clientcmd.RecommendedConfigPathEnvVar
)

Functions

func AppendAuthenticator

func AppendAuthenticator(config *clientcmdapi.Config, clusterMeta *api.ClusterMeta, authenticatorCMD, roleARN, profile string)

AppendAuthenticator appends the AWS IAM authenticator, and if profile is non-empty string it sets AWS_PROFILE environment variable also

func AuthenticatorCommands

func AuthenticatorCommands() []string

AuthenticatorCommands returns all of authenticator commands

func AutoPath

func AutoPath(name string) string

AutoPath returns the path for the auto-generated kubeconfig

func DefaultPath

func DefaultPath() string

DefaultPath defines the default path

func LookupAuthenticator

func LookupAuthenticator() (string, bool)

LookupAuthenticator looks up an available authenticator

func MaybeDeleteConfig

func MaybeDeleteConfig(meta *api.ClusterMeta)

MaybeDeleteConfig will delete the auto-generated kubeconfig, if it exists

func NewForKubectl

func NewForKubectl(spec *api.ClusterConfig, username, roleARN, profile string) *clientcmdapi.Config

NewForKubectl creates configuration for a user with kubectl by configuring a suitable authenticator and respecting provider settings

func NewForUser

func NewForUser(spec *api.ClusterConfig, username string) *clientcmdapi.Config

NewForUser returns a Config suitable for a user by respecting provider settings

func Write

func Write(path string, newConfig clientcmdapi.Config, setContext bool) (string, error)

Write will write Kubernetes client configuration to a file. If path isn't specified then the path will be determined by client-go. If file pointed to by path doesn't exist it will be created. If the file already exists then the configuration will be merged with the existing file.

Types

type ConfigBuilder

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

ConfigBuilder can create a client-go clientcmd Config

func NewBuilder

func NewBuilder(metadata *api.ClusterMeta, status *api.ClusterStatus, username string) *ConfigBuilder

NewBuilder returns a minimal ConfigBuilder

func (*ConfigBuilder) Build

func (cb *ConfigBuilder) Build() *clientcmdapi.Config

Build creates the Config with the ConfigBuilder settings

func (*ConfigBuilder) UseCertificateAuthorityFile

func (cb *ConfigBuilder) UseCertificateAuthorityFile(path string) *ConfigBuilder

UseCertificateAuthorityFile sets the config to use CA from file for TLS communication instead of the CA retrieved from EKS

func (*ConfigBuilder) UseSystemCA

func (cb *ConfigBuilder) UseSystemCA() *ConfigBuilder

UseSystemCA sets the config to use the system CAs for TLS communication instead of the CA retrieved from EKS