exec 与 entrypoint 使用脚本 | Mr.Cheng

> 本文由 [简悦 SimpRead](http://ksria.com/simpread/) 转码， 原文地址 [kinkinlu.com](https://kinkinlu.com/2019/05/02/exec%E4%B8%8Eentrypoint%E4%BD%BF%E7%94%A8%E8%84%9A%E6%9C%AC/)

发表于 2019-05-02 21:31:00 | 分类于 [Docker](https://kinkinlu.com/categories/Docker/)

现在很多有状态的官方镜像的 ENTRYPOINT 都是使用了一个脚本。例如 redis

```
COPY docker-entrypoint.sh /usr/local/bin/
ENTRYPOINT ["docker-entrypoint.sh"]

EXPOSE 6379
CMD ["redis-server"]
```

```
#!/bin/sh
set -e

# first arg is `-f` or `--some-option`
# or first arg is `something.conf`
if [ "${1#-}" != "$1" ] || [ "${1%.conf}" != "$1" ]; then
	set -- redis-server "$@"
fi

# allow the container to be started with `--user`
if [ "$1" = 'redis-server' -a "$(id -u)" = '0' ]; then
	find . \! -user redis -exec chown redis '{}' +
	exec gosu redis "$0" "$@"
fi

exec "$@"
```

最终运行的是 docker-entrypoint.sh redis-server

第一个 if 的逻辑是如果 docker run 选项 redis -x 或者–xx 或者 xxx.conf，就把脚本收到的 $@改编成 redis-server $@, 例如我们可同 docker run -d redis –port 7379 修改启动的容器里的 redis 端口。如果我们传入的 command 不是 - 开头的也不是. conf 结尾的字符，例如是 date，则会跑到最后的逻辑执行我们的 date 命令不会启动 redis-server

第二个 if 这里，如果满足第一个 if 或者直接默认的 cmd 下而且容器里用户 uid 是 0，则把属主不是 redis 的文件改成 redis 用户，然后切成 redis 用户去启动 redis-server。

我们可以看到 entrypoint 能在业务进程启动前做很多事情。而且优秀的镜像都离不开 entrypoint 脚本，能够根据用户传入的变量和 command 来切换启动的场景和配置。

前面说了，主进程一定要是业务进程，这里怎么是个脚本呢，那业务进程不就不是 pid 为 1 了吗？ 这里用了 exec 来退位让贤，最终 redis-server 还是 pid 为 1 的。可以简单几个命令讲解下 exec 的作用。

写个 test.sh 脚本，在脚本里用 pstree -p，运行脚本 bash test.sh 查看进程层次

![](https://kinkinlu.com/images/pasted-13.png)

发现 pstree 是在我们脚本 bash(1998) 的子进程

然后在脚本最后面加一行 exec pstree -p 看看输出

![](https://kinkinlu.com/images/pasted-14.png)

我们发现 bash 进程运行的时候 pid 是 2022，然后第二个 pstree 上升到了 2022 这一层次了，假设 pid 为 a 的命令或者二进制 exec 执行了命令 b，那 b 就接替了 a 的 pid。如果说我们 entrypoint 或者 cmd 使用脚本，那么我们一定要在脚本最后启动业务进程的时候前面加个 exec 让脚本退位让贤。

最后环境变量写配置文件涉及到修改，还有一些判断是否初次启动的有下面一些工具或者套路。

*   xmlstarlet 处理 xml
*   pip 安装 shyaml 处理 yaml
*   jq 读取 json
*   nodejs 的 npm 安装 json 可以修改 json 文件
*   处理 excel 或者 csv 使用 in2csv，csvkit 提供了 in2csv，csvcut，csvjoin，csvgrep
*   touch -d “@0” 写在构建的最后一个 RUN 里把时间戳设置为 1970-1-1，然后用 stat 命令判断
*   if [“$(stat -c “%Y” “${CONF_INSTALL}/conf/server.xml”)” -eq “0” ]; then
*   另外 entrypoint 脚本 COPY 进去的时候注意可执行权限，如果 Windows 上传到 Linux 构建会因为 entrpoint 脚本没带权限无法运行