7、FinChat单机体验一键部署文档
-
在部署服务之前,需要每台机器都安装Docker以及Docker Compose。
推荐服务器最低配置如下:
项目 参数 服务器参数 CPU:2核、内存:4G、硬盘:50G 服务器数量 1台 操作系统 Ubuntu-14.03 LTS / Mac OS 10.12 / windows 10 以上 容器环境 Docker v1.12.3、docker-compose v1.9.0 注意
- 以下步骤1和步骤2为基础软件依赖,如果部署服务器已经安装了docker和docker-compose则可以跳过步骤1和步骤2。
- FinChat服务对于任何运行有docker(>1.12),docker-compose(>1.9.0)版本的机器都可以部署。
1.安装Docker
linux
curl https://releases.rancher.com/install-docker/1.12.sh | sh
将用户名添加到docker组里,your-username需替换成实际的用户名:
sudo usermod -aG docker your-username
然后退出重新登陆服务器使之生效。
macOS
下载安装镜像 https://download.docker.com/mac/stable/Docker.dmg
windows
下载安装镜像 https://download.docker.com/win/stable/Docker for Windows Installer.exe
安装完成后使用以下命令验证docker版本是否正确:
docker version
2.安装Docker Compose
linux
下载docker-compose版本到本地并安装
curl -LJO https://github.com/docker/compose/releases/download/1.22.0/docker-compose-Linux-x86_64
修改权限
mv docker-compose-Linux-x86_64 /usr/local/bin/docker-compose chmod +x /usr/local/bin/docker-compose
macOS
curl -LJO https://github.com/docker/compose/releases/download/1.22.0/docker-compose-Darwin-x86_64
windows
curl -LJO https://github.com/docker/compose/releases/download/1.22.0/docker-compose-Windows-x86_64.exe
安装完成后在命令行中输入docker-compose version 查看当前安装的版本是否正确:
docker-compose version
3.配置镜像加速器(可选)
因国内网络从dockerhub仓库拉取镜像比较慢,如有需要,可以注册阿里云或其他提供镜像加速器服务的云服务提供商,然后获取镜像加速器地址,下文以阿里云镜像加速器为例,简要说明如何配置镜像加速器:
注意:下文中的加速器地址<your accelerate address>,请到阿里云容器镜像服务控制台(https://cr.console.aliyun.com/?spm=a2c4g.11186623.2.4.g7DNRf) 查看并替换。
Linux操作系统
可以通过修改daemon配置文件/etc/docker/daemon.json来使用加速器:
sudo mkdir -p /etc/docker sudo tee /etc/docker/daemon.json <<-'EOF' { "registry-mirrors": ["<your accelerate address>"] } EOF sudo systemctl daemon-reload sudo systemctl restart docker
MacOS / Windows操作系统
针对安装了 Docker 的用户,您可以参考以下配置步骤:
右键点击桌面任务栏的 docker 图标,选择 Preferences ,在 Daemon 标签(Docker 17.03 之前版本为 Advanced 标签)下的 Registry mirrors 列表中将
<your accelerate address>加到registry-mirrors的数组里 ,
点击Apply & Restart按钮,等待Docker重启并应用配置的镜像加速器。
4.下载安装包
请到以下地址下载deploy.zip安装包:
https://www.finogeeks.com/#/download
里面包含了以下文件:
5.解压并修改配置文件
进入安装包存储路径并解压安装包:
cd <安装包存储路径> unzip deploy.zip
进入安装包目录并修改docker-compose文件
cd deploy vi docker-compose.yml
然后修改ip地址为本机的ip地址+8000端口:
如127.0.0.1:8000
因FinChat服务默认使用8000端口作为外部暴露端口,如端口已占用请自行修改docker-compose中gateway的暴露端口,并同步替换上文修改的ip中的platform-api端口:
修改init.sh文件
替换以下接口中的IP地址及端口,与docker-compose文件中修改的地址一致:
6.启动FinChat服务
切换至安装包目录用以下命令启动服务
docker-compose up -d
至此 , FinChat 后台服务已启用完毕,以下可以下载FinChat App进行体验,也可以在凡泰极客开源社区下载FinChat SDK Demo进行编译运行体验。
7、登录App
如果你已经做了私有化部署,那么你需要重新配置地址:
电脑端网页打开http://FinChat服务部署地址:8000/api/v1/platform/qrcode
打开App后,请点击右上角设置,选择“扫一扫”,扫描网页的二维码即可完成服务器配置,也可手动输入服务器地址;在登录页填写符合规则(只允许小写字母、数字和下划线,首位需字母)的任意四位以上账号,六位以上密码进行登录;