Docker部署SuccBI

Docker 是一个开源的应用容器引擎，其一次编译多次使用的特性有助于快速一致地交付应用程序，了解更多请访问Docker官网 (opens new window)，本文介绍如何使用Docker部署SuccBI，步骤如下：

• 安装Docker{#install-docker}
• 拉取SuccBI镜像{#pull-succbi-image}
• 创建挂载目录{#mount-directory}
• 启动容器{#start-container}
• 常见问题{#problem}
  • 如何进入容器{#howto-enter-container}
  • 已启动的SuccBI容器如何升级镜像{#howto-update-image}

安装Docker

Docker安装部署请参考官方手册 (opens new window)

拉取SuccBI镜像

使用如下命令，拉取SuccBI镜像

docker pull registry.cn-hangzhou.aliyuncs.com/succbi/succbi:v4

下载完成后，可在本地Docker镜像列表中查看到REPOSITORY为registry.cn-hangzhou.aliyuncs.com/succbi/succbi:v4的镜像

docker images | grep succbi

创建挂载目录

SuccBI在运行过程中，会在工作目录中存放配置文件、上传文件等，而Docker容器重启后，会清空容器中的所有数据，因此需要将这些文件从宿主机挂载到容器中，挂载后容器对目录的修改会同步到宿主机中，保证了容器重启后，工作目录仍可以正常保留。

在宿主机创建如下内容：

1. clusters-share目录，路径为/docker/SuccBI/clusters-share
2. conf目录，路径为/docker/SuccBI/conf

可选：

1. 启动环境变量：可参考设置启动环境变量，镜像中已预设了基础配置，若需要增加其他配置可创建脚本，路径为/docker/SuccBI/dockerenv.sh

启动容器

运行如下命令，启动容器

docker run -it -d --name SuccBI -p 12345:8080 \
-v /docker/SuccBI/clusters-share:/opt/workdir/clusters-share \
-v /docker/SuccBI/conf:/opt/workdir/conf \
registry.cn-hangzhou.aliyuncs.com/succbi/succbi:v4

参数注释：

• --name：容器名称为SuccBI
• -p：将容器的8080端口映射到宿主机12345端口
• -v或--volume：将工作目录从宿主机挂载到容器中，用于数据持久化
• registry.cn-hangzhou.aliyuncs.com/succbi/succbi:v4：容器运行所使用的镜像

容器启动后，服务也会同步启动，至此，Docker下SuccBI部署已完成，访问http://宿主ip:12345 即可进入SuccBI

常见问题

如何进入容器

当容器中的服务出现异常时，可进入容器验证服务状态，查看日志等，具体步骤如下：

1. 获取容器ID和容器名称

   docker ps
   

   

2. 通过容器ID或容器名称进入容器

   docker exec -it CONTAINER ID/NAMES /bin/bash
   

已启动的SuccBI容器如何升级镜像

SuccBI镜像版本发布与稳定版保持一致，升级Docker中已配置SuccBI步骤如下：

1. 拉取最新的SuccBI镜像

   docker pull registry.cn-hangzhou.aliyuncs.com/succbi/succbi:v4
   

2. 停止并删除当前的SuccBI容器

   docker stop SuccBI
   docker rm SuccBI
   

3. 启动容器

   docker run -it -d --name SuccBI -p 12345:8080 \
   -v /docker/SuccBI/clusters-share:/opt/workdir/clusters-share \
   -v /docker/SuccBI/conf:/opt/workdir/conf \
   registry.cn-hangzhou.aliyuncs.com/succbi/succbi:v4