Flask環境構成
アプリケーションが正しく動作するには、多数のパッケージが必要になる場合があります。 Flask パッケージが必要ない場合は、間違ったチュートリアルを読んだ可能性があります。アプリケーションの環境は、基本的に、アプリケーションの実行中に発生するすべての基盤となります。私たちは幸運なことに、環境を簡単に管理できる方法がたくさんあります。
virtualenv を使用して環境を管理する
virtualenv は、いわゆる仮想環境でアプリケーションを分離するためのツールです。仮想環境は、アプリケーションが依存するソフトウェアが含まれるディレクトリです。仮想環境では、開発環境に含まれる環境変数を維持するために環境変数を変更することもできます。 Flask などのパッケージをシステムレベルまたはユーザーレベルのパッケージ ディレクトリにダウンロードする代わりに、アプリケーションでのみ使用される別のディレクトリにパッケージをダウンロードできます。これにより、使用する Python のバージョンと各プロジェクトが依存するパッケージを簡単に指定できます。
Virtualenv を使用すると、異なるプロジェクトで同じパッケージの異なるバージョンを使用することもできます。この柔軟性は、古いシステムを使用していて、異なるバージョンを必要とする複数のプロジェクトがある場合に重要になります。
virtualenv を使用する場合、通常はシステムにいくつかの Python パッケージをインストールするだけで済みます。そのうちの 1 つは virtualenv 自体です。 Pip を使用して virtualenv パッケージをインストールできます。
virtualenv がシステムにインストールされたら、仮想環境の作成を開始できます。プロジェクトが存在するディレクトリに移動し、virtualenv コマンドを実行します。パラメータが 1 つ必要です。これは、仮想環境のターゲット ディレクトリです。それがどのようなものかを大まかに見てみましょう。
virtualenv は新しいディレクトリを作成し、依存パッケージはこのディレクトリにインストールされます。
新しい仮想環境が作成されたら、仮想環境内に作成された bin/activate スクリプトを起動して、仮想環境をアクティブ化する必要があります。
bin/activate スクリプトはシェル環境変数にいくつかの変更を加え、すべてがグローバル システムではなく新しい仮想環境を指すようにします。上記のコード ブロックで効果を確認できます。アクティブ化後、Python コマンドは仮想環境内の Python bin ディレクトリを指します。仮想環境がアクティブ化されると、Pip を使用してインストールされた依存関係パッケージは、グローバル システムではなく仮想環境にダウンロードされます。
シェル内のプロンプトも変更されていることに気づくかもしれません。 virtualenv は現在アクティブな仮想環境の名前を事前に設定するため、グローバル システムで作業していないことがわかります。
deactivate コマンドを実行すると、仮想環境を非アクティブ化できます。
仮想環境ラッパー
virtualenvwrapper は、virtualenv で作成された仮想環境を管理するためのパッケージです。 virtualenv の基本を理解して、このツールが何を改善するのか、そしてなぜこのツールを使用する必要があるのかを理解するまでは、このツールについては言及しません。
前のセクションで作成した仮想環境ディレクトリにより、プロジェクト ライブラリが乱雑になります。仮想環境と対話するには、仮想環境をアクティブ化するだけで済みますが、バージョン管理には表示されないため、仮想環境のディレクトリはここにあるべきではありません。解決策は、virtualenvwrapper を使用することです。このパッケージは、すべての仮想環境を 1 つのディレクトリ (通常、デフォルトでは ~/.virtualenvs/) に配置します。
virtualenvwrapper をインストールするには、http://virtualenvwrapper.readthedocs.org/en/latest/install.html にあるドキュメントの指示に従ってください。
virtualenvwrapper をインストールする前に、すべての仮想環境が無効になっていることを確認してください。仮想環境ではなく、グローバルにインストールする必要があります。
ここで、virtualenv を実行して環境を作成する代わりに、mkvirtualenv を実行する必要があります:
*.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 平台。