镜像构建服务(ImageBuilder)指令集

镜像构建服务所支持的命令兼容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命令的详细说明,例如CMDENTRYPOINT命令的区别,请参见Dockerfile reference