Flask-Umgebungskonfiguration
Ihre Anwendung erfordert möglicherweise eine große Anzahl von Paketen, um ordnungsgemäß zu funktionieren. Wenn Sie das Flask-Paket nicht benötigen, haben Sie möglicherweise das falsche Tutorial gelesen. Die Umgebung Ihrer Anwendung ist im Grunde die Grundlage für alles, was passiert, wenn Ihre Anwendung ausgeführt wird. Wir haben Glück, denn es gibt viele Möglichkeiten, wie wir unsere Umwelt problemlos verwalten können.
Verwenden Sie Virtualenv, um Ihre Umgebung zu verwalten
virtualenv ist ein Tool zur Isolierung Ihrer Anwendungen in sogenannten virtuellen Umgebungen. Eine virtuelle Umgebung ist ein Verzeichnis, das Software enthält, von der Ihre Anwendung abhängt. Eine virtuelle Umgebung kann auch Ihre Umgebungsvariablen ändern, um die in Ihrer Entwicklungsumgebung enthaltenen Umgebungsvariablen beizubehalten. Anstatt Pakete wie Flask in Ihr Paketverzeichnis auf System- oder Benutzerebene herunterzuladen, können wir sie in ein separates Verzeichnis herunterladen, das nur von unserer Anwendung verwendet wird. Dies erleichtert die Angabe der verwendeten Python-Version und der Pakete, von denen jedes Projekt abhängt.
Mit Virtualenv können Sie außerdem verschiedene Versionen desselben Pakets in verschiedenen Projekten verwenden. Diese Flexibilität kann wichtig sein, wenn Sie ein älteres System verwenden und darauf mehrere Projekte haben, die unterschiedliche Versionen erfordern.
Bei Verwendung von virtualenv müssen Sie in der Regel nur wenige Python-Pakete auf Ihrem System installieren. Einer davon ist Virtualenv selbst. Sie können Pip verwenden, um Virtualenv-Pakete zu installieren.
Sobald virtualenv auf Ihrem System installiert ist, können Sie mit der Erstellung virtueller Umgebungen beginnen. Gehen Sie in das Verzeichnis, in dem sich Ihr Projekt befindet, und führen Sie den Befehl „virtualenv“ aus. Es erfordert einen Parameter, nämlich das Zielverzeichnis der virtuellen Umgebung. Hier ein Überblick, wie es aussieht.
$ virtualenv venv New python executable in venv/bin/python Installing Setuptools...........[...].....done. Installing Pip..................[...].....done.
virtualenv erstellt ein neues Verzeichnis und abhängige Pakete werden in diesem Verzeichnis installiert.
Sobald die neue virtuelle Umgebung erstellt wurde, müssen Sie sie aktivieren, indem Sie das in der virtuellen Umgebung erstellte bin/activate-Skript starten.
$ which python /usr/local/bin/python $ source venv/bin/activate (venv)$ which python /Users/robert/Code/myapp/venv/bin/python
Das bin/activate-Skript nimmt einige Änderungen an Ihren Shell-Umgebungsvariablen vor, sodass alles auf die neue virtuelle Umgebung und nicht auf das globale System verweist. Sie können den Effekt im Codeblock oben sehen. Nach der Aktivierung verweist der Python-Befehl auf das Python-Bin-Verzeichnis in der virtuellen Umgebung. Wenn die virtuelle Umgebung aktiviert ist, werden mit Pip installierte Abhängigkeitspakete in die virtuelle Umgebung und nicht in das globale System heruntergeladen.
Möglicherweise stellen Sie fest, dass sich auch die Eingabeaufforderung in der Shell geändert hat. virtualenv legt den Namen der aktuell aktiven virtuellen Umgebung vorein, sodass Sie wissen, dass Sie nicht am globalen System arbeiten.
Sie können Ihre virtuelle Umgebung deaktivieren, indem Sie den Befehl „deaktivieren“ ausführen.
(venv)$ deactivate
virtualenvwrapper
virtualenvwrapper ist ein Paket zur Verwaltung virtueller Umgebungen, die von virtualenv erstellt wurden. Ich möchte dieses Tool erst erwähnen, wenn Sie die Grundlagen von Virtualenv kennengelernt haben, damit Sie verstehen, was es verbessert und warum wir es verwenden sollten.
Das im vorherigen Abschnitt erstellte Verzeichnis der virtuellen Umgebung führt zu etwas Unordnung in Ihrer Projektbibliothek. Sie müssen nur die virtuelle Umgebung aktivieren, um mit ihr interagieren zu können. Sie sollte jedoch nicht in der Versionskontrolle angezeigt werden, sodass das Verzeichnis der virtuellen Umgebung nicht hier sein sollte. Die Lösung besteht darin, virtualenvwrapper zu verwenden. Dieses Paket legt alle Ihre virtuellen Umgebungen in einem Verzeichnis ab, normalerweise standardmäßig in ~/.virtualenvs/.
Befolgen Sie zur Installation von virtualenvwrapper die Anweisungen in der Dokumentation unter http://virtualenvwrapper.readthedocs.org/en/latest/install.html.
Bitte stellen Sie sicher, dass Sie alle virtuellen Umgebungen deaktiviert haben, bevor Sie virtualenvwrapper installieren. Sie müssen es global installieren, nicht in einer virtuellen Umgebung.
Anstatt nun „virtualenv“ auszuführen, um eine Umgebung zu erstellen, müssen Sie „mkvirtualenv“ ausführen:
$ mkvirtualenv rocket New python executable in rocket/bin/python Installing setuptools...........[...].....done. Installing pip..................[...].....done. (rocket)$
(rocket)$ pip freeze > requirements.txt $ workon fresh-env (fresh-env)$ pip install -r requirements.txt [...] Successfully installed flask Werkzeug Jinja2 itsdangerous markupsafe Cleaning up... (fresh-env)$
*.pyc instance/
Flask 工程配置
当你学习 Flask 的时候,配置看起来很简单。你只要在 config.py 中定义一些变量接着一切就能工作了。当你开始必须要管理生产应用的配置的时候,这些简单性开始消失了。你可能需要保护 API 密钥以及为不同的环境使用不同的配置(例如,开发和生产环境)。在本章节中我们会介绍 Flask 一些先进的功能,它可以使得管理配置容易些。
简单的例子
一个简单的应用程序可能不会需要任何这些复杂的功能。你可能只需要把 config.py 放在你的仓库/版本库的根目录并且在 app.py 或者 yourapp/\\_init\\_.py 中加载它。
config.py 文件中应该每行包含一个配置变量赋值。当你的应用程序初始化的时候,在 config.py 中的配置变量用于配置 Flask 和它的扩展并且它们能够通过 app.config 字典访问到 – 例如,app.config["DEBUG"]。
DEBUG = True # Turns on debugging features in Flask BCRYPT_LEVEL = 12 # Configuration for the Flask-Bcrypt extension MAIL_FROM_EMAIL = "robert@example.com" # For use in application emails
配置的变量可以被 Flask,它的扩展或者你来使用。这个例子中, 每当我们在一封事务性邮件中需要默认的 “发件人” 的时候,我们可以使用 app.config["MAIL_FROM_EMAIL"] – 例如,密码重置。把这些信息放置于一个配置变量中使得以后能够容易地修改它。
# app.py or app/__init__.pyfrom flask import Flask app = Flask(__name__) app.config.from_object('config') # Now we can access the configuration variables via app.config["VAR_NAME"].
确保在生产环境中 DEBUG 设置成 False。如果保留 DEBUG 为 True,它允许用户在你的服务器上执行任意的 Python。
实例文件夹
有时候你需要定义包含敏感信息的配置变量。我们想要从 config.py 中分离这些变量并且让它们保留在仓库/版本库之外。你可能会隐藏像数据库密码以及 API 密钥的一些敏感信息,或者定义于特定于指定机器的配置变量。为让实现这些要求更加容易些,Flask 提供了一个叫做 instance folders 的功能。实例文件夹是仓库/版本库下的一个子目录并且包含专门为这个应用程序的实例的一个配置文件。我们不希望它提交到版本控制。
config.py requirements.txt run.py instance/ config.py yourapp/ __init__.py models.py views.py templates/ static/
使用实例文件夹
我们使用 app.config.from_pyfile() 来从一个实例文件夹中加载配置变量。当我们调用 Flask() 来创建我们的应用的时候,如果我们设置了 instance_relative_config=True, app.config.from_pyfile() 将会从 instance/ 目录加载指定文件。
# app.py or app/__init__.py app = Flask(__name__, instance_relative_config=True) app.config.from_object('config') app.config.from_pyfile('config.py')
现在我们可以像在 config.py 中那样在 instance/config.py 中定义配置变量。你也应该把你的实例文件夹加入到版本控制系统的忽略列表中。要使用 Git 做到这一点的话,你需要在 .gitignore 新的一行中添加 instance/ 。
密钥
实例文件夹的隐私性成为在其里面定义不想暴露到版本控制的密钥的最佳候选。这些密钥可能包含了你的应用的密钥或者第三方 API 密钥。如果你的应用是开源的或者以后可能会公开的话,这一点特别重要。我们通常要求其他用户或者贡献者使用自己的密钥。
# instance/config.py SECRET_KEY = 'Sm9obiBTY2hyb20ga2lja3MgYXNz' STRIPE_API_KEY = 'SmFjb2IgS2FwbGFuLU1vc3MgaXMgYSBoZXJv' SQLALCHEMY_DATABASE_URI= \\"postgresql://user:TWljaGHFgiBCYXJ0b3N6a2lld2ljeiEh@localhost/databasename"
基于环境的配置
如果在你的生产环境和开发环境中的差异非常小的话,你可能想要使用实例文件夹来处理配置的变化。定义在 'instance/config.py' 文件中的配置变量能够覆盖 'config.py' 中的值。你只需要在 'app.config.from_object()' 后调用 'app.config.from_pyfile()'。这样用法的好处之一就是在不同的机器上修改你的应用的配置。
# config.py DEBUG = False SQLALCHEMY_ECHO = False # instance/config.py DEBUG = True SQLALCHEMY_ECHO = True
在生产环境上,我们略去上面 'instance/-config.py' 中的配置变量,它会退回到定义在 'config.py' 中的值。
了解更多关于 Flask-SQLAlchemy 的 配置项。(中文版的位于:http://www.pythondoc.com/flask-sqlalchemy/config.html#configuration-keys)
基于环境变量配置
实例文件夹不应该出现在版本控制中。这就意味着你将无法跟踪你的实例配置的变化。如果只是一、两个变量这可能不是什么问题,但是如果你在不同的环境上(生产,预升级,开发,等等)配置都有些微调话,你就不会想要存在丢失它们的风险。
Flask 给我们选择配置文件的能力,它可以基于一个环境变量的值来加载不同的配置文件。这就意味着在我们的仓库/版本库里,我们可以有多个配置文件并且总会加载正确的那一个。一旦我们有多个配置文件的话,我可以把它们移入它们自己 config 文件夹中。
requirements.txt run.py config/ __init__.py # Empty, just here to tell Python that it's a package. default.py production.py development.py staging.py instance/ config.py yourapp/ __init__.py models.py views.py static/ templates/
在上面的文件列表中我们有多个不同的配置文件。
为了决定要加载哪个配置文件,我们会调用 'app.config.from_envvar()'。
# yourapp/\\_\\_init\\_\\_.py app = Flask(__name__, instance_relative_config=True) # Load the default configuration app.config.from_object('config.default') # Load the configuration from the instance folder app.config.from_pyfile('config.py') # Load the file specified by the APP\\_CONFIG\\_FILE environment variable# Variables defined here will override those in the default configuration app.config.from_envvar('APP_CONFIG_FILE')
环境变量的值应该是配置文件的绝对路径。
我们如何设置这个环境变量取决于我们运行应用所在的平台。如果我们运行在一个普通的 Linux 服务器上,我们可以编写一个设置环境变量的 shell 脚本并且运行 run.py。
# start.sh APP\\_CONFIG\\_FILE=/var/www/yourapp/config/production.py python run.py
start.sh 对于每一个环境都是独一无二的,因此它应该被排除在版本控制之外。在 Heroku 上,我们需要使用 Heroku 工具来设置环境变量。这种设置方式也适用于其它的 PaaS 平台。