更新时间:2025-04-18 GMT+08:00

ccictl apply

操作背景

基于文件名或标准输入将配置应用于资源。必须指定资源名称。如果资源尚不存在,则资源会被创建。 若要使用 apply 命令,最初创建资源时应始终使用 apply 或 create --save-config。

支持 JSON 和 YAML 格式。

ccictl apply -f FILENAME

示例

# 将 pod.json 中的配置应用到 Pod
ccictl apply -f ./pod.json

# 应用来自目录中的资源
ccictl apply -f dir/

# 将传递到 stdin 的 JSON 应用到 Pod
cat pod.json | ccictl apply -f -

# 应用所有以 ".json" 结尾的文件中的配置
ccictl apply -f '*.json'

选项

--all

选择指定资源类型的命名空间中的所有资源。

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

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

--cascade string[="background"]     默认值:"background"

必须是 "background"、"orphan" 或 "foreground"。 选择依赖项(例如,由 Deployment 创建的 Pod)的删除级联策略, 默认为 background。

-f, --filename strings

包含了待应用的配置信息的文件。

--force

如果为真,则立即从 API 中移除资源并略过体面删除处理。 请注意,立即删除某些资源可能会导致不一致或数据丢失,并且需要确认操作。

--grace-period int     默认值:-1

指定给资源的体面终止时间(以秒为单位)。 如果为负数则忽略,为 1 表示立即关闭。 仅当 --force 为真(强制删除)时才可以设置为 0。

-h, --help

apply 操作的帮助命令。

--openapi-patch     默认值:true

如果为真,则当 openapi 存在且资源可在 openapi 规范中找到时,使用 openapi 计算 diff。 否则,回退到使用内置类型。

-o, --output string

输出格式。可选值为: json、yaml、name、go-template、go-template-file、template、templatefile、jsonpath、jsonpath-as-json、jsonpath-file。

--overwrite     默认值:true

使用修改后的配置中的值自动解决修改后的配置与实时配置之间的冲突。

-R, --recursive

递归处理在 -f、--filename 中给出的目录。当您想要管理位于同一目录中的相关清单时很有用。

-l, --selector string

过滤所用的选择算符(标签查询),支持 '='、'==' 和 '!='。 (例如 -l key1=value1,key2=value2)。匹配的对象必须满足所有指定的标签约束。

--template string

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

--timeout duration

放弃删除之前等待的时间长度,为 0 表示根据对象的大小确定超时。

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

必须是以下选项之一:strict(或 true)、warn、ignore(或 false)。 "true" 或 "strict" 将使用模式定义来验证输入,如果无效,则请求失败。"false" 或 "ignore" 将不会执行任何模式定义检查,而是静默删除所有未知或重复的字段。

--wait

如果为真,则等待资源消失后再返回。此参数会等待终结器被清空。

ccictl选项亦可在子命令中生效,列表如下:

父命令ccictl选项列表