ENTRYPOINT
是 Docker 最重要的配置选项之一。它位于 Dockerfile 中,允许你指定容器的默认行为。这一功能使得 ENTRYPOINT
对于在运行时自动执行容器的行为非常有帮助。
本文将深入探讨 ENTRYPOINT
在 Docker 中的使用,包括它的工作原理、为什么它必不可少以及如何正确配置它。
Docker ENTRYPOINT 解读
ENTRYPOINT
是 Docker 容器运行过程的起点。创建 Docker 镜像并将其实例化为容器时,默认情况下会执行 ENTRYPOINT 命令。
ENTRYPOINT
允许你设置容器的主要用途,如运行网络服务器、数据库或应用程序。它还允许你在运行时传递参数,自定义容器的行为。
ENTRYPOINT 的语法和用法
在 Dockerfile 中定义 ENTRYPOINT
的两种语法选项是 shell 形式和执行形式。这两种方法都需要在 Dockerfile 中插入一行。由于 ENTRYPOINT
配置并不直接影响构建过程,因此你可以把它放在文件的任何地方。不过,大多数程序员倾向于将 ENTRYPOINT
命令放在最后。
Shell 表单语法
当 ENTRYPOINT
使用 shell 形式运行时,它会调用命令 shell 进行处理。这种方法包括环境变量替换,但阻止了在执行形式中追加参数的功能:
ENTRYPOINT command param1 param2
这里,command
是在容器启动时执行的主要命令。 param1
和 param2
是该命令的参数。
Exec 表单语法
Exec 表单不会调用命令 shell。相反,它会直接执行指定的命令和参数。这种方法允许你通过 CMD
或运行时命令行添加参数:
ENTRYPOINT ["executable", "param1", "param2"]
这里,executable
是主命令, param1
和 param2
是可执行文件的参数。
动作中的 ENTRYPOINT
让我们为 Dockerfile 组建一个简单的 ENTRYPOINT
命令,看看它是如何工作的。在不启动容器的情况下无法测试它,因为它的指令是在运行时而不是在构建时处理的。
下面是一个使用执行形式的示例:
ENTRYPOINT ["python", "app.py"]
当容器启动时,它会启动 Python 解释器并执行 app.py 脚本,作为容器的默认行为。
要使用 shell 表单重复此示例,需要稍作改动:
ENTRYPOINT python app.py
本例从 shell 命令启动 Python 解释器,而不是直接运行它。
使用 CMD 的 ENTRYPOINT
CMD
是一条 Dockerfile 指令,为正在执行的容器提供默认参数。这些参数可以是可执行命令的形式,也可以作为 ENTRYPOINT 指令的附加参数。启动容器时,你可以通过向 docker run
指令提供参数来覆盖这些参数。
与 ENTRYPOINT
一样,你也可以以 exec 或 shell 的形式编写 CMD
。主要区别在于, CMD
设置了默认命令或参数,你可以在命令行中覆盖它们。而 ENTRYPOINT
会将容器配置为可执行文件运行,这意味着你无法在命令行中覆盖命令。
你可以使用 CMD
扩展 ENTRYPOINT
的功能,让你的映像具有更大的灵活性。将二者结合起来,你就可以自定义映像的行为,并将 CMD
值作为 ENTRYPOINT
指令的默认参数。通过这种方法,您可以通过 ENTRYPOINT
设置默认命令,并通过 CMD
设置默认参数。
与单独使用 ENTRYPOINT
不同,这种方法允许你覆盖在 docker run
指令时传递的参数。
为了使上述示例更加灵活,你可以加入 CMD
命令:
ENTRYPOINT ["python", "app.py"] CMD ["--help"]
在本例中,启动 Docker 容器时不提供任何命令行参数,这意味着 python app.py --help
将默认执行。不过,在启动容器时提供参数(如 )将取代默认的
CMD
参数,从而执行 python app.py--version
。这种方法让你在运行容器时有更大的灵活性。
Docker 中的 ENTRYPOINT 使用案例
ENTRYPOINT
最常见的用途是为特定应用程序或服务设置镜像。例如,如果创建运行 Python 应用程序的映像,就可以使用 ENTRYPOINT
来指定运行 Python 解释器。
在为持续集成和持续部署(CI/CD)管道构建 Docker 映像时,也可以使用 ENTRYPOINT
。您可以使用这些映像来封装每个阶段所需的环境,以确保一致性。例如,你可以创建一个将 ENTRYPOINT
设置为测试脚本的 Docker 镜像。该镜像每次运行时都会自动执行这些测试,从而提供一致、可重复的测试环境。
ENTRYPOINT
对于调试容器化应用程序也很有用。通过使用 ENTRYPOINT
启动 shell 会话,你可以与容器内的应用环境进行交互。这些交互包括执行命令、查看文件和检查应用程序的状态。一旦问题得到解决,就可以使用相应的 ENTRYPOINT
重建 Docker 镜像来运行应用程序。
如何覆盖 ENTRYPOINT
为了增加灵活性,我们可以在运行时覆盖 Docker 镜像的 ENTRYPOINT
。你可以在 docker run
命令中的映像名称后面提供一个命令来实现这一点。
例如,如果你的映像的 ENTRYPOINT
是 Python 脚本,但你想在容器内打开一个 shell,你可以运行下面的命令:
该脚本会覆盖应用程序的默认 ENTRYPOINT
,并启动一个 bash shell。
同样,要运行不同的 Python 脚本,也可以提供该脚本作为命令。这种方法让你可以灵活地使用与 Dockerfile 的 ENTRYPOINT
中最初描述的参数不同的参数来运行容器。
在 Docker 中使用 ENTRYPOINT 的最佳实践
因为 ENTRYPOINT
是 Docker 的关键命令,所以必须遵循这些最佳实践来最大限度地利用它。
让容器专注于单一责任
ENTRYPOINT
指定了 Docker 容器的职责。与微服务一样,每个容器应专注于单一职责、服务或应用程序的一部分。这种方法提高了应用程序的模块性和可扩展性,使其更易于开发、测试和维护。
确保 ENTRYPOINT 脚本可执行且格式正确
使 ENTRYPOINT
脚本可执行且格式正确,可以防止出现语法和权限错误等问题。
要确保 ENTRYPOINT
脚本可执行,可以使用以下 RUN chmod +x
指令:
COPY entrypoint.sh /entrypoint.sh RUN chmod +x /entrypoint.sh ENTRYPOINT ["/entrypoint.sh"]
本例将 entrypoint.sh 脚本复制到容器中,并使用 RUN chmod +x
指令使其可执行。然后定义 ENTRYPOINT
以使用 entrypoint.sh 脚本。
你还可以使用 ShellCheck 这样的内部程序来检查脚本的语法和样式,以确保格式正确。
避免在 ENTRYPOINT 脚本中硬编码值
使用环境变量或命令行参数而不是硬编码可以让你的脚本更灵活。它还能让你在容器外部配置文件路径。
例如,在 ENTRYPOINT
脚本中,你可以这样来代替硬编码文件路径:
#!/bin/bash echo "Starting my application..." ./my-app -f /path/to/my/file.txt
您可以使用这样的变量:
#!/bin/bash echo "Starting my application..." ./my-app -f "${MY_FILE}"
使用变量能让你的镜像具有更强的即时定制能力,让你在不重写 Dockerfile 的情况下做更多事情。
小结
ENTRYPOINT
是配置 Docker 容器的重要工具。它设置了容器从映像启动时执行的默认命令,定义了容器的主要功能。你可以使用 ENTRYPOINT
运行特定的应用程序,在 CI/CD 管道中提供帮助,或与 CMD
结合使用以获得更灵活的容器行为。
原文地址:https://www.wbolt.com/dockerfile-entrypoint.html