001-Dockerfile - FROM

语法

语法 1

FROM <image> [AS <name>]

语法 2

FROM <image>[:<tag>] [AS <name>]

语法 3

FROM <image>[@<digest>] [AS <name>]

作用

FROM 指令初始化新的构建阶段并为后续指令设置“基本镜像”。因此，有效的 Dockerfile 必须以 FROM 指令开头。镜像可以是任何有效镜像。

详细说明

• ARG 是唯一一个可能出现在 FROM 前边的指令，请参考：ARG 和 FROM 如何配合使用；；
• FROM 可以在单个 Dockerfile 镜像中多次出现以创建多个镜像，或者使用一个构建阶段作为另一个构建阶段的依赖项。只需在每条新 FROM 指令之前记下提交输出的最后一个镜像ID。每条 FROM 指令都清除先前的指令创建的任何状态；
• 可选的名称可以通过添加给与一个新的构建阶段 AS name 的 FROM 指令。该名称可用于后续 FROM 和 COPY --from=<name|index> 指示，以引用此阶段构建的镜像；
• 该 tag 或 digest 值是可选的。如果省略其中任何一个，则构建器默认采用 latest 标记。如果找不到 tag 值，构建器将返回错误。

应用示例

示例 1

FROM centos:7

示例 2

ARG CODE_VERSION=latest
FROM base:${CODE_VERSION}