
stevenweathers/thunderdome-planning-pokerThunderdome是一款开源敏捷规划扑克工具,主题为“为点数而战”,旨在帮助团队估算用户故事。
!image
docker pull stevenweathers/thunderdome-planning-poker
。添加新语言只需以下步骤:
frontend/public/lang/default/和frontend/public/lang/friendly/目录中添加语言字典JSON文件,可复制en.json并修改所有键的值。frontend/config.js中locales对象的切换器组件使用的语言列表中。Thunderdome可通过环境变量或yaml配置文件config.yaml进行配置,配置文件可位于以下路径之一:
/etc/thunderdome/$HOME/.config/thunderdome/以下是可用的配置选项:
| 选项 | 环境变量 | 描述 | 默认值 |
|---|---|---|---|
http.cookie_hashkey | COOKIE_HASHKEY | 用于确保安全cookie安全的密钥 | strongest-avenger |
http.port | PORT | 监听HTTP连接的端口 | 8080 |
http.secure_cookie | COOKIE_SECURE | 是否使用安全cookie | true |
http.domain | APP_DOMAIN | Thunderdome实例的域名/基础URL,用于创建邮件中的URL | thunderdome.dev |
analytics.enabled | ANALYTICS_ENABLED | 启用/禁用谷歌分析 | true |
analytics.id | ANALYTICS_ID | 谷歌分析标识符 | UA-***-1 |
db.host | DB_HOST | 数据库主机名 | db |
db.port | DB_PORT | 数据库端口号 | 5432 |
db.user | DB_USER | 数据库用户ID | thor |
db.pass | DB_PASS | 数据库用户密码 | odinson |
db.name | DB_NAME | 数据库实例名 | thunderdome |
db.sslmode | DB_SSLMODE | 数据库SSL模式(disable、allow、prefer、require、verify-ca、verify-full) | disable |
smtp.host | SMTP_HOST | SMTP服务器主机名 | localhost |
smtp.port | SMTP_PORT | SMTP服务器端口号 | 25 |
smtp.secure | SMTP_SECURE | 是否与SMTP服务器进行身份验证 | true |
smtp.identity | SMTP_IDENTITY | SMTP服务器授权标识,通常不设置 | |
smtp.sender | SMTP_SENDER | Thunderdome发送邮件的发件人地址 | *** |
config.allowedPointValues | CONFIG_POINTS_ALLOWED | 创建战斗时可用的点数列表 | 0, 1/2, 2, 3, 5, 8, 13, 20, 40, 100, ? |
config.defaultPointValues | CONFIG_POINTS_DEFAULT | 新战斗默认选择的点数列表 | 1, 2, 3, 5, 8 , 13, ? |
config.show_warrior_rank | CONFIG_SHOW_RANK | 是否在战斗中显示勇士等级图标 | false |
config.avatar_service | CONFIG_AVATAR_SERVICE | 使用的头像服务,可选值见下一段落 | default |
config.toast_timeout | CONFIG_TOAST_TIMEOUT | 通知自动隐藏的毫秒数 | 1000 |
config.allow_guests | CONFIG_ALLOW_GUESTS | 是否允许访客(***)用户 | true |
config.allow_registration | CONFIG_ALLOW_REGISTRATION | 是否允许用户注册(管理员外) | true |
config.allow_jira_import | CONFIG_ALLOW_JIRA_IMPORT | 是否允许从JIRA XML导入计划 | true |
config.default_locale | CONFIG_DEFAULT_LOCALE | UI的默认语言 | en |
config.friendly_ui_verbs | CONFIG_FRIENDLY_UI_VERBS | 是否使用更友好的UI术语(如“用户”而非“勇士”,适合企业环境) | false |
auth.method | 身份验证方式,可选normal或ldap,详见LDAP配置部分 | normal |
使用下表中的名称配置服务,若未设置则使用default。每个服务提供进一步的配置选项,勇士可在个人资料页面进行配置。配置服务后,将显示不同样式的下拉菜单。下表显示所有支持的服务及其样式(均使用ID ead26688-5148-4f3c-a35d-1b0117b4f2a9生成头像示例):
| 名称 | |||||||||
|---|---|---|---|---|---|---|---|---|---|
default | |||||||||
| !image | |||||||||
dicebear | male | female | human | identicon | bottts | avataaars | jdenticon | gridy | code |
| !image | !image | !image | !image | !image | !image | !image | !image | !image | |
gravatar | mp | identicon | monsterid | wavatar | retro | robohash | |||
| !image | !image | !image | !image | !image | !image | ||||
robohash | set1 | set2 | set3 | set4 | |||||
| !image | !image | !image | !image |
当auth.method设为ldap时,创建账户功能将被禁用,身份验证通过LDAP进行。若LDAP服务器成功验证新用户,Thunderdome将自动生成用户资料。
以下是LDAP身份验证方式的特定配置选项:
| 选项 | 描述 |
|---|---|
auth.ldap.url | LDAP服务器URL,通常格式为ldap://host:port |
auth.ldap.use_tls | 建立初始连接后是否创建TLS连接 |
auth.ldap.bindname | 连接LDAP的绑定名称/绑定DN,留空表示不进行身份验证 |
auth.ldap.bindpass | 绑定用户的密码 |
auth.ldap.basedn | 用户搜索的基准DN |
auth.ldap.filter | 用户登录ID的搜索过滤器,详见下文 |
auth.ldap.mail_attr | 包含用户电子邮件地址的LDAP属性 |
默认过滤器为(&(objectClass=posixAccount)(mail=%s)),过滤器中必须包含%s,将被用户登录ID替换。mail_attr配置选项必须指向包含用户电子邮件地址的LDAP属性,默认为mail。cn_attr配置选项必须指向包含用户全名的LDAP属性,默认为cn。
在Linux上,可通过命令行测试参数:
ldapsearch -H auth.ldap.url [-Z] -x [-D auth.ldap.bindname -W] -b auth.ldap.basedn 'auth.ldap.filter' dn auth.ldap.mail auth.ldap.cn
仅当auth.ldap.use_tls设为true时使用-Z,仅当设置了auth.ldap.bindname时使用-D和-W参数。
运行服务器并访问 http://localhost:8080
manifest unknown 错误
TLS 证书验证失败
DNS 解析超时
410 错误:版本过低
402 错误:流量耗尽
身份认证失败错误
429 限流错误
凭证保存错误
来自真实用户的反馈,见证轩辕镜像的优质服务