Supervisor是一个监视工具,用于控制各种子进程,并在这些子进程突然退出或由于某些原因退出时处理这些子进程的启动/重新启动。 它可以扩展为通过XML-RPC API在远程位置上控制进程,而无需登录到服务器。 我将在这个由两部分组成的系列的第二部分中介绍XML-RPC API。
在本教程系列的第一部分中,我将带您了解如何设置Supervisor以与我们的应用程序一起使用。 为此,我将在Flask中与Gunicorn一起创建一个简单的应用程序,以充当我们的WSGI HTTP服务器。
我假设您对Flask,Gunicorn和环境设置最佳实践有基本的了解,并在开发Python应用程序时遵循virtualenv 。
安装套件
需要安装以下软件包才能开发和控制我们将要开发的应用程序。
$ pip install gunicorn supervisor Flask
琐碎的应用
现在,我将在Flask中创建一个简单的应用程序。 该应用程序很小,但是可以满足本教程的需求。
下面是应用程序的结构:
flask_app/
my_app/
- __init__.py
- views.py
flask_app / my_app / __ init__.py
from flask import Flask
app = Flask(__name__)
import my_app.views
在上面的文件中,该应用程序已配置并初始化。
flask_app / my_app / views.py
from my_app import app
@app.route('/')
def hello_world():
return 'Hello to the World of Flask!'
在上面的文件中,我创建了一个简单的Hello World端点。
要将应用程序作为一个流程运行,我们可以使用Gunicorn。 要检查Gunicorn是否按预期工作,只需在应用程序文件夹中运行以下命令。
$ gunicorn -w 4 -b 127.0.0.1:8000 my_app:app
之后,将浏览器指向http://127.0.0.1:8000/以查看应用程序的主页。
配置和使用主管
现在,我们需要使用Supervisor进行相同的操作,以便它作为守护程序运行,并且将由Supervisor本身而不是人工干预来控制。
首先,我们需要一个Supervisor配置文件。 默认情况下,Supervisor将查找一个etc
文件夹,该文件夹包含名为supervisord.conf
的文件。 在系统范围内的安装中,该文件夹为/etc/
,在virtualenv中,它将在virtualenv中寻找一个etc
文件夹,然后退回到/etc/
。
如果是系统范围的安装,请运行:
$ echo_supervisord_conf > /etc/supervisord.conf
对于virtualenv,请从virtualenv根文件夹中运行:
$ echo_supervisord_conf > etc/supervisord.conf
echo_supervisord_conf
程序由Supervisor提供; 它将示例配置文件打印到指定的位置。 这将在上述命令中指定的位置创建一个名为supervisord.conf
的文件。
要为我们的应用程序配置Supervisor,请在此文件中的以下位置添加以下块:
[program:supervisor_demo]
command=<path/to/virtualenv>/bin/gunicorn -w 4 -b 127.0.0.1:8000 my_app:app
directory=<path/to/virtualenv>/supervisor-tutsplus-demo
user=someuser # Relevant user
autostart=true
autorestart=true
stdout_logfile=/tmp/app.log
stderr_logfile=/tmp/error.log
在这里,我们配置需要运行的命令以及在哪个用户下需要从哪个目录位置运行该命令。 还指定了在发生任何故障时是否重新启动应用程序。 也可以指定日志文件的位置。 还有许多其他配置选项,可以在Supervisor的官方文档中查找。
请注意,永远不要以root用户身份运行应用程序。 随着应用程序崩溃,这是一个巨大的安全漏洞,可能会损害操作系统本身。
要使用Supervisor运行应用程序,请运行以下命令:
$ supervisord
$ supervisorctl status
supervisor_demo RUNNING pid 22550, uptime 0:00:04
第一个命令调用supervisord
服务器,第二个命令给出所有子进程的状态。
每次您对应用程序进行更改,然后希望重新启动Gunicorn以使其反映更改时,请运行以下命令:
$ supervisorctl restart all
您还可以指定特定的过程,而不用重新启动一切:
$ supervisorctl restart supervisor_demo
监督者还提供了可以通过启用来启用一个Web UI界面inet_http_server
中配置块supervisord.conf
。 可以在http:// localhost:9001 /上查找此Web UI。
结论
在本教程中,我们已经了解了如何配置Supervisor并使用它来将应用程序作为守护进程运行并集体或选择性地控制进程。 在本教程系列的第二部分中,我们将看到如何使用XML-RPC API控制和询问Supervisor及其程序/过程。