操作系统为Centos 7
(1)安装Docker
登录本地服务器,切换到root用户,使用以下命令进行安装
yum install docker
(2)启动Docker服务
启动命令如下所示
service docker start
(3)设置Docker服务为开机启动
设置命令如下
chkconfig docker on
(4)借助yum命令,安装git
安装命令如下所示
yum install git
(5)安装ShowDoc
从GitHub上复制代码到本地某个目录,这里进入根目录下的test文件夹。
cd /test
git clone -o gitbug https://github.com/stat7th/showdoc
(6)进入ShowDoc目录开始安装
cd showdoc/
docker build -t showdoc ./
docker run - d - -name showdoc -p 4999:80 showdoc
注:如果想在不同端口启动,请修改4999为其他端口。
(7)访问ShowDoc
在浏览器中 输入网址 http://192.168.132.132:4999/install/,打开如图1-5下(注:将IP地址及端口号替换成用户自己服务器的IP地址及步骤(6)中设置的端口号)
选择语言(默认中文),单击OK按钮,弹出安装成功提示框,如图1-6所示。
然后按照提示信息删除/install目录,使用如下命令进行删除(其中的XXX为install路径)
rm -rf xxx/install
(8)备份
API文档是非常重要的文档,需定期备份。/XXX/showdoc/Sqlite下有个showdoc.db.php文件,定期备份该文件即可。
用户可以采用手动命令备份,使用如下命令
e.g.mv /xxx/showdoc/Sqlite/showdoc.db.php /test/showdoc.db.php.bak
上面示例将showdoc.db.php文件重命名为showdoc.db.php.bak文件保存在/test目录下,也可以额编写自动化备份脚本定期备份。
注:Docker是一个开源的应用容器引擎,让开发者可以打包他们的应用及依赖到一个可移植的容器中,然后发布在Linux系统上,也可以实现虚拟化。容器使用沙箱机制,相互之间不会有任何接口。