全部产品

云服务器 ECS：镜像构建服务（ImageBuilder）指令集

更新时间：Dec 29, 2023

镜像构建服务所支持的命令兼容Dockerfile的一部分命令。如果您熟悉Dockerfile命令，即可快速上手使用镜像构建服务；如果您不熟悉Dockerfile命令，您可以通过本文了解镜像构建服务支持的命令。

镜像构建服务支持的命令如下表所示。

命令	命令格式或示例	说明
FROM	`FROM IMAGE:<镜像ID>` `FROM IMAGE_FAMILY:<镜像族系名称>`	指定源镜像的命令。在镜像组件中，不支持使用该命令。在镜像模板中，当您配置源镜像后，系统会自动生成对应的`FROM`命令。说明在镜像模板中，如果您手动设置了`FROM`命令，那么配置源镜像后系统自动生成的`FROM`命令会被覆盖。
COMPONENT	`COMPONENT ic-bp18hy47cqavewsb****`	指定镜像组件，支持指定系统组件或您创建的自定义组件。该命令仅适用于镜像模板，当您创建镜像模板时，可以使用该命令，以一个或多个镜像组件拼装的方式快速完成镜像模板的定义。
RESTART	`RESTART`	重启服务器的命令，该命令后不允许添加任何内容。
RUN	`RUN echo hello;\ echo world;`	镜像构建的命令。同一个命令允许设置多行，换行需要在前一行的末尾添加换行符（\）。
ENV	`ENV key value` `ENV key1="value1" key2="value2"`	系统变量配置的命令。命令以键值对的形式。说明使用`ENV key1="value1" key2="value2"`命令格式时，不能缺失双引号。
WORKDIR	`WORKDIR /<path>` `WORKDIR <path1>/<path2>`	设置工作目录的命令。
COPY	`COPY {网络文件地址} 本地目录` `COPY 本地文件路径本地目录`	复制文件的命令。说明网络文件统一使用`wget`下载，并且暂不支持`query string`，请确保中转实例可以访问公网。
USER	`USER <username>`	设置执行命令的用户的命令。说明变量`<username>`必须是系统中已存在的用户，否则执行命令将会报错。
LABEL	`LABEL user="username"\ date="2020-11-11" key="value"`	定义模板元信息的命令。同一个命令允许设置多行，换行需要在前一行的末尾添加换行符（\）。
CMD	`CMD ["executable","param1","param2"]` `CMD command param1 param2`	开机自启动的命令。
ENTRYPOINT	`ENTRYPOINT ["executable","param1","param2"]` `CMD command param1 param2`	开机自启动的命令。

相关文档

关于Dockerfile命令的详细说明，例如CMD与ENTRYPOINT命令的区别，请参见Dockerfile reference。