echo_supervisord_conf - 云端在线

程序：

您的姓名

echo_supervisord_conf - 主管配置文档

Supervisor 是一个客户端/服务器系统，允许其用户监视和控制一个数字
类 UNIX 操作系统上的进程。

它与launchd、daemontools 和runit 等程序具有相同的目标。 不像
其中一些程序，并不意味着作为替代来运行 初始化 作为“进程ID
1"。相反，它旨在用于控制与项目或项目相关的过程
客户，并且旨在在启动时像任何其他程序一样启动。

文档

创造 a 配置 文件
Supervisor安装完成后，运行 echo_supervisord_conf。 这会
将“示例”主管配置文件打印到终端的标准输出。

一旦你看到文件回显到你的终端，重新调用命令
echo_supervisord_conf > /etc/supervisord.conf. 如果您没有 root，这将不起作用
访问。

如果您没有 root 访问权限，或者您不想将 管理员配置文件 文件
/etc/supervisord.conf`，你可以把它放在当前目录（echo_supervisord_conf >
管理员配置文件) 并开始 主管 与 -c 标志以指定
配置文件位置。

例如， 主管 -c 管理员配置文件。 使用 -c 标志实际上是多余的
这种情况，因为 主管 在当前目录中搜索一个 管理员配置文件
在它搜索文件的任何其他位置之前，但它会起作用。

一旦在文件系统上有了配置文件，就可以开始将其修改为
喜欢。

配置 文件
Supervisor 配置文件通常命名为 管理员配置文件. 它被使用
都 主管 和 监督者. 如果任一应用程序在没有 -c
选项（用于告诉应用程序配置文件名的选项
显式），应用程序将查找名为 管理员配置文件 字幕可视电话用于
以下位置，按指定顺序。 它将使用它找到的第一个文件。

1. $CWD/supervisord.conf

2. $CWD/etc/supervisord.conf

3. /etc/supervisord.conf

4. ../etc/supervisord.conf （相对于可执行文件）

5. ../supervisord.conf （相对于可执行文件）

注意:
一些发行版已经将 Supervisor 与他们自己的定制打包在一起。 这些
Supervisor 的修改版本可能会从其他位置加载配置文件
比这里描述的那些。 值得注意的是，已经发现 Ubuntu 软件包使用
/etc/supervisor/supervisord.conf.

文件 格式
管理员配置文件 是一个 Windows-INI-style (Python ConfigParser) 文件。 它有部分（每个
表示为 [标题]) 和部分中的键/值对。 各部分及其
允许值如下所述。

环境 变量
环境中存在的环境变量 主管 is
可以使用 Python 字符串表达式语法在配置文件中使用开始
%(ENV_X)s:

[程序：示例]
命令=/usr/bin/example --loglevel=%(ENV_LOGLEVEL)s

在上面的例子中，表达式 %(ENV_LOGLEVEL)s 将扩大到价值
环境变量 日志级别.

注意:
在 Supervisor 3.2 及更高版本中， %(ENV_X)s 所有选项都支持表达式。 在
以前的版本，一些选项支持它们，但大多数不支持。 请参阅文档
下面的每个选项。

[unix_http_服务器] 部分 个人设置
管理员配置文件 文件包含一个名为的部分 [unix_http_服务器] 在哪
侦听 UNIX 域套接字的 HTTP 服务器的配置参数应该是
插入。 如果配置文件没有 [unix_http_服务器] 部分，一个 UNIX 域
socket HTTP 服务器将不会启动。 允许的配置值如下
如下。

[unix_http_服务器] 部分 价值观
文件
UNIX 域套接字的路径（例如 /tmp/supervisord.sock) 主管将
侦听 HTTP/XML-RPC 请求。 监督者 使用 XML-RPC 与
主管 在这个港口。 此选项可以包括值 %(这里)s, 展开
到目录 主管 找到了配置文件。

默认： 没有。

其他要求：没有。

介绍：3.0

CHMOD
将 UNIX 域套接字的 UNIX 权限模式位更改为此值
启动。

默认: 0700

其他要求：没有。

介绍：3.0

乔恩
将套接字文件的用户和组更改为此值。 可能是 UNIX 用户名
（例如 圣油) 或以冒号分隔的 UNIX 用户名和组（例如 基督：轮子).

默认：使用启动supervisord的用户的用户名和组。

其他要求：没有。

介绍：3.0

用户名
对此 HTTP 服务器进行身份验证所需的用户名。

默认: 不需要用户名。

其他要求：没有。

介绍：3.0

密码
验证此 HTTP 服务器所需的密码。 这可以是明文
密码，或者如果以字符串为前缀，则可以指定为 SHA-1 哈希 {上海}。 对于
例， {SHA}82ab876d1387bfafe46cc1c8a2ef074eae50cb1d 是 SHA 存储的版本
密码“thepassword”。

请注意，散列密码必须采用十六进制格式。

默认: 不需要密码。

其他要求：没有。

介绍：3.0

[unix_http_服务器] 部分 例如：
[unix_http_服务器]
文件 = /tmp/supervisor.sock
修改=0777
chown = 没有人：nogroup
用户名 = 用户
密码= 123

[inet_http_服务器] 部分 个人设置
管理员配置文件 文件包含一个名为的部分 [inet_http_服务器] 在哪
侦听 TCP（互联网）套接字的 HTTP 服务器的配置参数应该
被插入。 如果配置文件没有 [inet_http_服务器] 部分，一个 inet HTTP
服务器将不会启动。 允许的配置值如下。

[inet_http_服务器] 部分 价值观
端口
TCP 主机：端口值或（例如 127.0.0.1:9001) 主管将听取哪个
HTTP/XML-RPC 请求。 监督者 将使用 XML-RPC 与 主管
在这个港口。 要侦听机器中的所有接口，请使用 ：9001 or *：9001.

默认: 没有默认。

其他要求：是的。

介绍：3.0

用户名
对此 HTTP 服务器进行身份验证所需的用户名。

默认: 不需要用户名。

其他要求：没有。

介绍：3.0

密码
验证此 HTTP 服务器所需的密码。 这可以是明文
密码，或者如果以字符串为前缀，则可以指定为 SHA-1 哈希 {上海}。 对于
例， {SHA}82ab876d1387bfafe46cc1c8a2ef074eae50cb1d 是 SHA 存储的版本
密码“thepassword”。

请注意，散列密码必须采用十六进制格式。

默认: 不需要密码。

其他要求：没有。

介绍：3.0

[inet_http_服务器] 部分 例如：
[inet_http_服务器]
端口 = 127.0.0.1:9001
用户名 = 用户
密码= 123

[主管] 部分 个人设置
管理员配置文件 文件包含一个名为的部分 [主管] 其中全局设置
相关的 主管 应该插入进程。 这些如下。

[主管] 部分 价值观
日志文件
supervisord 进程的活动日志的路径。 此选项可以包括
折扣值 %(这里)s, 展开到 supervisord 配置所在的目录
找到了文件。

默认: $CWD/supervisord.log

其他要求：没有。

介绍：3.0

日志文件_maxbytes
活动日志文件在执行之前可能消耗的最大字节数
旋转（可以在值中使用“KB”、“MB”和“GB”等后缀乘数）。 放
将此值设置为 0 表示日志大小不受限制。

默认：50MB

其他要求：没有。

介绍：3.0

日志文件_备份
由于活动日志文件轮换而保留的备份数量。 如果设置
到 0，将不保留任何备份。

默认：10

其他要求：没有。

介绍：3.0

日志级别
日志级别，指示写入 supervisord 活动日志的内容。 之一
危急, 错误, 警告, info, 调试, 追踪或 废话. 请注意，在日志级别 调试,
supervisord 日志文件将记录其子进程的 stderr/stdout 输出
以及有关进程状态更改的扩展信息信息，这对于调试
未正常启动的进程。 另请参阅：activity_log_levels。

默认：信息

其他要求：没有。

介绍：3.0

pid文件
supervisord 保存其 pid 文件的位置。 此选项可以包括
折扣值 %(这里)s, 展开到 supervisord 配置所在的目录
找到了文件。

默认: $CWD/supervisord.pid

其他要求：没有。

介绍：3.0

遮罩
supervisord 进程的 umask。

默认: 022

其他要求：没有。

介绍：3.0

节点守护进程
如果为 true，supervisord 将在前台启动而不是守护进程。

默认： 错误的

其他要求：没有。

介绍：3.0

小伙伴们
在 supervisord 之前必须可用的最小文件描述符数
成功启动。 将调用 setrlimit 以尝试提高软和
需要满足的 supervisord 进程的硬限制 小伙伴们. 硬限制可能只是
如果 supervisord 以 root 身份运行，则引发。 supervisord 自由地使用文件描述符，并且
当无法从操作系统获取时将进入故障模式，因此很有用
能够指定最小值以确保在执行期间不会用完它们。
此选项在 Solaris 上特别有用，它的每进程 fd 限制较低
默认。

默认：1024

其他要求：没有。

介绍：3.0

小程序
在 supervisord 之前必须可用的进程描述符的最小数量
将成功启动。 将调用 setrlimit 以尝试提高软
和监督过程的硬限制，以满足 小程序. 硬限制可能
仅当以 root 身份运行 supervisord 时才会引发。 supervisord 将进入故障模式
当操作系统用完进程描述符时，确保足够的进程描述符很有用
进程描述符可用于 主管 启动。

默认：200

其他要求：没有。

介绍：3.0

不清理
防止主管清除任何现有的 AUTO 启动时的子日志文件。
用于调试。

默认： 错误的

其他要求：没有。

介绍：3.0

子目录
用于的目录 AUTO 子日志文件。 此选项可以包括值
%(这里)s, 展开到目录 主管 配置文件
被找到。

默认: Python 的价值 临时文件.get_tempdir()

其他要求：没有。

介绍：3.0

用户
指导 主管 在执行任何操作之前将用户切换到此 UNIX 用户帐户
有意义的处理。 用户只能在以下情况下切换 主管 开始作为
根用户。 如果 主管 不能切换用户，它仍然会继续，但会写一个
日志消息在 危急 级别说它不能放弃特权。

默认: 不要切换用户

其他要求：没有。

介绍：3.0

目录
什么时候 主管 守护进程，切换到这个目录。 此选项可以包括
折扣值 %(这里)s, 展开到目录 主管 配置
找到了文件。

默认: 不要光盘

其他要求：没有。

介绍：3.0

条带ANSI
从子日志文件中去除所有 ANSI 转义序列。

默认： 错误的

其他要求：没有。

介绍：3.0

环境
表单中的键/值对列表 KEY="val",KEY2="val2" 将被放置在
主管 进程'环境（以及其所有子进程的结果）
环境）。 此选项可以包括值 %(这里)s, 扩展到
在其中找到 supervisord 配置文件的目录。 值包含
应引用非字母数字字符（例如 KEY="val:123",KEY2="val,456").
否则，引用值是可选的，但建议使用。 逃避百分比
字符，只需使用两个。 （例如 URI="/first%%20name") 备注 子流程将
继承用于启动的shell的环境变量 主管 除了
在这里和程序中被覆盖的 环境 选项。 看
子进程_环境。

默认: 没有值

其他要求：没有。

介绍：3.0

识别码
此监督进程的标识符字符串，由 RPC 接口使用。

默认： 导师

其他要求：没有。

介绍：3.0

[主管] 部分 例如：
[主管]
日志文件 = /tmp/supervisord.log
logfile_maxbytes = 50MB
日志文件备份=10
日志级别 = 信息
pidfile = /tmp/supervisord.pid
节点=假
最小fds = 1024
最小过程 = 200
掩码 = 022
用户 = 基督
标识符 = 主管
目录 = / tmp目录
nocleanup = 真
子日志目录 = / tmp目录
strip_ansi = 假
环境 = KEY1="value1",KEY2="value2"

[主管ctl] 部分 个人设置
配置文件可能包含以下设置 监督者 互动壳
程序。 下面列出了这些选项。

[主管ctl] 部分 价值观
服务器网址
用于访问 supervisord 服务器的 URL，例如
http://localhost：9001. 对于 UNIX 域套接字，请使用
unix:///absolute/path/to/file.sock.

默认: http://localhost：9001

其他要求：没有。

介绍：3.0

用户名
传递给 supervisord 服务器以用于身份验证的用户名。 这应该
与...相同 用户名 从端口或 UNIX 的 supervisord 服务器配置
您尝试访问的域套接字。

默认: 没有用户名

其他要求：没有。

介绍：3.0

密码
传递给 supervisord 服务器以用于身份验证的密码。 这应该
是明文版本 密码 来自 supervisord 服务器配置
您尝试访问的端口或 UNIX 域套接字。 此值不能作为
一个 SHA 哈希。 与此文件中指定的其他密码不同，它必须在
明文。

默认: 没有密码

其他要求：没有。

介绍：3.0

提示
用作 supervisorctl 提示的字符串。

默认: 监

其他要求：没有。

介绍：3.0

历史文件
用作的路径 的ReadLine 持久的历史文件。 如果您通过以下方式启用此功能
选择路径，您的 supervisorctl 命令将保存在文件中，您可以使用
readline（例如向上箭头）调用您在上次 supervisorctl 中执行的命令
会议。

默认： 无文件

其他要求：没有。

介绍：3.0a5

[主管ctl] 部分 例如：
[主管ctl]
serverurl = unix:///tmp/supervisor.sock
用户名 = 克里斯
密码= 123
提示 = 我的主管

[程序：x] 部分 个人设置
配置文件必须包含一个或多个 程序 部分为了监督
知道它应该启动和控制哪些程序。 标头值是复合值。
它是“程序”一词，后跟冒号，然后是程序名称。 一个标题
价值 [程序：foo] 描述了一个名为“foo”的程序。 名称已使用
在控制由此创建的进程的客户端应用程序中
配置。 创建一个错误 程序 没有名称的部分。 这
name 不得包含冒号字符或括号字符。 名字的价值是
用作值 %(程序名)s 其他值中的字符串表达式扩展
在指定的地方。

注意:
A [程序：x] 部分实际上代表了主管的“同构进程组”
（从 3.0 开始）。 组的成员由以下组合定义 进程数
和 进程名称 配置中的参数。 默认情况下，如果 numprocs 和
process_name 与其默认值保持不变，组由
[程序：x] 将被命名 x 并将有一个名为的单个进程 x 在里面。 这
提供了与旧版主管版本的少量向后兼容性，这确实
不要将程序部分视为同构的过程组定义。

但例如，如果你有一个 [程序：foo] 部分与 进程数 3和
进程名称 表达 %(程序名称)s_%(进程编号)02d，“foo”组将
包含三个进程，命名为 foo_00, foo_01及 foo_02。这使得可以
使用单个启动许多非常相似的进程 [程序：x] 部分。 全部
日志文件名、所有环境字符串和程序命令也可以包含
类似的 Python 字符串表达式，将稍微不同的参数传递给每个
的过程。

[程序：x] 部分 价值观
命令
该程序启动时将运行的命令。 命令可以是
绝对的（例如 /路径/到/程序名) 或亲属 (例如 程序名）。 如果是
相对，主管的环境 $路径 将搜索可执行文件。
程序可以接受参数，例如 /路径/到/程序 FOO 酒吧. 命令行可以使用
双引号将带有空格的参数分组以传递给程序，例如
/路径/到/程序/名称 -p “富 酒吧”. 请注意，值 命令 可能包括 Python
字符串表达式，例如 /路径/到/程序名 --端口=80%(进程号)02d 可能会扩大
至 /路径/到/程序名 --端口=8000 在运行时。 计算字符串表达式
针对包含键的字典 团队名字, 主机节点名, 进程编号,
程序名, 点击此处 （supervisord 配置文件的目录），以及所有
supervisord 的环境变量前缀为 环境_. 受控程序应该
他们自己不是守护进程，因为 supervisord 认为它负责守护它的
子进程（参见 nondaemonizing_of_subprocesses）。

默认: 没有默认。

其他要求：是的。

介绍：3.0

进程名称
一个 Python 字符串表达式，用于为此编写主管进程名称
过程。 你通常不需要担心设置这个，除非你改变
进程数. 字符串表达式根据包含的字典进行评估
团队名字, 主机节点名, 进程编号, 程序名及 点击此处 （目录
监督配置文件）。

默认: %(程序名)s

其他要求：没有。

介绍：3.0

进程数
Supervisor 将启动与 numprocs 命名的该程序的多个实例。 笔记
如果 numprocs > 1，则 进程名称 表达式必须包括 %(process_num)s （或任何
其他有效的 Python 字符串表达式，包括 进程编号) 之内。

默认：1

其他要求：没有。

介绍：3.0

numprocs_start
一个整数偏移量，用于计算 进程数 开始。

默认：0

其他要求：没有。

介绍：3.0

优先
程序在启动和关闭顺序中的相对优先级。 降低
优先级表示在启动时最先启动并最后关闭的程序
聚合命令用于各种客户端（例如“全部启动”/“全部停止”）。 更高
优先级表示最后启动和最先关闭的程序。

默认：999

其他要求：没有。

介绍：3.0

自动开启
如果为 true，则该程序将在启动 supervisord 时自动启动。

默认： 真的

其他要求：没有。

介绍：3.0

启动秒数
程序启动后需要保持运行的总秒数
认为启动成功（将过程从 开始 国家对
跑步 状态）。 设置 0 表明该程序不需要保持运行任何
特定的时间。

注意:
即使进程以“预期的”退出代码退出（请参阅 退出代码）， 开始
如果进程退出的速度比 启动秒数.

默认：1

其他要求：没有。

介绍：3.0

开始重试
连续失败尝试的次数 主管 尝试时将允许
在放弃之前启动程序并将进程放入 致命 状态。 看
process_states 用于解释 致命 州。

默认：3

其他要求：没有。

介绍：3.0

自动重启
指定是否 主管 如果进程退出时应自动重新启动进程
，在 跑步 状态。 可能是其中之一 false, 意外或 true。 如果 false，过程
不会自动重启。 如果 意外, 进程将在
程序退出时的退出代码不是与此关联的退出代码之一
进程的配置（见 退出代码）。 如果 true，该过程将无条件
退出时重新启动，而不考虑其退出代码。

注意:
自动重启 控制是否 主管 如果程序退出，将自动重新启动程序
成功启动后（该过程在 跑步 状态）。

主管 进程启动时有不同的重启机制
（该过程在 开始 状态）。 进程启动期间的重试是
受控制于 启动秒数 和 开始重试.

默认: 出乎意料

其他要求：没有。

介绍：3.0

退出代码
此程序的“预期”退出代码列表 自动重启。 如果
自动重启 参数设置为 意外, 并且进程以任何其他方式退出
由于主管停止请求， 主管 将重新启动该过程，如果
使用此列表中未定义的退出代码退出。

默认：0,2

其他要求：没有。

介绍：3.0

停止信号
请求停止时用于终止程序的信号。 这可以是任何一个 TERM，
HUP、INT、QUIT、KILL、USR1 或 USR2。

默认： 学期

其他要求：没有。

介绍：3.0

停止等待秒
等待操作系统返回 SIGCHILD 的秒数 主管 后
程序已发送停止信号。 如果此秒数之前经过
主管 从进程中收到一个 SIGCHILD， 主管 会试图杀死它
最后一个 SIGKILL。

默认：10

其他要求：没有。

介绍：3.0

停止小组
如果为真，该标志会导致主管向整个进程组发送停止信号
并暗示 杀戮组 是真的。 这对程序很有用，例如调试中的 Flask
模式，不会将停止信号传播给他们的孩子，让他们成为孤儿。

默认： 错误的

其他要求：没有。

介绍：3.0b1

杀戮组
如果为真，当诉诸于向程序发送 SIGKILL 以终止它时，将其发送给它的
相反，整个过程组，也照顾它的孩子，有用，例如
使用 Python 程序 多处理.

默认： 错误的

其他要求：没有。

介绍：3.0a11

用户
指导 主管 使用此 UNIX 用户帐户作为运行
程序。 用户只能在以下情况下切换 主管 以 root 用户身份运行。 如果
主管 无法切换到指定用户，程序将不会启动。

注意:
用户将被更改使用 Setuid 只要。 这不会启动登录 shell 和
不会改变环境变量，如 USER or 首页。 看
subprocess_environment 了解详情。

默认: 不要切换用户

其他要求：没有。

介绍：3.0

重定向标准错误
如果为 true，则导致进程的 stderr 输出被发送回 主管 在其标准输出上
文件描述符（在 UNIX shell 术语中，这相当于执行 /该程序
2>＆1).

注意:
不设置 重定向标准错误=真 的 [事件监听器：x] 部分。 事件监听器
使用 标准输出 和 标准输入 沟通 主管。 如果 斯特德 被重定向，
来自的输出 斯特德 会干扰事件监听器协议。

默认： 错误的

其他要求：没有。

介绍: 3.0, 替换 2.0 日志标准输出 和 日志标准错误

标准输出日志文件
将进程 stdout 输出放在此文件中（如果 redirect_stderr 为真，也将
此文件中的 stderr 输出）。 如果 标准输出日志文件 未设置或设置为 AUTO， 导师
将自动选择文件位置。 如果这设置为 没有, 主管将
不创建日志文件。 AUTO 日志文件及其备份将在以下情况下被删除 主管
重新启动。 这 标准输出日志文件 value 可以包含 Python 字符串表达式
针对包含键的字典进行评估 团队名字, 主机节点名,
进程编号, 程序名及 点击此处 （supervisord 配置文件的目录）。

注意:
两个进程不可能共享一个日志文件（标准输出日志文件)
当旋转 (stdout_logfile_maxbytes) 已启用。 这将导致文件
被损坏。

默认: AUTO

其他要求：没有。

介绍: 3.0, 替换 2.0 日志文件

stdout_logfile_maxbytes
可能消耗的最大字节数 标准输出日志文件 在旋转之前
（值中可以使用“KB”、“MB”和“GB”等后缀乘数）。 设置这个
值为 0 表示日志大小不受限制。

默认：50MB

其他要求：没有。

介绍: 3.0, 替换 2.0 日志文件_maxbytes

标准输出日志文件备份
的数量 标准输出日志文件 由进程标准输出日志产生的备份
文件轮换。 如果设置为 0，则不会保留任何备份。

默认：10

其他要求：没有。

介绍: 3.0, 替换 2.0 日志文件_备份

标准输出捕获最大字节数
当进程处于“stdout 捕获模式”时写入捕获 FIFO 的最大字节数
（见捕获模式）。 应该是一个整数（后缀乘数，如“KB”、“MB”和“GB”
可以在值中使用）。 如果此值为 0，则进程捕获模式将关闭。

默认：0

其他要求：没有。

介绍: 3.0, 替换 2.0 日志文件_备份

标准输出事件启用
如果为 true，则当进程写入其数据时将发出 PROCESS_LOG_STDOUT 事件
标准输出文件描述符。 仅当文件描述符不存在时才会发出事件
在接收数据时处于捕获模式（参见 capture_mode）。

默认：0

其他要求：没有。

介绍：3.0a7

标准错误日志文件
将进程 stderr 输出放在此文件中，除非 重定向标准错误 是真的。 接受
相同的值类型 标准输出日志文件 并且可能包含相同的 Python 字符串表达式。

注意:
两个进程不可能共享一个日志文件（标准错误日志文件)
当旋转 (标准错误日志文件最大字节数) 已启用。 这将导致文件
被损坏。

默认: AUTO

其他要求：没有。

介绍：3.0

标准错误日志文件最大字节数
日志文件轮换前的最大字节数 标准错误日志文件. 接受
相同的值类型 stdout_logfile_maxbytes.

默认：50MB

其他要求：没有。

介绍：3.0

标准错误日志文件备份
由进程 stderr 日志文件轮换产生的要保留的备份数。
如果设置为 0，则不会保留任何备份。

默认：10

其他要求：没有。

介绍：3.0

stderr_capture_maxbytes
当进程处于“stderr 捕获模式”时写入捕获 FIFO 的最大字节数
（见捕获模式）。 应该是一个整数（后缀乘数，如“KB”、“MB”和“GB”
可以在值中使用）。 如果此值为 0，则进程捕获模式将关闭。

默认：0

其他要求：没有。

介绍：3.0

stderr_events_enabled
如果为 true，则当进程写入其数据时将发出 PROCESS_LOG_STDERR 事件
stderr 文件描述符。 仅当文件描述符不存在时才会发出事件
在接收数据时处于捕获模式（参见 capture_mode）。

默认： 错误的

其他要求：没有。

介绍：3.0a7

环境
表单中的键/值对列表 KEY="val",KEY2="val2" 将被放置在
子进程的环境。 环境字符串可能包含 Python 字符串
将针对包含的字典进行评估的表达式 团队名字,
主机节点名, 进程编号, 程序名及 点击此处 （主管目录
配置文件）。 应引用包含非字母数字字符的值（例如
KEY="val:123",KEY2="val,456"）。 否则，引用值是可选的，但
建议。 备注 子进程将继承环境变量
除了这里覆盖的那些之外，shell 用于启动“supervisord”。 看
子进程_环境。

默认: 没有额外的环境

其他要求：没有。

介绍：3.0

目录
表示目录的文件路径 主管 应该暂时chdir
在执行孩子之前。

默认: 没有 chdir（继承主管的）

其他要求：没有。

介绍：3.0

遮罩
表示进程的 umask 的八进制数（例如 002、022）。

默认: 没有特殊的 umask（继承主管的）

其他要求：没有。

介绍：3.0

服务器网址
在环境中传递给子流程进程的 URL 作为 SUPERVISOR_SERVER_URL
（见 主管.childutils) 允许子进程轻松地与
内部 HTTP 服务器。 如果提供，它应该具有相同的语法和结构
[主管ctl] 同名部分选项。 如果此设置为 AUTO，或未设置，
supervisor 将自动构建一个服务器 URL，优先考虑一个服务器
侦听 UNIX 域套接字而不是侦听 Internet 套接字的套接字。

默认： 汽车

其他要求：没有。

介绍：3.0

[程序：x] 部分 例如：
[程序：猫]
命令=/斌/猫
进程名=%(程序名)s
进程数=1
目录=/ tmp目录
掩码=022
优先级=999
自动启动=真
自动重启=意外
开始秒 = 10
开始重试=3
退出代码 = 0,2
停止信号=TERM
停止等待秒 = 10
停止组=假
杀戮组=假
用户=基督
重定向标准错误=假
stdout_logfile=/a/路径
stdout_logfile_maxbytes=1MB
标准输出日志文件备份=10
stdout_capture_maxbytes=1MB
stdout_events_enabled = false
stderr_logfile=/a/路径
stderr_logfile_maxbytes=1MB
stderr_logfile_backups=10
stderr_capture_maxbytes=1MB
stderr_events_enabled = false
环境=A="1",B="2"
服务器网址=自动

[包括] 部分 个人设置
管理员配置文件 文件可能包含一个名为 [包括]. 如果配置
文件包含一个 [包括] 部分，它必须包含一个名为“files”的键。 这
此键中的值指定要包含在
组态。

[包括] 部分 价值观
档
以空格分隔的文件 glob 序列。 每个文件 glob 可以是绝对的或相对的。
如果文件 glob 是相对的，则认为它相对于文件的位置
包含它的配置文件。 “glob”是一个文件模式，它匹配一个
根据 Unix shell 使用的规则指定模式。 没有波浪号扩展
完成了，但是 *, ?, 以及用表示的字符范围 [] 将正确匹配。
不支持来自包含文件的递归包含。

默认: 无默认值（必填）

其他要求：是的。

介绍：3.0

[包括] 部分 例如：
[包括]
文件 = /an/absolute/filename.conf /an/absolute/*.conf foo.conf config??.conf

[组：x] 部分 个人设置
将“同类”进程组（又名“程序”）组合成一个
“异类”进程组，因此它们可以作为一个单元从主管的
各种控制器接口。

要将程序放入一个组中以便将它们视为一个单元，请定义一个 [组：x] 部分
在您的配置文件中。 组头值是一个组合。 就是这个词
“组”，后跟冒号，然后是组名。 标头值 [组：foo]
描述一个名为“foo”的组。 该名称在客户端应用程序中使用
控制由于此配置而创建的进程。 它是一个
创建一个错误 组 没有名称的部分。 该名称不得包含
冒号字符或括号字符。

对于 [组：x]，必须有一个或多个 [程序：x] 您的其他部分
配置文件，并且组必须在配置文件中按名称引用它们 程式 计算值。

如果将“同类”进程组（由程序段表示）放入一个
“异类”组通过 [组：x] 部分的 程式 线，同质组
程序部分暗示在运行时不会存在于主管中。 相反，所有
属于每个同类组的进程将被放入
异类群。 例如，给定以下组配置：

[组：foo]
程序=酒吧，巴兹
优先级=999

鉴于上述情况，在 supervisord 启动时， 酒吧 和 巴兹 同质群体不会
存在，并且本应在它们之下的流程现在将移入 FOO
组。

[组：x] 部分 价值观
程式
以逗号分隔的程序名称列表。 列出的程序成为会员
组中的。

默认: 无默认值（必填）

其他要求：是的。

介绍：3.0

优先
一个优先级编号，类似于 [程序：x] 分配给组的优先级值。

默认：999

其他要求：没有。

介绍：3.0

[组：x] 部分 例如：
[组：foo]
程序=酒吧，巴兹
优先级=999

[fcgi-程序：x] 部分 个人设置
主管可以管理组 快速CGI 都在同一个套接字上侦听的进程。
到目前为止，FastCGI 的部署灵活性是有限的。 获取完整流程
管理，您可以在 Apache 下使用 mod_fastcgi，但随后您被 Apache 的
每个连接一个进程或线程的低效并发模型。 此外
需要更多的 CPU 和内存资源，每个连接模型的进程/线程可以是
被慢速资源迅速饱和，从而阻止其他资源得到服务。 在
为了利用更新的事件驱动的 Web 服务器，例如 lighttpd 或 nginx
不包括内置进程管理器，您必须使用像 cgi-fcgi 或
生成-fcgi。 这些可以与诸如 supervisord 之类的流程管理器结合使用
或 daemontools 但要求每个 FastCGI 子进程绑定到自己的套接字。 这
这样做的缺点是：不必要的复杂 Web 服务器配置，不美观
重新启动，并降低容错能力。 配置更少的套接字，Web 服务器
如果 FastCGI 进程组可以共享套接字，则配置要小得多。 共享
套接字允许正常重启，因为套接字仍然受父进程的约束
当任何子进程正在重新启动时。 最后，共享套接字更多
容错，因为如果给定的进程失败，其他进程可以继续服务
入站连接。

借助集成的 FastCGI 生成支持，Supervisor 为您提供两全其美。
您可以通过共享套接字的 FastCGI 进程组获得全功能的进程管理
无需绑定到特定的 Web 服务器。 这是一个干净的关注点分离，
允许 web 服务器和进程管理器各自做他们最擅长的事情。

注意:
Supervisor 中的套接字管理器最初是为了支持 FastCGI 进程而开发的
但它不仅限于 FastCGI。 也可以使用其他协议，无需特殊
配置。 任何可以从文件描述符访问打开套接字的程序（例如
套接字.fromfd 在 Python 中）可以使用套接字管理器。 主管将
在 fork 中的第一个孩子之前自动创建套接字、绑定和侦听
团体。 套接字将通过文件描述符编号传递给每个子进程 0 （零）。
当组中的最后一个孩子退出时，Supervisor 将关闭套接字。

所有可用的选项 [程序：x] 部分也受到尊重 fcgi-程序
部分。

[fcgi-程序：x] 部分 价值观
[fcgi-程序：x] 部分有一个单一的键 [程序：x] 节没有。

插座
此程序的 FastCGI 套接字，TCP 或 UNIX 域套接字。 对于 TCP 套接字，
使用这种格式： TCP://本地主机:9002. 对于 UNIX 域套接字，请使用
unix:///absolute/path/to/file.sock. 字符串表达式根据
包含键“program_name”和“here”（程序目录）的字典
监督配置文件）。

默认: 没有默认。

其他要求：是的。

介绍：3.0

套接字所有者
对于 UNIX 域套接字，此参数可用于指定用户和组
FastCGI 套接字。 可以是 UNIX 用户名（例如 chrism）或 UNIX 用户名和组
用冒号分隔（例如 chrism:wheel）。

默认: 使用为 fcgi-program 设置的用户和组

其他要求：没有。

介绍：3.0

套接字模式
对于 UNIX 域套接字，此参数可用于指定权限模式。

默认：0700

其他要求：没有。

介绍：3.0

征询 [程序：x] 部分 个人设置 对于其他允许的键，增量上述约束
和补充。

[fcgi-程序：x] 部分 例如：
[fcgi 程序：fcgi 程序名称]
命令=/usr/bin/example.fcgi
套接字=unix:///var/run/supervisor/%(program_name)s.sock
socket_owner=基督
套接字模式=0700
process_name=%(program_name)s_%(process_num)02d
进程数=5
目录=/ tmp目录
掩码=022
优先级=999
自动启动=真
自动重启=意外
开始秒 = 1
开始重试=3
退出代码 = 0,2
停止信号=退出
停止组=假
杀戮组=假
停止等待秒 = 10
用户=基督
重定向标准错误=真
stdout_logfile=/a/路径
stdout_logfile_maxbytes=1MB
标准输出日志文件备份=10
stdout_events_enabled = false
stderr_logfile=/a/路径
stderr_logfile_maxbytes=1MB
stderr_logfile_backups=10
stderr_events_enabled = false
环境=A="1",B="2"
服务器网址=自动

[事件监听器：x] 部分 个人设置
Supervisor 允许专门的同构进程组（“事件侦听器池”）
在配置文件中定义。 这些池包含旨在
从主管的事件系统接收和响应事件通知。 查看事件
事件如何工作以及如何实现可以声明为的程序的解释
事件监听器。

请注意，所有可用选项 [程序：x] 事件侦听器尊重部分
部分 除 标准输出捕获最大字节数 和 stderr_capture_maxbytes （事件监听器
无法发出进程通信事件，请参阅 capture_mode）。

[事件监听器：x] 部分 价值观
[事件监听器：x] 部分有几个键 [程序：x] 节没有。

缓冲区大小
事件侦听器池的事件队列缓冲区大小。 当侦听器池的事件缓冲区
溢出（当事件侦听器池无法跟上所有
发送给它的事件），缓冲区中最旧的事件将被丢弃。

事件
此侦听器“感兴趣”的事件类型名称的逗号分隔列表
接收通知（有关有效事件类型名称的列表，请参阅 event_types）。

结果处理程序
A pkg_资源 条目 点 绳子 解析为 Python 可调用。 默认的
价值是 supervisor.dispatchers：default_handler. 指定替代结果
处理程序是一件非常罕见的事情，因此，如何创建一个是
没有记录。

征询 [程序：x] 部分 个人设置 对于其他允许的键，增量上述约束
和补充。

[事件监听器：x] 部分 例如：
[事件监听器：事件监听器名称]
命令=/bin/eventlistener
process_name=%(program_name)s_%(process_num)02d
进程数=5
事件=PROCESS_STATE
缓冲区大小=10
目录=/ tmp目录
掩码=022
优先级=-1
自动启动=真
自动重启=意外
开始秒 = 1
开始重试=3
退出代码 = 0,2
停止信号=退出
停止等待秒 = 10
停止组=假
杀戮组=假
用户=基督
重定向标准错误=假
stdout_logfile=/a/路径
stdout_logfile_maxbytes=1MB
标准输出日志文件备份=10
stdout_events_enabled = false
stderr_logfile=/a/路径
stderr_logfile_maxbytes=1MB
stderr_logfile_backups=10
stderr_events_enabled = false
环境=A="1",B="2"
服务器网址=自动

[rpc接口：x] 部分 个人设置
添加 RPC接口：x 配置文件中的设置只对那些需要的人有用
希望通过额外的自定义行为扩展主管。

在示例配置文件中，有一个名为的部分 [rpc接口：主管].
默认情况下，它如下所示。

[rpc接口：主管]
Supervisor.rpcinterface_factory = Supervisor.rpcinterface:make_main_rpcinterface

[rpc接口：主管] 部分 必须 保留在标准配置中
设置主管以正常工作。 如果你不想让主管做任何事
还没有开箱即用，这是您需要了解的有关此类的全部信息
部分。

但是，如果您希望添加 rpc 接口命名空间以自定义主管，您
可能会添加额外的 [rpc接口：foo] 部分，其中“foo”代表的命名空间
接口（来自 Web 根），以及由命名的值 主管.rpcinterface_factory
是一个工厂可调用的，它应该有一个接受单个的函数签名
位置论证 主管 以及执行所需的尽可能多的关键字参数
配置。 中定义的任何额外的键/值对 [rpc接口：x] 节将
作为关键字参数传递给工厂。

这是一个工厂函数的例子，在 __init__.py Python的文件
包 我的包.

从 my.package.rpcinterface 导入另一个RPCInterface

def make_another_rpcinterface（supervisord，**配置）：
重试 = int(config.get('重试', 0))
another_rpc_interface = AnotherRPCInterface(supervisord, 重试)
返回 another_rpc_interface

配置文件中的一部分用于配置它。

[rpc接口：另一个]
Supervisor.rpcinterface_factory = my.package:make_another_rpcinterface
重试 = 1

[rpc接口：x] 部分 价值观
主管.rpcinterface_factory
pkg_资源 RPC 接口工厂函数的“入口点”点名。

默认：N / A

其他要求：没有。

介绍：3.0

[rpc接口：x] 部分 例如：
[rpc接口：另一个]
Supervisor.rpcinterface_factory = my.package:make_another_rpcinterface
重试 = 1

词汇表
守护进程
A 过程 控制 系统 by DJ 伯恩斯坦.

发射
A 过程 控制 系统 用过的 by Apple 作为 Mac OS X 下的进程 1。

运行 A 过程 控制 系统.

超长枪
一个提供各种事件侦听器实现的包
可以帮助监控进程内存使用情况和崩溃状态的主管：
http://pypi.python.org/pypi/superlance.

遮罩 的缩写 用户 面膜: 设置当前进程的文件模式创建掩码。
我们 http://en.wikipedia.org/wiki/Umask.

使用 onworks.net 服务在线使用 echo_supervisord_conf