dazoakley/bandiera

Bandiera

镜像概述和主要用途

Bandiera是一个简单的独立功能标志服务，所有通信通过REST API进行，不绑定任何现有Web框架或编程语言。它提供简洁的Web界面，用于设置和配置功能标志，帮助开发者实现功能的动态控制，如A/B测试、渐进式发布等场景。

核心功能和特性

• 独立部署：无需依赖特定Web框架或语言，可作为独立服务运行
• REST API通信：通过标准REST API与客户端应用交互，方便集成
• Web管理界面：提供直观的Web界面用于配置和管理功能标志
• 多语言客户端支持：提供Ruby、Node、Scala、PHP等多种语言的客户端库
• 数据库兼容性：支持MySQL和PostgreSQL数据库存储配置

Bandiera客户端库

• Ruby - https://github.com/springernature/bandiera-client-ruby
• Node - https://github.com/springernature/bandiera-client-node
• Scala - https://github.com/springernature/bandiera-client-scala
• PHP - https://github.com/springernature/bandiera-client-php

部署方法

生产环境部署

推荐通过Docker在生产环境中运行Bandiera，仅需依赖MySQL或PostgreSQL数据库。

Docker运行命令

bash
docker run -e DATABASE_URL='postgres://user:password@host:port/database' -p 5000:5000 docker.io/dazoakley/bandiera

环境变量说明

• DATABASE_URL：数据库连接字符串，遵循Sequel连接格式，例如：
  • PostgreSQL: postgres://user:password@localhost/bandiera
  • MySQL: mysql2://user:password@localhost/bandiera

开发者环境设置

依赖要求

• Ruby（版本见项目根目录.ruby-version文件）
• bundler
• http://phantomjs.org/%EF%BC%88%E7%94%A8%E4%BA%8E%E6%B5%8B%E8%AF%95%E5%A5%97%E4%BB%B6%EF%BC%89

数据库准备

1. 准备空的MySQL或PostgreSQL数据库 schema
2. 设置数据库连接环境变量：

   bash
   export DATABASE_URL='postgres://bandiera:bandiera@localhost/bandiera'
   

3. （可选）使用docker-compose启动PostgreSQL：

   bash
   docker-compose up -d db
   

应用启动步骤

bash
# 安装依赖
bundle install

# 数据库迁移
bundle exec rake db:migrate

# 启动应用服务器（端口5000）
bundle exec shotgun -p 5000 -s puma

启动后，可通过[***]

运行测试

bash
# 执行测试套件
bundle exec rspec

# 或使用Guard进行持续测试
bundle exec guard -i -p -l 1

其他文档

更多文档请参见https://github.com/dazoakley/bandiera/wiki

许可证

© 2015, Springer Nature
Bandiera采用http://www.gnu.org/licenses/gpl-3.0.html许可。