馆长核心项目的主要功能
core-main-app的Python项目详细描述
这个django可重用的应用程序包含馆长的主要功能 核心项目。
先决条件
对于自动和手动安装,需要以下软件:
- python
- pip
- 虚拟环境(conda或venv)
此外,对于手动设置,需要git。
安装
自动安装
$ pip install core_main_app
手动安装
$ git clone https://github.com/usnistgov/core_main_app.git
$ cd core_main_app
$ python setup.py
$ pip install sdist/*.tar.gz
配置
编辑setting.py文件
在INSTALLED_APPS下添加"core_main_app"和"tz_detect"作为 例如:
INSTALLED_APPS=[..."tz_detect","core_main_app",]
添加tz_detect:
所需的中间件MIDDLEWARE=(...'tz_detect.middleware.TimezoneMiddleware',)
编辑url.py文件
将core_main_appurl添加到django项目中。
url(r'^',include("core_main_app.urls")),
国际化(I18N)
在运行项目之前,不要忘记在 项目级别。i18n使用gettext包,因此请确保它是 在使用此命令之前安装。
$ python manage.py compilemessages
测试
要播放为此包创建的测试套件,请下载git存储库 然后运行:
$ python runtests.py
文档
文档是使用sphinx生成的。生成的本地版本 文档,请克隆存储库并运行:
$ cd docs/
$ make html
或者,直接使用狮身人面像:
$ cd docs/
$ sphinx-build -b html . ../dist/_docs
启用SSL连接
请按照以下步骤配置到任何通过https运行的系统(包括本地实例)的连接。
- 为ssl证书创建一个文件夹,
- 复制文件夹中的证书,
- 在文件夹上运行c_rehash(每次向文件夹中添加新证书时都需要执行此操作),
- 更新ssl_certificates_dir设置以指向先前创建的ssl certificate文件夹。
$ mkdir certs $ cp cdcs.crt certs/ $ c_rehash certs/
启用redis服务器身份验证
请按照以下步骤在redis服务器上启用身份验证。 根据在机器上启动redis的方式,方法可能有所不同。
您可以按照https://redis.io/topics/security#authentication-feature上的说明启用身份验证: *打开文件redis.conf(例如/usr/local/etc/redis.conf)。 *取消对身份验证设置的注释(requirepass foobared), *建议用强密码和长密码替换默认密码(foobared)。 *重新启动redis服务器。
然后,您应该使用在前面步骤中选择的密码使用redis连接url更新cdcs设置。
BROKER_URL='redis://:<password>@localhost:6379/0'CELERY_RESULT_BACKEND='redis://:<password>@localhost:6379/0'