bisheng系列（一）- 本地部署（Docker）
目录
一、导读
二、说明
1、镜像说明
2、本节内容
三、docker部署
1、克隆代码
2、运行镜像
3、可能的错误信息
四、页面测试
1、注册用户
2、登陆成功
3、添加模型
一、导读
环境：Ubuntu 24.04、Windows 11、WSL 2、Python 3.10 、bisheng 1.1.1
背景：需要bisheng二开商用，故而此处进行本地部署，便于后期调试开发
时间：20250519
说明：根据官方的教程，进行docker部署并登陆成功
注意：本节仅使用docker部署，后面会说明前后端代码运行部署，其他使用docker部署。其中用到的端口较多，请确保端口未处于使用状态
git代码地址：BISHENG github地址链接
官方文档地址：BISHENG - 私有化部署
二、说明
1、镜像说明
bisheng的docker镜像共有九个， 分别如下：
| 序号 | 镜像组件名称 | 镜像组件版本 |
|---|---|---|
| 1 | backed | 1.1.1 |
| 2 | frontend | 1.1.1 |
| 3 | redis | 7.0.4 |
| 4 | MySQL | 8.0 |
| 5 | milvus | 2.3.3 |
| 6 | minio | 2023-03-20T20-16-18Z |
| 7 | onlyoffice | 7.1.1 |
| 8 | elasticsearch | 8.12.0 |
| 9 | etcd | 3.5.5 |
上述内容源于下图
2、本节内容
本节内容计划实现的是：根据官方文档，实现docker部署并运行
docker部署使用Ubuntu（Ubuntu已安装docker），后期的前后端分离部署使用open Euler
由于官方1.2.0版本（dev）支持python >=3.10，而1.1.1版本支持python >= 3.9，所以使用Open Euler 23.03版本，该版本默认的python版本为3.10
三、docker部署
docker安装参考：Linux子系统安装docker-engine，国内镜像_engine如何在linux安装-CSDN博客
1、克隆代码
# 如果系统中有git命令，可以直接下载毕昇代码
git clone https://github.com/dataelement/bisheng.git
# 进入安装目录
cd bisheng/docker# 如果系统没有没有git命令，可以下载毕昇代码zip包
wget https://github.com/dataelement/bisheng/archive/refs/heads/main.zip
# 解压并进入安装目录
unzip main.zip && cd bisheng-main/docker2、运行镜像
docker-compose up -d此时会报错，如下：
jack@Laptop-L14-gen4:~/bisheng-blog/bisheng/docker/bisheng-main/docker$ docker-compose up -d
ERROR: The Compose file './docker-compose.yml' is invalid because:
services.office.environment.JWT_ENABLED contains false, which is an invalid type, it should be a string, number, or a null
修改docker-com文件的48行，在false上加上双引号如下：
46 environment:47 TZ: Asia/Shanghai48 JWT_ENABLED: "false"再次运行，出现如下界面：
3、可能的错误信息
jack@Laptop-L14-gen4:~/bisheng-blog/bisheng/docker$ docker-compose up -d
Recreating 5be896b66630_bisheng-mysql ...
Recreating 9f92111be526_milvus-minio ...
Recreating 70b6a9c7768d_milvus-etcd ...
Recreating 0ff268aad0df_bisheng-office ...
Recreating 76538f98c046_bisheng-redis ...
Recreating d0f47f49074d_bisheng-es ...ERROR: for 5be896b66630_bisheng-mysql 'ContainerConfig'ERROR: for 9f92111be526_milvus-minio 'ContainerConfig'ERROR: for 70b6a9c7768d_milvus-etcd 'ContainerConfig'ERROR: for 0ff268aad0df_bisheng-office 'ContainerConfig'ERROR: for 76538f98c046_bisheng-redis 'ContainerConfig'ERROR: for d0f47f49074d_bisheng-es 'ContainerConfig'ERROR: for mysql 'ContainerConfig'ERROR: for minio 'ContainerConfig'ERROR: for etcd 'ContainerConfig'ERROR: for office 'ContainerConfig'ERROR: for redis 'ContainerConfig'ERROR: for elasticsearch 'ContainerConfig'
Traceback (most recent call last):File "/usr/bin/docker-compose", line 33, in <module>sys.exit(load_entry_point('docker-compose==1.29.2', 'console_scripts', 'docker-compose')())^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^File "/usr/lib/python3/dist-packages/compose/cli/main.py", line 81, in maincommand_func()File "/usr/lib/python3/dist-packages/compose/cli/main.py", line 203, in perform_commandhandler(command, command_options)File "/usr/lib/python3/dist-packages/compose/metrics/decorator.py", line 18, in wrapperresult = fn(*args, **kwargs)^^^^^^^^^^^^^^^^^^^File "/usr/lib/python3/dist-packages/compose/cli/main.py", line 1186, in upto_attach = up(False)^^^^^^^^^File "/usr/lib/python3/dist-packages/compose/cli/main.py", line 1166, in upreturn self.project.up(^^^^^^^^^^^^^^^^File "/usr/lib/python3/dist-packages/compose/project.py", line 697, in upresults, errors = parallel.parallel_execute(^^^^^^^^^^^^^^^^^^^^^^^^^^File "/usr/lib/python3/dist-packages/compose/parallel.py", line 108, in parallel_executeraise error_to_reraiseFile "/usr/lib/python3/dist-packages/compose/parallel.py", line 206, in producerresult = func(obj)^^^^^^^^^File "/usr/lib/python3/dist-packages/compose/project.py", line 679, in doreturn service.execute_convergence_plan(^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^File "/usr/lib/python3/dist-packages/compose/service.py", line 579, in execute_convergence_planreturn self._execute_convergence_recreate(^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^File "/usr/lib/python3/dist-packages/compose/service.py", line 499, in _execute_convergence_recreatecontainers, errors = parallel_execute(^^^^^^^^^^^^^^^^^File "/usr/lib/python3/dist-packages/compose/parallel.py", line 108, in parallel_executeraise error_to_reraiseFile "/usr/lib/python3/dist-packages/compose/parallel.py", line 206, in producerresult = func(obj)^^^^^^^^^File "/usr/lib/python3/dist-packages/compose/service.py", line 494, in recreatereturn self.recreate_container(^^^^^^^^^^^^^^^^^^^^^^^^File "/usr/lib/python3/dist-packages/compose/service.py", line 612, in recreate_containernew_container = self.create_container(^^^^^^^^^^^^^^^^^^^^^^File "/usr/lib/python3/dist-packages/compose/service.py", line 330, in create_containercontainer_options = self._get_container_create_options(^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^File "/usr/lib/python3/dist-packages/compose/service.py", line 921, in _get_container_create_optionscontainer_options, override_options = self._build_container_volume_options(^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^File "/usr/lib/python3/dist-packages/compose/service.py", line 960, in _build_container_volume_optionsbinds, affinity = merge_volume_bindings(^^^^^^^^^^^^^^^^^^^^^^File "/usr/lib/python3/dist-packages/compose/service.py", line 1548, in merge_volume_bindingsold_volumes, old_mounts = get_container_data_volumes(^^^^^^^^^^^^^^^^^^^^^^^^^^^File "/usr/lib/python3/dist-packages/compose/service.py", line 1579, in get_container_data_volumescontainer.image_config['ContainerConfig'].get('Volumes') or {}~~~~~~~~~~~~~~~~~~~~~~^^^^^^^^^^^^^^^^^^^
KeyError: 'ContainerConfig'如出现上述错误信息，查看是否存在容器（运行与停止的），如下：
jack@Laptop-L14-gen4:~/bisheng-blog/bisheng/docker$ docker ps -a
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
75bcb85e2b89 dataelement/bisheng-frontend:v1.1.1 "/docker-entrypoint.…" 40 hours ago Exited (0) 11 minutes ago bisheng-frontend
385f2dba3966 dataelement/bisheng-backend:v1.1.1 "sh entrypoint.sh" 40 hours ago Exited (137) 11 minutes ago bisheng-backend
640ad23afa2b milvusdb/milvus:v2.3.3 "/tini -- milvus run…" 40 hours ago Exited (0) 11 minutes ago milvus-standalone
9f92111be526 minio/minio:RELEASE.2023-03-20T20-16-18Z "/usr/bin/docker-ent…" 40 hours ago Exited (0) 11 minutes ago 9f92111be526_milvus-minio
70b6a9c7768d quay.io/coreos/etcd:v3.5.5 "etcd -advertise-cli…" 40 hours ago Exited (0) 11 minutes ago 70b6a9c7768d_milvus-etcd
76538f98c046 redis:7.0.4 "docker-entrypoint.s…" 40 hours ago Exited (0) 11 minutes ago 76538f98c046_bisheng-redis
5be896b66630 mysql:8.0 "docker-entrypoint.s…" 40 hours ago Exited (0) 11 minutes ago 5be896b66630_bisheng-mysql
0ff268aad0df onlyoffice/documentserver:7.1.1 "/app/ds/run-documen…" 40 hours ago Exited (137) 11 minutes ago 0ff268aad0df_bisheng-office
d0f47f49074d bitnami/elasticsearch:8.12.0 "/opt/bitnami/script…" 40 hours ago Exited (143) 11 minutes ago d0f47f49074d_bisheng-es
5257cf9b2426 qdrant/qdrant "./entrypoint.sh" 3 weeks ago Exited (255) 2 weeks ago 0.0.0.0:6333-6334->6333-6334/tcp, :::6333-6334->6333-6334/tcp distracted_lamport
b28179c3b79b qdrant/qdrant "./entrypoint.sh" 3 weeks ago Exited (255) 3 weeks ago 0.0.0.0:6333-6334->6333-6334/tcp, :::6333-6334->6333-6334/tcp bold_beaver
b00d21f614f7 hello-world "/hello" 3 weeks ago Exited (0) 3 weeks ago objective_khayyam
114b2a816fae ubuntu1:8080 "/bin/sh -c 'npm i &…" 7 weeks ago Exited (255) 7 weeks ago 0.0.0.0:8080->8080/tcp, :::8080->8080/tcp light_house该问题出自容器ID重复（bisheng的9个容器ID始终不变），当启动后，存在停止的容器，导致docker-compose启动镜像失败
在当前目录下执行：
docker-compose down该命令实现了关闭容器并删除的功能
四、页面测试
1、注册用户
地址：localhost:3001
2、登陆成功
3、添加模型
五、结语
1、小结
本文完全按照官方文档进行部署，难度基本不存在。因部分bug存在，以及改内容是下一节的基础，故而此处进行了简单记录
2、后续内容
下一节想要实现的功能如下：
1、代码运行bisheng后端，使用vscode实现
2、前端代码使用nginx运行
3、其余组件使用docker-compose运行
这样就可以实现真实的开发环境