Sanic教程: 2.配置

对于一个项目来说，配置是一个很严肃的问题，比如说：在开发环境和生产环境中，配置是不同的，那么一个项目该如何自由地在不同的配置环境中进行切换呢，思考下，然后带着答案或者疑问往下阅读。

单一配置

撸起袖子，开始吧，新建文件夹 demo2 ，内部建立这样的文件结构：

1. demo02

2. ├── config

3. │   ├── __init__.py

4. │   └── config.py

5. └── run.py

其中 run.py 内容如下：

1. #!/usr/bin/env python

2. from sanic import Sanic

3. from sanic.response import text

5. app = Sanic()

8. @app.route("/")

9. async def test(request):

10.    return text('Hello World!')

13. if __name__ == "__main__":

14.    app.run(host="0.0.0.0", port=8000, debug=True)

代码示例中开启了 debug 模式，假设我们需要通过 config.py 配置文件来实现控制服务的 debug 模式开启与否，那该怎么实现呢。

在 config.py 中添加一行： DEBUG=True ，然后 run.py 内容改为：

1. #!/usr/bin/env python

2. from sanic import Sanic

3. from sanic.response import text

4. from config import DEBUG

6. app = Sanic()

9. @app.route("/")

10. async def test(request):

11.    return text('Hello World!')

14. if __name__ == "__main__":

15.    app.run(host="0.0.0.0", port=8000, debug=DEBUG)

表面上看，功能确实实现了，但这实际上却不是很好的做法，若部署在生产环境中，难道还要特地再将 debug 改为 False 么，这显然很浪费时间，如果需要改变的参数有很多，那就很难维护了。

多配置

那么，正确的做法应该是怎么样的呢？

我们应当依据不同的环境来编写各自对应的环境，举个例子，比如生产环境就对应 pro_config，开发环境就对应 dev_config.py等等

具体该怎么实施？首先在文件夹 demo2 ，内部建立这样的文件结构：

1. demo02

2. ├── config

3. │   ├── __init__.py

4. │   ├── config.py

5. │   ├── dev_config.py

6. │   └── pro_config.py

7. └── run.py

然后使用类继承的方式使这三个配置文件联系起来，比如在 config.py 中就只放公有配置，如：

1. #!/usr/bin/env python

2. import os

5. class Config():

6.    """

7.    Basic config for demo02

8.    """

9.    # Application config

10.    TIMEZONE = 'Asia/Shanghai'

11.    BASE_DIR = os.path.dirname(os.path.dirname(__file__))

而在 pro_config.py或dev_config.py 中就可以自由地编写不同的配置了：

1. # dev_config

2. #!/usr/bin/env python

3. from .config import Config

6. class DevConfig(Config):

7.    """

8.    Dev config for demo02

9.    """

11.    # Application config

12.    DEBUG = True

14. # pro_config

15. #!/usr/bin/env python

16. from .config import Config

19. class ProConfig(Config):

20.    """

21.    Pro config for demo02

22.    """

24.    # Application config

25.    DEBUG = False

配置文件还需要根据系统环境变量的设置进行不同配置环境的切换，比如设置 MODE 系统环境变量，这里从系统环境变量得到配置也是个不错的方法，一般说利用 gunicorn配置 worker数目之类的，都可以使用这种方案。

然后可以根据其不同的值切换到不同的配置文件，因此在 __init__.py 中需要这么写：

1. #!/usr/bin/env python

2. import os

5. def load_config():

6.    """

7.    Load a config class

8.    """

10.    mode = os.environ.get('MODE', 'DEV')

11.    try:

12.        if mode == 'PRO':

13.            from .pro_config import ProConfig

14.            return ProConfig

15.        elif mode == 'DEV':

16.            from .dev_config import DevConfig

17.            return DevConfig

18.        else:

19.            from .dev_config import DevConfig

20.            return DevConfig

21.    except ImportError:

22.        from .config import Config

23.        return Config

26. CONFIG = load_config()

默认 MODE 设置为 DEV，在 run.py 文件中就可以这么调用：

1. #!/usr/bin/env python

2. from sanic import Sanic

3. from sanic.response import text

4. from config import CONFIG

6. app = Sanic()

7. app.config.from_object(CONFIG)

9. @app.route("/")

10. async def test(request):

11.    return text('Hello World!')

14. if __name__ == "__main__":

15.    app.run(host="0.0.0.0", port=8000, debug=app.config['DEBUG'])

而在生产环境的服务器上，直接通过设置系统变量就可以达到配置修改的目的了，如下：

1. # 通过设置MODE的值进行配置文件的选择

2. export MODE=PRO

若是利用 supervisor 来启动服务，可通过添加 environment=MODE="PRO" 来设置环境变量，是不是很方便呢。

说明

其实我编写这种微服务，配置更新是很正常且很频繁的需求，这样的话我就必须要求我的代码可以实现热更新，也就是可以迅速的修改配置，且迅速的生效，目前我使用的是 ZooKeeper来实现这个需求，有兴趣的朋友可以详细了解，或许你也是用这个方案呢？

如果你有更好的方案，不妨告知一二。