satorix-django

通过互联网曝光

Satorix : 从本地获取您的应用程序

该satorix-django软件包为支持 12 因素的 Django 应用程序与 Satorix 生态系统交互提供了一种简化的机制。

准备你的申请

通过将 Satorix 添加到您的 Django 应用程序中requirements.txt：

satorix-django

运行pip install satorix-django安装它。

接下来，从应用程序根目录的终端运行生成器：

$ satorix-django-config

这将创建一组文件，这些文件利用 Satorix 默认创建的环境变量。其中包括Phusion Passenger Rails 应用服务器和 Nginx 内置的Passenger web 服务器。

配置您的应用程序

您可以使用环境变量在每个环境的基础上配置您的应用程序。该satorix-django-config命令尝试添加satorix_django为您的应用程序设置数据库连接的导入。

默认环境变量

以下默认环境变量由satorix-django生成的文件使用，并且可以通过 Satorix Dashboard 进行管理：

SATORIX_CANONICAL_URI_HOST

可选，默认情况下将所有请求重写到的域。设置此项将使对您站点的所有请求都将转到提供的域。

常用设置：

• www.domain.dom

SATORIX_CANONICAL_URI_PROTOCOL

可选，HTTP将请求重写到的协议。

有效设置：

• http
• https

SATORIX_PROXY_IPS

可选，用于定义代理 IP 地址，用于 CloudFlare 等服务。这将允许您在日志中获取访问您的站点的实际客户端 IP 地址，并且您的应用程序可以访问该地址。

有效设置：

• 以空格分隔的 IP 或网络范围列表 ( 103.21.244.0/22 103.22.200.0/22 103.31.4.0/22 104.16.0.0/12 108.162.192.0/18 131.0.72.0/22 141.101.64.0/18 162.158.0.0/15 172.64.0.0/13 173.245.48.0/20 188.114.96.0/20 190.93.240.0/20 197.234.240.0/22 198.41.128.0/17 199.27.128.0/21)

SATORIX_AUTHENTICATION_HTPASSWDS

可选，用于通过 HTTP 基本身份验证控制对您站点的访问。需要以 Apache 工具创建的格式htpasswd -nb username password或使用在线生成器生成。

有效设置：

• 换行符分隔的用户名和哈希密码列表 ( username:$apr1$vAxBKb8N$m0en1zabtHktHeFyT3j9y)

SATORIX_AUTHENTICATION_ALLOWED_IPS

可选，用于通过绕过上述 HTTP 基本身份验证来控制对您站点的访问。如果设置为all不需要身份验证。此处添加的任何 IP 地址或网络都无需提供用户名和密码即可访问该站点。

有效设置：

• 全部 ( all)
• 单个 IP ( 192.168.1.2)
• 网络范围 ( 192.168.1.0/24)
• 多个 IP 或网络范围的空格分隔列表 ( 192.168.1.3 192.168.2.0/24)

贡献

请使用官方问题跟踪器协调贡献。

测试

这个包是使用unittest测试的。

您可以运行在 CI 期间运行的相同测试：

python setup.py test

CI/CD

Satorix 用于为此应用程序提供持续集成和持续部署。

每次推送都会运行 CI。

CD 用于为 master 分支构建和发布包。

执照

Satorix 软件包是根据LICENSE 文件中描述的条款发布的。