turistforeningen/sherpa

Sherpa

![Requirements Status]([***]

这是挪威徒步协会（DNT）基于Django开发的网站和内容管理系统（CMS）。

依赖要求

• Docker
• Docker Compose

配置

将DJANGO_CONFIGURATION环境变量设置为prod、staging或dev中的一个。更多详情请参考https://github.com/Turistforeningen/sherpa/blob/master/sherpa/settings.py%E3%80%82

环境变量

• SECRET_KEY_DEV: 为dev配置设置Django的SECRET_KEY

其他所有变量均为可选，若未定义相关功能将无法正常工作。如需查看完整变量列表，可执行类似grep -r "os.environ" sherpa/conf/的命令。

本地覆盖设置

若需应用不属于共享dev模块的私有设置，请将https://github.com/Turistforeningen/sherpa/blob/master/sherpa/conf/private.sample.py%E5%A4%8D%E5%88%B6%E5%88%B0%60sherpa/conf/private.py%60%E5%B9%B6%E5%AE%9A%E4%B9%89%E4%B8%AA%E4%BA%BA%E8%AE%BE%E7%BD%AE%E3%80%82%E8%AF%A5%E6%96%B0%E6%96%87%E4%BB%B6%E4%BC%9A%E8%A2%ABgit%E5%BF%BD%E7%95%A5%E3%80%82

安装

git clone git@github.com:Turistforeningen/sherpa.git
cd sherpa
git submodule update --init --recursive

秘密设置

Sherpa将所有秘密设置存储在git子模块中。请注意您需要有权限获取这些数据。为确保切换分支时能检出正确版本的秘密设置，请应用以下git钩子：

cp util/git_hooks/post-checkout .git/hooks/
cp util/git_hooks/post-merge .git/hooks/

使用Docker Compose初始化

以下命令可能需要一些时间完成：

docker-compose pull
docker-compose build --pull

# 导入数据库
docker-compose run --rm psql ./import.sh

# 安装构建器依赖
docker-compose run --rm builder npm install
docker-compose run --rm builder npm run grunt:build

# 启动nginx、gunicorn、postgres和构建器
docker-compose up -d
docker-compose logs [sherpa]

设置反向代理

推荐：使用https://github.com/Turistforeningen/docker-proxy%E3%80%82

或者，为匹配生产环境设置，使用sherpa-prod中的haproxy：

git clone git@github.com:Turistforeningen/sherpa-prod.git
cd sherpa-prod
git submodule update --init --recursive
docker-compose build haproxy
docker-compose create haproxy
docker-compose start haproxy

# 将haproxy的后端配置指向运行中的nginx容器
HAPROXY_CONTAINER=$(docker-compose ps -q haproxy)
cd ../sherpa
PORT=$(docker-compose port www 8080 | sed "s/0.0.0.0://")
docker exec -it ${HAPROXY_CONTAINER} ./route-backend.sh ${PORT}

配置本地主机名

为您的开发站点选择一个主机名，local.dnt.no是不错的选择，因为它不太可能在生产环境中使用，且符合SSL CN规范。

在/etc/hosts中将127.0.0.1指向该名称，然后从sherpa目录中，相应地编辑主站点的域名：

docker-compose run --rm sherpa ./manage.py sitedomain www.dnt.no local.dnt.no

现在您可以在浏览器中访问[***]

测试

make test