壳指令

SHELL ["executable", "parameters"]

SHELL 指令允许覆盖用于 shell 形式命令的默认 shell。Linux 上的默认 shell 是 ["/bin/sh", "-c"],而 Windows 上的默认 shell 是 ["cmd", "/S", "/C"]。必须在 Dockerfile 中以 JSON 格式编写 SHELL 指令。

SHELL 指令在 Windows 上特别有用,其中有两个常用且完全不同的本机 shell:cmd 和 powershell,以及包括 sh 的备用 shell。

SHELL 指令可以多次出现。每个 SHELL 指令都会覆盖所有先前的 SHELL 指令,并影响所有后续指令。例如:

FROM windowsservercore

# Executed as cmd /S /C echo default
RUN echo default

# Executed as cmd /S /C powershell -command Write-Host default
RUN powershell -command Write-Host default

# Executed as powershell -command Write-Host hello
SHELL ["powershell", "-command"]
RUN Write-Host hello

# Executed as cmd /S /C echo hello
SHELL ["cmd", "/S"", "/C"]
RUN echo hello

SHELL 指令的 shell 形式用于 Dockerfile 时,以下说明会受到影响:RUNCMDENTRYPOINT

以下示例是在 Windows 上找到的常见模式,可以使用 SHELL 指令简化:

...
RUN powershell -command Execute-MyCmdlet -param1 "c:\foo.txt"
...

docker 调用的命令将是:

cmd /S /C powershell -command Execute-MyCmdlet -param1 "c:\foo.txt"

由于两个原因,这是低效的。首先,调用一个不必要的 cmd.exe 命令处理器(也就是 shell)。其次,shell 形式的每个 RUN 指令都需要一个额外的 powershell -command 前缀命令。

为了提高效率,可以采用两种机制中的一种。一种是使用 RUN 命令的 JSON 形式,例如:

...
RUN ["powershell", "-command", "Execute-MyCmdlet", "-param1 \"c:\\foo.txt\""]
...

虽然 JSON 表单是明确的,并且不使用不必要的 cmd.exe,但它确实需要通过双引号和转义更加详细。替代机制是使用 SHELL 指令和 shell 表单,为 Windows 用户创建更自然的语法,特别是与 escape parser 指令结合使用时:

# escape=`

FROM windowsservercore
SHELL ["powershell","-command"]
RUN New-Item -ItemType Directory C:\Example
ADD Execute-MyCmdlet.ps1 c:\example\
RUN c:\example\Execute-MyCmdlet -sample 'hello world'

导致:

PS E:\docker\build\shell> docker build -t shell .
Sending build context to Docker daemon 3.584 kB
Step 1 : FROM windowsservercore
 ---> 5bc36a335344
Step 2 : SHELL powershell -command
 ---> Running in 87d7a64c9751
 ---> 4327358436c1
Removing intermediate container 87d7a64c9751
Step 3 : RUN New-Item -ItemType Directory C:\Example
 ---> Running in 3e6ba16b8df9

Directory: C:\

Mode                LastWriteTime         Length Name
----                -------------         ------ ----
d-----         6/2/2016   2:59 PM                Example

 ---> 1f1dfdcec085
Removing intermediate container 3e6ba16b8df9
Step 4 : ADD Execute-MyCmdlet.ps1 c:\example\
 ---> 6770b4c17f29
Removing intermediate container b139e34291dc
Step 5 : RUN c:\example\Execute-MyCmdlet -sample 'hello world'
 ---> Running in abdcf50dfd1f
Hello from Execute-MyCmdlet.ps1 - passed hello world
 ---> ba0e25255fda
Removing intermediate container abdcf50dfd1f
Successfully built ba0e25255fda
PS E:\docker\build\shell>

SHELL 指令也可用于修改 shell 的运行方式。例如,在 Windows 上使用 SHELL cmd /S /C /V:ON|OFF,可以修改延迟的环境变量扩展语义。

如果需要备用 shell,如 zsh,csh,tcsh 等,也可以在 Linux 上使用 SHELL 指令。

在 Docker 1.12 中添加了 SHELL 功能。