Heroku Flask Tutorial Procfile含义

时间:2015-05-11 22:38:55

标签: python heroku flask

在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语句的含义是什么?

3 个答案:

答案 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因此是。根据相同的Heroku doc:“ Heroku应用程序的Web进程类型是唯一可以从Heroku路由器接收外部HTTP流量的进程类型。如果您的应用程序包含Web服务器,则应将其声明为应用程序的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__)