更新时间:2025-05-30 GMT+08:00

ccictl set image

操作背景

更新资源的现有容器镜像。

可能的资源包括(不区分大小写):

pod (po), deployment (deploy)

命令的格式如下:

ccictl set image (-f FILENAME | TYPE NAME) CONTAINER_NAME_1=CONTAINER_IMAGE_1 ... CONTAINER_NAME_N=CONTAINER_IMAGE_N

示例

# 将 Deployment 的 nginx 容器镜像设置为 “nginx:1.9.1”,并将其 busybox 容器镜像设置为 “busybox”
ccictl set image deployment/nginx busybox=busybox nginx=nginx:1.9.1

# 更新所有 Deployment 的 nginx 容器镜像为 “nginx:1.9.1”
ccictl set image deployments nginx=nginx:1.9.1 --all

# 更新 Deployment abc 的所有容器镜像为 "nginx:1.9.1"
ccictl set image deploy abc *=nginx:1.9.1

# 使用本地文件更新 nginx 容器镜像,并以 YAML 格式打印结果,但不向服务器发出请求
ccictl set image -f path/to/file.yaml nginx=nginx:1.9.1 --local -o yaml

选项

--all

如果为真,则选择指定资源类型的命名空间中的所有资源。

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

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

-f, --filename strings

文件名、目录或文件 URL 组成的列表,用于标识要更新环境的资源。

-h, --help

image 操作的帮助命令。

--local

如果为真,`set image` 将不会与 API 服务器通信,而是在本地运行。

-o, --output string

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

-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]。

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

父命令ccictl选项列表