一个用于使用conda安装和配置Nginx的Buildout配方。
项目描述
简介
birdhousebuilder.recipe.nginx 是一个 Buildout 配方，用于从 Anaconda 通道安装 Nginx 并部署您的应用程序的站点配置。此配方由 Birdhouse 项目使用。
用法
此配方要求Anaconda已安装。您可以使用buildout选项 anaconda-home 设置conda安装的前缀。否则，将使用环境变量 CONDA_PREFIX（在激活conda环境时设置变量）作为conda前缀。
该配方将在由 CONDA_PREFIX 定义的conda环境中从conda通道安装 nginx 软件包。安装文件夹由 prefix buildout选项指定。它将部署您的应用程序的Nginx站点配置。配置将在 ${prefix}/etc/nginx/conf.d/myapp.conf 中部署。您可以使用 ${prefix}/etc/init.d/nginx start 启动Nginx。
该配方依赖于 birdhousebuilder.recipe.conda 和 zc.recipe.deployment。
支持选项
此配方支持以下选项
- anaconda-home
指向Anaconda安装根目录的Buildout选项。默认值：$HOME/anaconda。
程序部分的Buildout部分选项
- prefix
部署选项，用于设置安装文件夹的前缀。默认值：/
- 用户
部署选项，用于设置运行用户。
- etc-user
部署选项，用于设置/etc目录的用户。默认：root
- 名称
您应用程序的名称。
- 输入
指向带有您应用程序Nginx配置的Mako模板的路径。
- worker-processes
启动的工作进程数（使用auto表示动态值）。默认：1
- keepalive-timeout
在keep-alive客户端连接在服务器端保持打开时的超时。默认：5s
- 组织
证书的组织名称。默认：Birdhouse
- 组织单位
证书的组织单位。默认：Demo
- ssl-verify-client
Nginx选项，用于验证SSL客户端证书。可能值：off（默认），on，optional。[链接](https://nginx.ac.cn/en/docs/http/ngx_http_ssl_module.html#ssl_verify_client)
- ssl-client-certificate
Nginx选项，指定客户端CA证书的捆绑包名称。默认：esgf-ca-bundle.crt。[链接](https://nginx.ac.cn/en/docs/http/ngx_http_ssl_module.html#ssl_client_certificate)
- ssl-client-certificate-url
可选的URL，用于下载客户端证书的CA证书捆绑包。默认：https://github.com/ESGF/esgf-dist/raw/master/installer/certs/esgf-ca-bundle.crt
所有其他选项都可以用作您的Nginx站点配置中的参数。
示例用法
以下示例buildout.cfg安装Nginx，并为myapp配置了站点。
[buildout]
parts = myapp_nginx
anaconda-home = /opt/anaconda
[myapp_nginx]
recipe = birdhousebuilder.recipe.nginx
name = myapp
prefix = /
user = www-data
input = ${buildout:directory}/templates/myapp_nginx.conf
hostname = localhost
port = 8081
您的Nginx配置的示例Mako模板可能如下所示
upstream myapp {
server unix:///tmp/myapp.socket fail_timeout=0;
}
server {
listen ${port};
server_name ${hostname};
root ${prefix}/var/www;
index index.html index.htm;
location / {
# checks for static file, if not found proxy to app
try_files $uri @proxy_to_phoenix;
}
location @proxy_to_phoenix {
proxy_pass http://myapp;
}
}
birdhousebuilder.recipe.nginx-0.4.2.tar.gz的散列值
| 算法 | 散列摘要 | |
|---|---|---|
| SHA256 | 6a929fca3764d06eebda47d9258235f8e678376b7ecc59be8826e33254378320 |
|
| MD5 | 62d8e1a83a300f5b8ae5c8563705e655 |
|
| BLAKE2b-256 | d618e90859f1b83d528b66ad03173e70769849044e72a460e2f2285192a4bde4 |
