kubectl create configmap

概要

基于文件、目录或指定字面值创建 ConfigMap。

单个 ConfigMap 可以打包一个或多个键值对。

基于文件创建 ConfigMap 时,键默认为文件的基本名称,值默认为文件内容。如果基本名称是无效的键,你可以指定一个替代键。

基于目录创建 ConfigMap 时,目录中基本名称为有效键的每个文件都将打包到 ConfigMap 中。除普通文件外的任何目录条目(例如子目录、符号链接、设备、管道等)都将被忽略。

kubectl create configmap NAME [--from-file=[key=]source] [--from-literal=key1=value1] [--dry-run=server|client|none]

示例

  # Create a new config map named my-config based on folder bar
  kubectl create configmap my-config --from-file=path/to/bar
  
  # Create a new config map named my-config with specified keys instead of file basenames on disk
  kubectl create configmap my-config --from-file=key1=/path/to/bar/file1.txt --from-file=key2=/path/to/bar/file2.txt
  
  # Create a new config map named my-config with key1=config1 and key2=config2
  kubectl create configmap my-config --from-literal=key1=config1 --from-literal=key2=config2
  
  # Create a new config map named my-config from the key=value pairs in the file
  kubectl create configmap my-config --from-file=path/to/bar
  
  # Create a new config map named my-config from an env file
  kubectl create configmap my-config --from-env-file=path/to/foo.env --from-env-file=path/to/bar.env

选项

--allow-missing-template-keys     默认值: true

如果为 true,则在模板中缺少字段或映射键时忽略模板中的所有错误。仅适用于 golang 和 jsonpath 输出格式。

--append-hash

在 ConfigMap 名称后追加其哈希值。

--dry-run string[="unchanged"]     默认值: "none"

必须是 "none"、"server" 或 "client"。如果使用客户端策略,则仅打印将发送的对象,而不实际发送。如果使用服务器端策略,则提交服务器端请求而不持久化资源。

--field-manager string     默认值: "kubectl-create"

用于跟踪字段所有权的管理器名称。

--from-env-file strings

指定文件路径,从中读取 key=val 对的行以创建 ConfigMap。

--from-file strings

键文件可以使用其文件路径指定,此时文件基本名称将用作 ConfigMap 键;或者可选地使用一个键和文件路径指定,此时将使用给定的键。指定目录将遍历目录中每个名称为有效 ConfigMap 键的文件。

--from-literal strings

指定要插入 ConfigMap 的键和字面值(例如 mykey=somevalue)。

-h, --help

configmap 的帮助信息

-o, --output string

输出格式。以下之一:(json, yaml, name, go-template, go-template-file, template, templatefile, jsonpath, jsonpath-as-json, jsonpath-file)。

--save-config

如果为 true,则当前对象的配置将保存在其注解中。否则,注解将保持不变。此标志在你将来想对此对象执行 kubectl apply 时很有用。

--show-managed-fields

如果为 true,则在以 JSON 或 YAML 格式打印对象时保留 managedFields。

--template string

当 -o=go-template, -o=go-template-file 时使用的模板字符串或模板文件路径。模板格式为 golang 模板 [https://golang.ac.cn/pkg/text/template/#pkg-overview]。

--validate string[="strict"]     默认值: "strict"

必须是以下之一:strict(或 true)、warn、ignore(或 false)。"true" 或 "strict" 将使用 Schema 验证输入,如果无效则请求失败。如果 api-server 上启用了 ServerSideFieldValidation,它将执行服务器端验证,否则将回退到不太可靠的客户端验证。"warn" 将在 API 服务器上启用了服务器端字段验证时对未知或重复字段发出警告而不阻塞请求,否则行为与 "ignore" 相同。"false" 或 "ignore" 将不执行任何 Schema 验证,默默丢弃任何未知或重复字段。

继承的父级选项

--as string

用于冒充执行操作的用户名。用户可以是普通用户或命名空间中的 ServiceAccount。

--as-group strings

用于冒充执行操作的组,此标志可重复以指定多个组。

--as-uid string

用于冒充执行操作的 UID。

--cache-dir string     默认值: "$HOME/.kube/cache"

默认缓存目录

--certificate-authority string

证书颁发机构的证书文件路径

--client-certificate string

用于 TLS 的客户端证书文件路径

--client-key string

用于 TLS 的客户端密钥文件路径

--cluster string

要使用的 kubeconfig 集群名称

--context string

要使用的 kubeconfig Context 名称

--default-not-ready-toleration-seconds int     默认值: 300

表示默认添加到每个尚无此容忍度的 Pod 的针对 notReady:NoExecute 容忍度的 tolerationSeconds。

--default-unreachable-toleration-seconds int     默认值: 300

表示默认添加到每个尚无此容忍度的 Pod 的针对 unreachable:NoExecute 容忍度的 tolerationSeconds。

--disable-compression

如果为 true,则对所有发往服务器的请求禁用响应压缩。

--insecure-skip-tls-verify

如果为 true,则不检查服务器证书的有效性。这将使你的 HTTPS 连接不安全。

--kubeconfig string

用于 CLI 请求的 kubeconfig 文件路径。

--match-server-version

要求服务器版本与客户端版本匹配。

-n, --namespace string

如果存在,则此 CLI 请求的命名空间范围。

--password string

用于对 API 服务器进行基本身份验证的密码。

--profile string     默认值: "none"

要捕获的性能分析名称。以下之一:(none|cpu|heap|goroutine|threadcreate|block|mutex)

--profile-output string     默认值: "profile.pprof"

写入性能分析数据的文件名。

--request-timeout string     默认值: "0"

单个服务器请求超时前等待的时间长度。非零值应包含相应的时间单位(例如 1s, 2m, 3h)。零值表示请求不超时。

-s, --server string

Kubernetes API 服务器的地址和端口。

--storage-driver-buffer-duration duration     默认值: 1m0s

存储驱动中的写入将缓冲此持续时间,并作为单个事务提交到非内存后端。

--storage-driver-db string     默认值: "cadvisor"

数据库名称

--storage-driver-host string     默认值: "localhost:8086"

数据库主机:端口

--storage-driver-password string     默认值: "root"

数据库密码

--storage-driver-secure

使用安全连接连接数据库

--storage-driver-table string     默认值: "stats"

表名称

--storage-driver-user string     默认值: "root"

数据库用户名

--tls-server-name string

用于服务器证书验证的服务器名称。如果未提供,则使用用于连接服务器的主机名。

--token string

用于对 API 服务器进行身份验证的 Bearer token。

--user string

要使用的 kubeconfig 用户名。

--username string

用于对 API 服务器进行基本身份验证的用户名。

--version version[=true]

--version, --version=raw 打印版本信息并退出;--version=vX.Y.Z... 设置报告的版本。

--warnings-as-errors

将从服务器收到的警告视为错误并以非零退出码退出。

另请参见

此页面是自动生成的。

如果你打算报告此页面的问题,请在问题描述中说明此页面是自动生成的。修复可能需要在 Kubernetes 项目的其他地方进行。

最后修改于 2024年12月12日 下午2:44 PST:更新 v1.32 的 kubectl 参考 (5c2cfa02af)