Struct kube::Config

pub struct Config {
    pub cluster_url: Uri,
    pub default_namespace: String,
    pub root_cert: Option<Vec<Vec<u8, Global>, Global>>,
    pub connect_timeout: Option<Duration>,
    pub read_timeout: Option<Duration>,
    pub write_timeout: Option<Duration>,
    pub timeout: Option<Duration>,
    pub accept_invalid_certs: bool,
    pub auth_info: AuthInfo,
    pub proxy_url: Option<Uri>,
}

Available on crate feature config only.

Configuration object detailing things like cluster URL, default namespace, root certificates, and timeouts.

Usage

Construct a Config instance by using one of the many constructors.

Prefer Config::infer unless you have particular issues, and avoid manually managing the data in this struct unless you have particular needs. It exists to be consumed by the Client.

If you are looking to parse the kubeconfig found in a user’s home directory see Kubeconfig.

Fields

cluster_url: Uri

The configured cluster url

default_namespace: String

The configured default namespace

root_cert: Option<Vec<Vec<u8, Global>, Global>>

The configured root certificate

connect_timeout: Option<Duration>

Set the timeout for connecting to the Kubernetes API.

A value of None means no timeout

read_timeout: Option<Duration>

Set the timeout for the Kubernetes API response.

A value of None means no timeout

write_timeout: Option<Duration>

Set the timeout for the Kubernetes API request.

A value of None means no timeout

timeout: Option<Duration>

👎Deprecated since 0.75.0:

replaced by more granular members connect_timeout, read_timeout and write_timeout. This member will be removed in 0.78.0.

Timeout for calls to the Kubernetes API.

A value of None means no timeout

accept_invalid_certs: bool

Whether to accept invalid certificates

auth_info: AuthInfo

Stores information to tell the cluster who you are.

proxy_url: Option<Uri>

Optional proxy URL.

Implementations

impl Config

pub fn new(cluster_url: Uri) -> Config

Construct a new config where only the cluster_url is set by the user. and everything else receives a default value.

Most likely you want to use Config::infer to infer the config from the environment.

pub async fn infer() -> impl Future<Output = Result<Config, InferConfigError>>

Infer a Kubernetes client configuration.

First, a user’s kubeconfig is loaded from KUBECONFIG or ~/.kube/config. If that fails, an in-cluster config is loaded via Config::incluster. If inference from both sources fails, then an error is returned.

Config::apply_debug_overrides is used to augment the loaded configuration based on the environment.

pub fn incluster() -> Result<Config, Error>

Load an in-cluster Kubernetes client configuration using Config::incluster_dns.

The rustls-tls feature is currently incompatible with Config::incluster_env. See https://github.com/kube-rs/kube-rs/issues/1003.

pub fn incluster_env() -> Result<Config, Error>

Load an in-cluster config using the KUBERNETES_SERVICE_HOST and KUBERNETES_SERVICE_PORT environment variables.

A service account’s token must be available in /var/run/secrets/kubernetes.io/serviceaccount/.

This method matches the behavior of the official Kubernetes client libraries, but it is not compatible with the rustls-tls feature . When this feature is enabled, Config::incluster_dns should be used instead. See https://github.com/kube-rs/kube-rs/issues/1003.

pub fn incluster_dns() -> Result<Config, Error>

Load an in-cluster config using the API server at https://kubernetes.default.svc.

A service account’s token must be available in /var/run/secrets/kubernetes.io/serviceaccount/.

This behavior does not match that of the official Kubernetes clients, but this approach is compatible with the rustls-tls feature.

pub async fn from_kubeconfig(
    options: &KubeConfigOptions
) -> impl Future<Output = Result<Config, KubeconfigError>>

Create configuration from the default local config file

This will respect the $KUBECONFIG evar, but otherwise default to ~/.kube/config. You can also customize what context/cluster/user you want to use here, but it will default to the current-context.

pub async fn from_custom_kubeconfig(
    kubeconfig: Kubeconfig,
    options: &KubeConfigOptions
) -> impl Future<Output = Result<Config, KubeconfigError>>

Create configuration from a Kubeconfig struct

This bypasses kube’s normal config parsing to obtain custom functionality.

pub fn apply_debug_overrides(&mut self)

Override configuration based on environment variables

This is only intended for use as a debugging aid, and the specific variables and their behaviour should not be considered stable across releases.

Currently, the following overrides are supported:

• KUBE_RS_DEBUG_IMPERSONATE_USER: A Kubernetes user to impersonate, for example: system:serviceaccount:default:foo will impersonate the ServiceAccount foo in the Namespace default
• KUBE_RS_DEBUG_IMPERSONATE_GROUP: A Kubernetes group to impersonate, multiple groups may be specified by separating them with commas
• KUBE_RS_DEBUG_OVERRIDE_URL: A Kubernetes cluster URL to use rather than the one specified in the config, useful for proxying traffic through kubectl proxy

Trait Implementations

impl Clone for Config

fn clone(&self) -> Config

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl ConfigExt for Config

fn base_uri_layer(&self) -> BaseUriLayer

Layer to set the base URI of requests to the configured server.

fn auth_layer(&self) -> Result<Option<AuthLayer>, Error>

Optional layer to set up Authorization header depending on the config.

fn extra_headers_layer(&self) -> Result<ExtraHeadersLayer, Error>

Layer to add non-authn HTTP headers depending on the config.

fn native_tls_connector(&self) -> Result<TlsConnector, Error>

Create native_tls::TlsConnector based on config.

fn native_tls_https_connector(
    &self
) -> Result<HttpsConnector<HttpConnector<GaiResolver>>, Error>

Create [hyper_tls::HttpsConnector] based on config.

fn rustls_client_config(&self) -> Result<ClientConfig, Error>

Create [rustls::ClientConfig] based on config.

fn rustls_https_connector(
    &self
) -> Result<HttpsConnector<HttpConnector<GaiResolver>>, Error>

Create [hyper_rustls::HttpsConnector] based on config.

fn openssl_ssl_connector_builder(&self) -> Result<SslConnectorBuilder, Error>

Create [openssl::ssl::SslConnectorBuilder] based on config.

fn openssl_https_connector(
    &self
) -> Result<HttpsConnector<HttpConnector<GaiResolver>>, Error>

Create [hyper_openssl::HttpsConnector] based on config.

fn openssl_https_connector_with_connector(
    &self,
    connector: HttpConnector<GaiResolver>
) -> Result<HttpsConnector<HttpConnector<GaiResolver>>, Error>

Create [hyper_openssl::HttpsConnector] based on config and connector.

impl Debug for Config

fn fmt(&self, f: &mut Formatter<'_>) -> Result<(), Error>

Formats the value using the given formatter.

impl TryFrom<Config> for Client

fn try_from(config: Config) -> Result<Client, Error>

Builds a default Client from a Config, see ClientBuilder if more customization is required

type Error = Error

The type returned in the event of a conversion error.

impl TryFrom<Config> for ClientBuilder<BoxService<Request<Body>, Response<Box<dyn Body<Error = Box<dyn Error + Send + Sync + 'static, Global>, Data = Bytes> + Send + Unpin + 'static, Global>>, Box<dyn Error + Send + Sync + 'static, Global>>>

fn try_from(
    config: Config
) -> Result<ClientBuilder<BoxService<Request<Body>, Response<Box<dyn Body<Error = Box<dyn Error + Send + Sync + 'static, Global>, Data = Bytes> + Send + Unpin + 'static, Global>>, Box<dyn Error + Send + Sync + 'static, Global>>>, Error>

Builds a default ClientBuilder stack from a given configuration

type Error = Error

The type returned in the event of a conversion error.