【云原生之Docker实战】使用Docker部署ShowDoc文档工具

一、ShowDoc介绍
- 1.ShowDoc简介
- 2.ShowDoc功能
二、检查docker版本
三、检查docker状态
四、下载ShowDoc镜像
五、创建ShowDoc容器
- 1.创建数据目录
- 2目录授权
- 3.运行ShowDoc容器
- 4.查看ShowDoc容器状态
- 5.查看容器运行日志
六、ShowDoc初始化
- 1.选择语言
- 2.查看初始化结果
七、登录署ShowDoc
- 1.进入ShowDoc登录页
- 2.登录ShowDoc首页
八、ShowDoc的基本使用
- 1.进入后台管理界面
- 2.新建项目
- 3.新建与编辑文档
- 4.团队管理

一、ShowDoc介绍

1.ShowDoc简介

ShowDoc是一个非常适合IT团队的在线API文档、技术文档工具。通过showdoc，你可以方便地使用markdown语法来书写出美观的API文档、数据字典文档、技术文档、在线excel文档等等。

2.ShowDoc功能

分享与导出

响应式网页设计，可将项目文档分享到电脑或移动设备查看。同时也可以将项目导出成word文件，以便离线浏览。

权限管理

1.公开项目与私密项目：ShowDoc上的项目有公开项目和私密项目两种。公开项目可供任何登录与非登录的用户访问，而私密项目则需要输入密码验证访问。密码由项目创建者设置。
2.项目转让：项目创建者可以自由地把项目转让给网站的其他用户。
3.项目成员：你可以很方便地为ShowDoc的项目添加、删除项目成员。项目成员可以对项目进行编辑，但不可转让或删除项目（只有项目创建者才有权限）。
4.团队管理：利用showdoc的团队功能你可以更好地进行团队协作。

编辑功能

1.markdown编辑：ShowDoc采用markdown编辑器，无论是编辑还是阅读体验都极佳很棒。
2.模板插入：在ShowDoc的编辑页面，点击编辑器上方的按钮可方便地插入API接口模板和数据字典模板。
3.历史版本:ShowDoc为页面提供历史版本功能，你可以方便地把页面恢复到之前的版本。

多平台

showdoc支持网页版、手机app版和电脑客户端版。客户端地址可见：https://www.showdoc.com.cn/clients。

自动化

1.可从代码注释中自动生成文档。
2.搭配的RunApi客户端，可调试接口和自动生成文档。

二、检查docker版本

[root@docker ~]# docker version
Client: Docker Engine - CommunityVersion:           20.10.18API version:       1.41Go version:        go1.18.6Git commit:        b40c2f6Built:             Thu Sep  8 23:14:08 2022OS/Arch:           linux/amd64Context:           defaultExperimental:      trueServer: Docker Engine - CommunityEngine:Version:          20.10.18API version:      1.41 (minimum version 1.12)Go version:       go1.18.6Git commit:       e42327aBuilt:            Thu Sep  8 23:12:21 2022OS/Arch:          linux/amd64Experimental:     falsecontainerd:Version:          1.6.8GitCommit:        9cd3357b7fd7218e4aec3eae239db1f68a5a6ec6runc:Version:          1.1.4GitCommit:        v1.1.4-0-g5fd4c4ddocker-init:Version:          0.19.0GitCommit:        de40ad0

三、检查docker状态

[root@docker showdoc]# ls
[root@docker showdoc]# systemctl status docker
● docker.service - Docker Application Container EngineLoaded: loaded (/usr/lib/systemd/system/docker.service; enabled; vendor preset: disabled)Active: active (running) since Sun 2022-10-23 19:15:37 CST; 3h 21min agoDocs: https://docs.docker.comMain PID: 9693 (dockerd)Tasks: 51Memory: 1.5GCGroup: /system.slice/docker.service

四、下载ShowDoc镜像

[root@docker showdoc]# docker pull star7th/showdoc
Using default tag: latest
latest: Pulling from star7th/showdoc
59bf1c3509f3: Pull complete
7c7da25b2876: Pull complete
2bc599114627: Pull complete
927a0b37a45a: Pull complete
1766f36e2432: Pull complete
4c13e0891ac6: Pull complete
2cec0bbb4ba9: Pull complete
b36e8fdf0264: Pull complete
387739aab6be: Pull complete
d73f4116d27c: Pull complete
ac2614199456: Pull complete
8cf23d77585a: Pull complete
2595abc0c000: Pull complete
e19d5b33c59c: Pull complete
3c91138e3b38: Pull complete
e1e2f7050886: Pull complete
ddf7a600aa8d: Pull complete
c21a6cac05ae: Pull complete
4ee11851e20a: Pull complete
5a9839199e80: Pull complete
b6f89a4d0e50: Pull complete
f7a113ae7a21: Pull complete
afe348e7bc07: Pull complete
7d4f658c188c: Pull complete
1949b55bfafc: Pull complete
18fc12f9ed58: Pull complete
debcc98cda0a: Pull complete
313c4ac392fa: Pull complete
654d7595e577: Pull complete
e35254510d69: Pull complete
4e973aacee4d: Pull complete
Digest: sha256:5ab4cec5e2e0c75d02e62c924a0457fc2751c1ce8f056f30f2920f88d431de39
Status: Downloaded newer image for star7th/showdoc:latest
docker.io/star7th/showdoc:latest

五、创建ShowDoc容器

1.创建数据目录

mkdir -p /data/showdoc/html

2目录授权

[root@docker showdoc]# chmod -R 777 /data/showdoc/
[root@docker showdoc]#

3.运行ShowDoc容器

[root@docker showdoc]# docker run -d --name showdoc --user=root --privileged=true -p 4999:80 \
> --restart always -v /data/showdoc/html:/var/www/html/ star7th/showdoc
56c200dbb93e621d20258624a05c39e110beb8261e86fcac30a95a75d3074578

4.查看ShowDoc容器状态

[root@docker showdoc]# docker ps
CONTAINER ID   IMAGE                 COMMAND                  CREATED          STATUS          PORTS                                                      NAMES
56c200dbb93e   star7th/showdoc       "/entrypoint /bin/sh…"   23 seconds ago   Up 22 seconds   443/tcp, 9000/tcp, 0.0.0.0:4999->80/tcp, :::4999->80/tcp   showdoc

5.查看容器运行日志

[root@docker showdoc]# docker logs showdoc
/usr/lib/python3.9/site-packages/supervisor/options.py:474: UserWarning: Supervisord is running as root and it is searching for its configuration file in default locations (including its current working directory); you probably want to specify a "-c" argument specifying an absolute path to a configuration file for improved security.self.warnings.warn(
2022-10-23 14:50:21,648 CRIT Supervisor is running as root.  Privileges were not dropped because no user is specified in the config file.  If you intend to run as root, you can set user=root in the config file to avoid this message.
2022-10-23 14:50:21,649 INFO Included extra file "/opt/docker/etc/supervisor.d/cron.conf" during parsing
2022-10-23 14:50:21,649 INFO Included extra file "/opt/docker/etc/supervisor.d/dnsmasq.conf" during parsing
2022-10-23 14:50:21,649 INFO Included extra file "/opt/docker/etc/supervisor.d/nginx.conf" during parsing
2022-10-23 14:50:21,649 INFO Included extra file "/opt/docker/etc/supervisor.d/php-fpm.conf" during parsing
2022-10-23 14:50:21,649 INFO Included extra file "/opt/docker/etc/supervisor.d/postfix.conf" during parsing
2022-10-23 14:50:21,649 INFO Included extra file "/opt/docker/etc/supervisor.d/ssh.conf" during parsing
2022-10-23 14:50:21,649 INFO Included extra file "/opt/docker/etc/supervisor.d/syslog.conf" during parsing
2022-10-23 14:50:21,653 INFO RPC interface 'supervisor' initialized
2022-10-23 14:50:21,653 INFO supervisord started with pid 1
2022-10-23 14:50:22,655 INFO spawned: 'syslogd' with pid 49
2022-10-23 14:50:22,657 INFO spawned: 'nginxd' with pid 50
2022-10-23 14:50:22,658 INFO spawned: 'php-fpmd' with pid 51
2022-10-23 14:50:22,660 INFO spawned: 'crond' with pid 52
-> Executing /opt/docker/bin/service.d/syslog-ng.d//10-init.sh
2022-10-23 14:50:22,663 INFO success: nginxd entered RUNNING state, process has stayed up for > than 0 seconds (startsecs)
2022-10-23 14:50:22,663 INFO success: php-fpmd entered RUNNING state, process has stayed up for > than 0 seconds (startsecs)
2022-10-23 14:50:22,663 INFO success: crond entered RUNNING state, process has stayed up for > than 0 seconds (startsecs)
-> Executing /opt/docker/bin/service.d/nginx.d//10-init.sh
-> Executing /opt/docker/bin/service.d/php-fpm.d//10-init.sh
Setting php-fpm user to application
[2022-10-23T14:50:22.674601] WARNING: With use-dns(no), dns-cache() will be forced to 'no' too!;
nginx: [warn] the "ssl" directive is deprecated, use the "listen ... ssl" directive instead in /opt/docker/etc/nginx/vhost.ssl.conf:1
[SYSLOG] syslog-ng[49]: syslog-ng starting up; version='3.30.1'
-> Executing /opt/docker/bin/service.d/cron.d//10-init.sh
[23-Oct-2022 14:50:22] NOTICE: fpm is running, pid 51
[23-Oct-2022 14:50:22] NOTICE: ready to handle connections
2022-10-23 14:50:23,786 INFO success: syslogd entered RUNNING state, process has stayed up for > than 1 seconds (startsecs)> mockServer@1.0.0 start
> npm run pm2 start index.js> mockServer@1.0.0 pm2
> node ./node_modules/pm2/bin/pm2 "start" "index.js"-------------__/\\\\\\\\\\\\\____/\\\\____________/\\\\____/\\\\\\\\\______\/\\\/\\\_\/\\\\\\________/\\\\\\__/\\\///\\\____\/\\\_______\/\\\_\/\\\//\\\____/\\\//\\\_\///______\//\\\___\/\\\\\\\\\\\\\/__\/\\\\///\\\/\\\/_\/\\\___________/\\\/____\/\\\/____\/\\\__\///\\\/___\/\\\________/\\\//______\/\\\_____________\/\\\____\///_____\/\\\_____/\\\//_________\/\\\_____________\/\\\_____________\/\\\___/\\\/____________\/\\\_____________\/\\\_____________\/\\\__/\\\\\\\\\\\\\\\__\///______________\///______________\///__\///__Runtime EditionPM2 is a Production Process Manager for Node.js applicationswith a built-in Load Balancer.Start and Daemonize any application:$ pm2 start app.jsLoad Balance 4 instances of api.js:$ pm2 start api.js -i 4Monitor in production:$ pm2 monitorMake pm2 auto-boot at server restart:$ pm2 startupTo go further checkout:http://pm2.io/-------------[PM2] Spawning PM2 daemon with pm2_home=/root/.pm2
[PM2] PM2 Successfully daemonized
[PM2] Starting /showdoc_data/mock/index.js in fork_mode (1 instance)
[PM2] Done.
┌─────┬──────────┬─────────────┬─────────┬─────────┬──────────┬────────┬──────┬───────────┬──────────┬──────────┬──────────┬──────────┐
│ id  │ name     │ namespace   │ version │ mode    │ pid      │ uptime │ ↺    │ status    │ cpu      │ mem      │ user     │ watching │
├─────┼──────────┼─────────────┼─────────┼─────────┼──────────┼────────┼──────┼───────────┼──────────┼──────────┼──────────┼──────────┤
│ 0   │ index    │ default     │ 1.0.0   │ fork    │ 114      │ 0s     │ 0    │ online    │ 0%       │ 17.2mb   │ root     │ disabled │
└─────┴──────────┴─────────────┴─────────┴─────────┴──────────┴────────┴──────┴───────────┴──────────┴──────────┴──────────┴──────────┘
2022-10-23 14:50:53,821 INFO reaped unknown pid 47 (exit status 0)

六、ShowDoc初始化

1.选择语言

2.查看初始化结果

七、登录署ShowDoc

1.进入ShowDoc登录页

2.登录ShowDoc首页

八、ShowDoc的基本使用

1.进入后台管理界面

2.新建项目

3.新建与编辑文档

4.团队管理

【云原生之Docker实战】使用Docker部署ShowDoc文档工具相关推荐

云原生Java架构实战 K8s+Docker+KubeSphere+DevOps（上）
云原生Java架构 K8s+Docker+KubeSphere+DevOps 云平台私有网络VPC VPC的子网计算 VPC的交换机重要概念容器化 docker概念青云服务器 centos安装 ...
【云原生之Docker实战】使用Docker部署Mindoc文档管理平台
[云原生之Docker实战]使用Docker部署Mindoc文档管理平台一.Mindoc介绍 1.Mindoc简介 2.Mindoc功能二.检查宿主机系统版本 1.检查操作系统版本 2.检查系统内 ...
【云原生之Docker实战】使用docker部署mkdocs项目文档工具
[云原生之Docker实战]使用docker部署mkdocs项目文档工具一.mkdocs介绍 1.mkdocs简介 2.mkdocs特点二.检查本地环境 1.检查docker版本 2.检查dock ...
【云原生之kubernetes实战】在k8s环境下部署OneNav个人书签工具
[云原生之kubernetes实战]在k8s环境下部署OneNav个人书签工具一.OneNav介绍 1.OneNav简介 2.OneNav特点二.检查本地k8s环境 1.检查工作节点状态 2.检查 ...
【云原生之kubernetes实战】在k8s环境下部署Homepage个人导航页
[云原生之kubernetes实战]在k8s环境下部署Homepage个人导航页一.Homepage简介二.检查本地k8s环境 1.检查工作节点状态 2.检查系统pod状态三.安装docker- ...
【云原生之kubernetes实战】在k8s环境下部署Snipe-IT固定资产管理平台
[云原生之kubernetes实战]在k8s环境下部署Snipe-IT固定资产管理平台一.Snipe-IT介绍二.检查本地k8s环境 1.检查工作节点状态 2.检查系统pod状态 3.检查kube ...
【云原生之kubernetes实战】在k8s集群下部署Weave Scope监控平台
[云原生之kubernetes实战]在k8s集群下部署Weave Scope监控平台一.Weave Scope介绍 1.Weave Scope简介 2.Weave Scope的特点 3.Weave ...
《新程序员003》正式上市！华为、阿里等 30+ 公司的云原生及数字化实战经验...
作者 | 唐小引出品 | <新程序员>编辑部 <新程序员 003:云原生和全面数字化实践>图书今日正式上市,纸书和电子书同步上架 CSDN 商城.New 程序员小程序.京东. ...
《新程序员003》来了！华为、阿里等 30+ 公司的云原生及数字化实战经验！
<新程序员 003:云原生和全面数字化实践>图书正式上市,纸书和电子书同步上架 CSDN 商城.New 程序员小程序.京东.当当等平台.这是由 50 余位技术专家共同创作,写给所有关注云原 ...

【云原生之Docker实战】使用Docker部署ShowDoc文档工具

【云原生之Docker实战】使用Docker部署ShowDoc文档工具

一、ShowDoc介绍

1.ShowDoc简介

2.ShowDoc功能

二、检查docker版本

三、检查docker状态

四、下载ShowDoc镜像

五、创建ShowDoc容器

1.创建数据目录

2目录授权

3.运行ShowDoc容器

4.查看ShowDoc容器状态

5.查看容器运行日志

六、ShowDoc初始化

1.选择语言

2.查看初始化结果

七、登录署ShowDoc

1.进入ShowDoc登录页

2.登录ShowDoc首页

八、ShowDoc的基本使用

1.进入后台管理界面

2.新建项目

3.新建与编辑文档

4.团队管理

【云原生之Docker实战】使用Docker部署ShowDoc文档工具相关推荐

最新文章

热门文章