在heroku tutorial中,有一段代码
hello.py
import os
from flask import Flask
app = Flask(__name__)
@app.route('/')
def hello():
return 'Hello World!'
和Procfile:
web: gunicorn hello:app --log-file=-
真正令人困惑的部分是hello:app
部分; hello
是指hello()
函数还是 hello.py 脚本?根据其含义,整个Procfile语句的含义是什么?
答案 0 :(得分:6)
ProcFile包含在heroku上启动应用程序的命令行。完整文档可在此处找到:https://devcenter.heroku.com/articles/procfile
在这种情况下,它告诉heroku在带有gunicorn的hello模块中使用app变量(你构建的烧瓶应用程序)并启动一个web进程(一个可以处理http请求的进程)。您可以指定其他进程类型,例如后台工作程序。
您的烧瓶应用程序对象是WSGI应用程序,可以使用任何WSGI服务器运行。 Gunicorn只是heroku的选择之一。
答案 1 :(得分:6)
所提到的Heroku教程不再可用,但是Gunicorn's doc给出了一个很好的最小示例:
测试应用的示例:
def app(environ, start_response): """Simplest possible application object""" data = b'Hello, World!\n' status = '200 OK' response_headers = [ ('Content-type', 'text/plain'), ('Content-Length', str(len(data))) ] start_response(status, response_headers) return iter([data])
您现在可以使用以下命令运行该应用程序:
$ gunicorn --workers=2 test:app
尝试一下,我的 test-directory 看起来像这样:
(.venv) 14:41 ~/testgunicorn % tree
.
├── requirements.txt
└── testpkg
├── __init__.py
└── testfile.py
__init__.py
:
from flask import Flask
from .testfile import app
testfile.py
:
#!/usr/bin/env python3
# -*- coding: utf-8 -*-
def app(environ, start_response):
"""Simplest possible application object"""
data = b'Hello, World!\n'
status = '200 OK'
response_headers = [
('Content-type', 'text/plain'),
('Content-Length', str(len(data)))
]
start_response(status, response_headers)
return iter([data])
打错电话:
(.venv) 14:41 ~/testgunicorn % gunicorn testfile:app
[2018-08-24 14:41:44 +0200] [27248] [INFO] Starting gunicorn 19.9.0
[2018-08-24 14:41:44 +0200] [27248] [INFO] Listening at: http://127.0.0.1:8000 (27248)
[2018-08-24 14:41:44 +0200] [27248] [INFO] Using worker: sync
[2018-08-24 14:41:44 +0200] [27251] [INFO] Booting worker with pid: 27251
[2018-08-24 14:41:44 +0200] [27251] [ERROR] Exception in worker process
Traceback (most recent call last):
File "~/testgunicorn/.venv/lib/python3.6/site-packages/gunicorn/arbiter.py", line 583, in spawn_worker
worker.init_process()
File "~/testgunicorn/.venv/lib/python3.6/site-packages/gunicorn/workers/base.py", line 129, in init_process
self.load_wsgi()
File "~/testgunicorn/.venv/lib/python3.6/site-packages/gunicorn/workers/base.py", line 138, in load_wsgi
self.wsgi = self.app.wsgi()
File "~/testgunicorn/.venv/lib/python3.6/site-packages/gunicorn/app/base.py", line 67, in wsgi
self.callable = self.load()
File "~/testgunicorn/.venv/lib/python3.6/site-packages/gunicorn/app/wsgiapp.py", line 52, in load
return self.load_wsgiapp()
File "~/testgunicorn/.venv/lib/python3.6/site-packages/gunicorn/app/wsgiapp.py", line 41, in load_wsgiapp
return util.import_app(self.app_uri)
File "~/testgunicorn/.venv/lib/python3.6/site-packages/gunicorn/util.py", line 350, in import_app
__import__(module)
ModuleNotFoundError: No module named 'testfile'
[2018-08-24 14:41:44 +0200] [27251] [INFO] Worker exiting (pid: 27251)
[2018-08-24 14:41:44 +0200] [27248] [INFO] Shutting down: Master
[2018-08-24 14:41:44 +0200] [27248] [INFO] Reason: Worker failed to boot.
zsh: exit 3 gunicorn testfile:app
良好的通话:
(.venv) 14:43 ~/testgunicorn % gunicorn testpkg:app
[2018-08-24 14:43:56 +0200] [27302] [INFO] Starting gunicorn 19.9.0
[2018-08-24 14:43:56 +0200] [27302] [INFO] Listening at: http://127.0.0.1:8000 (27302)
[2018-08-24 14:43:56 +0200] [27302] [INFO] Using worker: sync
[2018-08-24 14:43:56 +0200] [27305] [INFO] Booting worker with pid: 27305
^C
(…)
(.venv) 15:03 ~/testgunicorn % cd testpkg
(.venv) 15:03 fred@susa ~/git/ocp7/testpkg % gunicorn testfile:app
[2018-08-24 15:03:22 +0200] [27494] [INFO] Starting gunicorn 19.9.0
[2018-08-24 15:03:22 +0200] [27494] [INFO] Listening at: http://127.0.0.1:8000 (27494)
[2018-08-24 15:03:22 +0200] [27494] [INFO] Using worker: sync
[2018-08-24 15:03:22 +0200] [27497] [INFO] Booting worker with pid: 27497
^C
(…)
然后为此Procfile
:
web: gunicorn hello:app --log-file=-
hello是否引用hello()函数或hello.py脚本? 转到
hello.py
脚本根据其含义,整个Procfile语句是什么意思?
Heroku的Procfile format documentation说:
Procfile在各个行上声明其进程类型,每个行都有 以下格式:
<process type>: <command>
<process type>
是命令的字母数字名称,例如Web,工作者,紧急工作者,时钟等。<command>
表示在启动时应执行的每个进程类型的dyno命令,例如rake jobs:work。
--logfile=-
选项似乎已被弃用,我在文档中没有找到任何有关此选项的信息,如果使用它,则会出现此错误:
(.venv) 15:34 ~/testgunicorn % heroku local web
[WARN] No ENV file found
15:34:30 web.1 | usage: gunicorn [OPTIONS] [APP_MODULE]
15:34:30 web.1 | gunicorn: error: unrecognized arguments: --logfile=-
15:34:30 web.1 Exited with exit code 2
根据this answer,这是用于登录Heroku的标准输出的选项。
答案 2 :(得分:1)
1- 根据{{3}}部分 Procfile格式
web: gunicorn hello:app
是<进程类型>:<命令>模式
2- web
因此是
3-现在
gunicorn hello:app
如果您在documentation部分基本用法中查看,您会发现一个典型的gunicorn命令是
$ gunicorn [OPTIONS] APP_MODULE
APP_MODULE的格式为$(MODULE_NAME):$(VARIABLE_NAME)。
因此,在您的示例中,hello
引用了$(MODULE_NAME),它是hello.py。请注意,如有必要,它可以是完整的虚线路径。以同样的方式app
引用WSGI可调用$(VARIABLE_NAME),该实例应在指定的hello模块中找到,并在实例化Flask类时进行实际定义:
app = Flask(__name__)
。