-
Notifications
You must be signed in to change notification settings - Fork 76
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
- Loading branch information
1 parent
f1b06a0
commit b56e290
Showing
15 changed files
with
2,016 additions
and
9 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -1,3 +0,0 @@ | ||
[submodule "kubernetes/base"] | ||
path = kubernetes/base | ||
url = [email protected]:kubernetes-client/go-base.git | ||
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Submodule base
deleted from
8dcf05
This file was deleted.
Oops, something went wrong.
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,27 @@ | ||
# Kubernetes Config type Definition and Deepcopy Utility | ||
|
||
This directory contains type definition and deepcopy utility copied from | ||
k8s.io/client-go that are used for parsing and persist kube config yaml | ||
file. | ||
|
||
### types.go | ||
|
||
The Config type definition is copied from k8s.io/client-go/tools/clientcmd/api/v1/types.go | ||
for parsing the kube config yaml. The "k8s.io/apimachinery/pkg/runtime" dependency has | ||
been removed. An example of using this type definition to parse a kube config | ||
yaml is: | ||
|
||
```go | ||
// Init an empty api.Config as unmarshal layout template | ||
c := api.Config{} | ||
err = yaml.Unmarshal(kubeConfig, &c) | ||
if err != nil { | ||
return nil, err | ||
} | ||
``` | ||
|
||
### zz\_generated.deepcopy.go | ||
The Config type deepcopy util file is copied from | ||
k8s.io/client-go/tools/clientcmd/api/v1/zz\_generated.deepcopy.go | ||
for deepcopy the kube config. The "k8s.io/apimachinery/pkg/runtime" dependency has | ||
been removed. |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,204 @@ | ||
/* | ||
Copyright 2018 The Kubernetes Authors. | ||
Licensed under the Apache License, Version 2.0 (the "License"); | ||
you may not use this file except in compliance with the License. | ||
You may obtain a copy of the License at | ||
http://www.apache.org/licenses/LICENSE-2.0 | ||
Unless required by applicable law or agreed to in writing, software | ||
distributed under the License is distributed on an "AS IS" BASIS, | ||
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. | ||
See the License for the specific language governing permissions and | ||
limitations under the License. | ||
*/ | ||
|
||
package api | ||
|
||
// NOTE: This Config type definition is copied from k8s.io/client-go/tools/clientcmd/api/v1/types.go | ||
// for parsing the kube config yaml. The "k8s.io/apimachinery/pkg/runtime" dependency has | ||
// been removed. | ||
|
||
// Where possible, json tags match the cli argument names. | ||
// Top level config objects and all values required for proper functioning are not "omitempty". Any truly optional piece of config is allowed to be omitted. | ||
|
||
// Config holds the information needed to build connect to remote kubernetes clusters as a given user | ||
// +k8s:deepcopy-gen:interfaces=k8s.io/apimachinery/pkg/runtime.Object | ||
type Config struct { | ||
// Legacy field from pkg/api/types.go TypeMeta. | ||
// TODO(jlowdermilk): remove this after eliminating downstream dependencies. | ||
// +optional | ||
Kind string `json:"kind,omitempty"` | ||
// Legacy field from pkg/api/types.go TypeMeta. | ||
// TODO(jlowdermilk): remove this after eliminating downstream dependencies. | ||
// +optional | ||
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 []NamedCluster `json:"clusters"` | ||
// AuthInfos is a map of referencable names to user configs | ||
AuthInfos []NamedAuthInfo `json:"users"` | ||
// Contexts is a map of referencable names to context configs | ||
Contexts []NamedContext `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 | ||
// +optional | ||
Extensions []NamedExtension `json:"extensions,omitempty"` | ||
} | ||
|
||
// Preferences holds general information to be use for cli interactions | ||
type Preferences struct { | ||
// +optional | ||
Colors bool `json:"colors,omitempty"` | ||
// Extensions holds additional information. This is useful for extenders so that reads and writes don't clobber unknown fields | ||
// +optional | ||
Extensions []NamedExtension `json:"extensions,omitempty"` | ||
} | ||
|
||
// Cluster contains information about how to communicate with a kubernetes cluster | ||
type Cluster struct { | ||
// Server is the address of the kubernetes cluster (https://hostname:port). | ||
Server string `json:"server"` | ||
// InsecureSkipTLSVerify skips the validity check for the server's certificate. This will make your HTTPS connections insecure. | ||
// +optional | ||
InsecureSkipTLSVerify bool `json:"insecure-skip-tls-verify,omitempty"` | ||
// CertificateAuthority is the path to a cert file for the certificate authority. | ||
// +optional | ||
CertificateAuthority string `json:"certificate-authority,omitempty"` | ||
// CertificateAuthorityData contains PEM-encoded certificate authority certificates. Overrides CertificateAuthority | ||
// +optional | ||
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 | ||
// +optional | ||
Extensions []NamedExtension `json:"extensions,omitempty"` | ||
} | ||
|
||
// AuthInfo contains information that describes identity information. This is use to tell the kubernetes cluster who you are. | ||
type AuthInfo struct { | ||
// ClientCertificate is the path to a client cert file for TLS. | ||
// +optional | ||
ClientCertificate string `json:"client-certificate,omitempty"` | ||
// ClientCertificateData contains PEM-encoded data from a client cert file for TLS. Overrides ClientCertificate | ||
// +optional | ||
ClientCertificateData []byte `json:"client-certificate-data,omitempty"` | ||
// ClientKey is the path to a client key file for TLS. | ||
// +optional | ||
ClientKey string `json:"client-key,omitempty"` | ||
// ClientKeyData contains PEM-encoded data from a client key file for TLS. Overrides ClientKey | ||
// +optional | ||
ClientKeyData []byte `json:"client-key-data,omitempty"` | ||
// Token is the bearer token for authentication to the kubernetes cluster. | ||
// +optional | ||
Token string `json:"token,omitempty"` | ||
// TokenFile is a pointer to a file that contains a bearer token (as described above). If both Token and TokenFile are present, Token takes precedence. | ||
// +optional | ||
TokenFile string `json:"tokenFile,omitempty"` | ||
// Impersonate is the username to imperonate. The name matches the flag. | ||
// +optional | ||
Impersonate string `json:"as,omitempty"` | ||
// ImpersonateGroups is the groups to imperonate. | ||
// +optional | ||
ImpersonateGroups []string `json:"as-groups,omitempty"` | ||
// ImpersonateUserExtra contains additional information for impersonated user. | ||
// +optional | ||
ImpersonateUserExtra map[string][]string `json:"as-user-extra,omitempty"` | ||
// Username is the username for basic authentication to the kubernetes cluster. | ||
// +optional | ||
Username string `json:"username,omitempty"` | ||
// Password is the password for basic authentication to the kubernetes cluster. | ||
// +optional | ||
Password string `json:"password,omitempty"` | ||
// AuthProvider specifies a custom authentication plugin for the kubernetes cluster. | ||
// +optional | ||
AuthProvider *AuthProviderConfig `json:"auth-provider,omitempty"` | ||
// Exec specifies a custom exec-based authentication plugin for the kubernetes cluster. | ||
// +optional | ||
Exec *ExecConfig `json:"exec,omitempty"` | ||
// Extensions holds additional information. This is useful for extenders so that reads and writes don't clobber unknown fields | ||
// +optional | ||
Extensions []NamedExtension `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) | ||
type Context struct { | ||
// 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 | ||
// +optional | ||
Namespace string `json:"namespace,omitempty"` | ||
// Extensions holds additional information. This is useful for extenders so that reads and writes don't clobber unknown fields | ||
// +optional | ||
Extensions []NamedExtension `json:"extensions,omitempty"` | ||
} | ||
|
||
// NamedCluster relates nicknames to cluster information | ||
type NamedCluster struct { | ||
// Name is the nickname for this Cluster | ||
Name string `json:"name"` | ||
// Cluster holds the cluster information | ||
Cluster Cluster `json:"cluster"` | ||
} | ||
|
||
// NamedContext relates nicknames to context information | ||
type NamedContext struct { | ||
// Name is the nickname for this Context | ||
Name string `json:"name"` | ||
// Context holds the context information | ||
Context Context `json:"context"` | ||
} | ||
|
||
// NamedAuthInfo relates nicknames to auth information | ||
type NamedAuthInfo struct { | ||
// Name is the nickname for this AuthInfo | ||
Name string `json:"name"` | ||
// AuthInfo holds the auth information | ||
AuthInfo AuthInfo `json:"user"` | ||
} | ||
|
||
// NamedExtension relates nicknames to extension information | ||
type NamedExtension struct { | ||
// Name is the nickname for this Extension | ||
Name string `json:"name"` | ||
// Extension holds the extension information | ||
Extension interface{} `json:"extension"` | ||
} | ||
|
||
// AuthProviderConfig holds the configuration for a specified auth provider. | ||
type AuthProviderConfig struct { | ||
Name string `json:"name"` | ||
Config map[string]string `json:"config"` | ||
} | ||
|
||
// ExecConfig specifies a command to provide client credentials. The command is exec'd | ||
// and outputs structured stdout holding credentials. | ||
// | ||
// See the client.authentiction.k8s.io API group for specifications of the exact input | ||
// and output format | ||
type ExecConfig struct { | ||
// Command to execute. | ||
Command string `json:"command"` | ||
// Arguments to pass to the command when executing it. | ||
// +optional | ||
Args []string `json:"args"` | ||
// Env defines additional environment variables to expose to the process. These | ||
// are unioned with the host's environment, as well as variables client-go uses | ||
// to pass argument to the plugin. | ||
// +optional | ||
Env []ExecEnvVar `json:"env"` | ||
|
||
// Preferred input version of the ExecInfo. The returned ExecCredentials MUST use | ||
// the same encoding version as the input. | ||
APIVersion string `json:"apiVersion,omitempty"` | ||
} | ||
|
||
// ExecEnvVar is used for setting environment variables when executing an exec-based | ||
// credential plugin. | ||
type ExecEnvVar struct { | ||
Name string `json:"name"` | ||
Value string `json:"value"` | ||
} |
Oops, something went wrong.