Procfile 和 foreman

建议学时：4 小时。

Heroku 应用程序包含一个 Procfile，它指定应用程序在启动时执行的命令。你可以使用 Procfile 来声明各种进程类型，包括：

应用的网络服务器
多种类型的工作进程
单例进程，例如时钟
在部署新版本之前运行的任务

Procfile 命名和位置

Procfile 始终是一个 Procfile 没有文件扩展名的简单文本文件。
Procfile 必须位于应用程序的根目录中。如果放在其他任何地方，它就不起作用。

Procfile 格式

Procfile 在单独的行上声明其进程类型，每行都具有以下格式：

<process type>: <command>

是你的命令的字母数字名称，例如 web, worker, urgentworker, clock，等等。

表示每个程序在启动时应该执行的命令，例如 rake jobs:work.

Web 进程

web: bundle exec rails server -p $PORT

对于许多简单的应用程序，一个 web 进程类型就足够了。对于更复杂的应用程序，并坚持更明确地声明应用程序所需的运行时进程的推荐方法，你可能希望定义其他进程类型。例如，Rails 应用程序提供了这种额外的进程类型：

worker:  bundle exec rake jobs:work

在 Heroku 之外使用 Procfile

如果你有一个单独的 Rails 应用程序，也想使用 Procfile 的形式管理进程，可以使用 foreman。

参考文档

https://devcenter.heroku.com/articles/procfile
https://help.aliyun.com/document_detail/116527.html

foreman: 管理基于 Procfile 的应用程序

foreman 是一个基于 Procfile 的应用程序，不要将其包含 foreman 在你的 Gemfile 中。Foreman 不是库，不应影响应用程序的依赖关系树。仅仅为了满足项目的依赖矩阵而更新工头的依赖项之一是有问题的，因为这反过来可能会破坏正在做同样事情的旧应用程序。

现在的 Rails 网络应用程序运行起来变得越来越复杂。Rails 应用程序不再包含单个 Web 进程。为了不让让应用程序及其所有部分运行变得更加复杂，我们将使用 foreman 来管理这些进程。可以使用可以使用 Procfile：

Procfile

web: bin/rails server -p 3000
js: yarn build --watch

执行

foreman start -f Procfile.dev

或者下面的脚本
bin/dev

#!/usr/bin/env bashif ! command -v foreman &> /dev/null
thenecho "Installing foreman..."gem install foreman
fiforeman start -f Procfile.dev

foreman 将启动与你的应用程序关联的所有进程，并显示 stdout 每个 stderr 进程。流程按类型进行颜色编码，以便于阅读。$PORT 将由 foreman 自动分配并提供给每个底层流程。

并发

Foreman 支持运行一种以上的每种进程类型。

# run 1 of each process type, and 2 workers
$ foreman start -c worker=2# do not run a clock process
$ foreman start -c clock=0

端口分配

Foreman 默认从 5000 开始端口分配，并按照你在 Procfile 中 Worker 和进程类型的顺序分配。

对于本文 Procfile 顶部使用的，web.1 将被分配端口 5000，worker.1 将被分配 5100，clock.1 将被分配 5200。如果你运行 2 个 Web 进程，web.2 将被分配 5001。

实践

rails new app -j esbuild -T

Procfile.dev

web: bin/rails server -p 3000
js: yarn build --watch

我们也可以加入其他进程，例如我们使用 docker-compose 启动一个 redis 服务

docker-compose.yml

version: '3'
services:redis:image: redis:5ports:- 6379:6379

继续调整 Procfile.dev

docker: docker-compose up
web: bin/rails server -p 3000
js: yarn build --watch