nossas/bonde-client

BONDE客户端镜像

镜像概述

BONDE客户端是一个基于React的Web应用程序镜像，集成Web服务器功能，用于BONDE生态系统的前端开发、测试与部署。该镜像支持容器化开发流程，便于团队协作和环境一致性。

核心功能

• 提供React应用的运行环境
• 支持本地开发与容器化部署
• 集成数据库迁移、种子数据填充功能
• 支持日志查看、容器交互等运维操作
• 兼容 staging 和 production 环境的自动部署

使用场景

• 前端开发人员进行本地开发与测试
• 团队协作中的容器化环境搭建
• BONDE项目的 staging 和 production 环境部署

配置说明

主机名设置

在开发环境中，需设置主机名以确保应用正常运行。可修改/etc/hosts添加以下内容：

127.0.0.1 app.bonde.devel bonde.devel api.bonde.devel data.bonde.devel db.devel keyval.devel meurio.bonde.org

Docker容器开发

依赖要求

• Git
• Docker（支持Debian和Mac OSX）
• Docker Compose

安装步骤

1. 克隆仓库：

bash
mkdir code/ && cd code/
git clone git@github.com:nossas/bonde-client.git
cd bonde-client

2. 创建并填充.env文件：

bash
touch .env
# 编辑.env文件添加所需环境变量

3. 启动容器：

bash
docker-compose up -d
docker-compose exec api-v1 rake db:migrate
docker-compose exec api-v1 rake db:seed
docker-compose restart api-v2
docker-compose run client yarn install

常用命令

• 查看客户端日志：docker-compose logs client -f
• 进入前端容器：docker-compose exec client /bin/bash
• 强制重建镜像：docker-compose up --build
• 重建node-sass：docker-compose exec client npm rebuild node-sass

数据库恢复

bash
export DSN_SRC=postgres://postgres:3x4mpl3@localhost:5432/bonde
export DSN_DEST=postgres://postgres:3x4mpl3@localhost:5432/bonde
./tools/restore-db.sh

本地开发（非容器）

依赖要求

• Yarn（可选）

安装与启动

bash
npm install
npm start

测试

bash
npm run test
# 测试单个文件可修改webpack.test.config.js的context行

部署

添加远程仓库：

bash
git remote add dokku dokku@server:0-client
git remote add dokku-prod dokku@server:0-client

推送至指定环境：

bash
git push dokku commithash:master  # staging环境
git push dokku-prod commithash:master  # production环境

相关链接

• Pivotal Tracker
• Invision
• Zeplin