使用Docker部署一个简洁易用的ShowDoc文档系统

使用Docker部署一个简洁易用的ShowDoc文档系统

5条评论

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

ShowDoc提供了在线版本，您可以直接注册并使用： https://www.showdoc.com.cn/ 。如果您的团队需要使用，也可以选择私有部署。本文将分享如何使用Docker来部署ShowDoc。

Docker部署ShowDoc

Docker部署ShowDoc非常简单，只需要下面一行命令即可：

docker run -d --name showdoc --user=root --privileged=true -p 4999:80 \
-v /showdoc_data/html:/var/www/html/ star7th/showdoc

部署成功后通过 http://IP:4999 进行访问，初始账户密码是 showdoc/123456

另外管理员账户名好像不支持修改，xiaoz未找到修改的地方，如果你发现了，欢迎留言告诉我。

Docker Compose部署

如果选择Docker Compose部署，需要先创建一个 docker-compose.yaml 文件，内容为：

version: '3.3'
services:showdoc:container_name: showdocprivileged: trueports:- '4999:80'volumes:- './data:/var/www/html/'image: star7th/showdoc

输入命令启动： docker-compose up -d ，部署成功后通过 http://IP:4999 进行访问，初始账户密码是 showdoc/123456

通过绑定域名访问

Docker部署后默认使用 http://IP:4999 进行访问，如果需要使用域名访问，可通过Nginx反向代理来完成。下方是一个nginx反向代理的配置实例：

server {listen       80;server_name  test.showdoc.com.cn;client_max_body_size 1000m;location ^~ / {proxy_pass http://127.0.0.1:4999/;proxy_redirect off;proxy_connect_TIMeout 90;proxy_send_timeout 90;proxy_read_timeout 90;proxy_set_header Host $host;proxy_set_header X-Real-IP $remote_addr;proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;proxy_set_header http_user_agent $http_user_agent;}
}

部分截图

ShowDoc界面非常的简洁，上几张截图。

结语

ShowDoc 文档系统非常简洁，适合初创公司或小团队使用。此外，使用 Docker 部署 ShowDoc 也非常简单。如果您正在寻找一款开源的文档系统，建议试试 ShowDoc。

本地部署showDoc

ShowDoc就是一个非常适合IT团队的在线文档分享工具，它可以加快团队之间沟通的效率。有时候公司为了保密性以及一些特定需求，需要本地部署文档工具，下面介绍一下如何进行showDoc的本地化部署，本文采用Docker的方式安装showDoc。

其中：showdoc_test ：容器的名字；8100 ：服务运行的端口； 注意：需要释放云服务和防火墙的 8100 端口

可以看到该容器已经运行成功了。

如何使用 Docker 部署容器

设想，为了推出一个网站，您不必从裸机安装一个完整的服务器。 而不是安装操作系统，然后安装服务器软件，然后部署精心设计的应用程序或站点，您可以简单地在一个独立的包中开发所有内容，并使用单个命令将其推出。

这是使用容器的众多好处之一。它们使开发和部署周期变得异常高效。但是你如何部署这些容器？我想在这里指导你完成这个过程。我们将专注于在Ubuntu Server 18.04上部署基本的NGINX Web服务器作为容器。所有这一切都将在Docker的帮助下完成。

为了成功将NGINX部署为容器，您需要具备以下条件：

- 一个安装了Docker的Ubuntu Server 18.04的运行实例。

- 一个docker 用户组的成员用户

是的，有了这两部分，你就准备好了。

您部署的每个容器都将基于从DockerHUB中提取的镜像。 您可以下拉单个镜像并根据需要随时使用。 DockerHub上还有许多镜像用于单个应用程序或平台。 以NGINX为例。 如果你在DockerHub上搜索NGINX，你会得到大约56,172个条目。 这并不意味着每个条目都是您可以使用的可用图像。

图像命名如下：

例如，对于NGINX，您可能会找到一个名字为的镜像：

或许你可能找到：

您也看到了，有几乎所有需要的镜像。

在使用图像之前，必须将其保存在本地驱动器上。 有两种方法可以做到这一点：

- 直接使用pull命令

- 间接地，在容器部署过程中。

要从DockerHub中拉取图像，您将打开一个终端窗口并发出命令：

如果你想拉取Ingress图像，该命令是：

当你拉取你需要的图像之后，你可以使用命令确认是否存在：

上面的命令将列出你拉取的所有镜像（图A）。

拉取随意图像时要谨慎。 为什么？ 因为你永远不知道创造它们的原因。 容器可能包含恶意代码，可能会对您的网络或数据造成严重破坏。 因此，最好只使用官方图像（例如NGINX图像）。

现在该部署容器了， 如果您尚未拉取镜像，则在部署阶段将下拉所需要的镜像。 由于我们拉取官方NGINX图像，我们将使用它。

要部署容器，请使用docker命令，如下所示：

备注：

- NAME等于您要为容器提供的名称（这可以是任何内容，例如nginx-webserver）。

- PORTS您要使用的端口（以NETWORK PORT：CONTAINER PORT形式）。

- IMAGE用于容器的图像（例如nginx）。

因此，部署NGINX容器的基本命令是：

容器将要部署，NGINX Web服务器将在端口80上可用于本地网络。但是，如果已在服务器上使用端口80来部署容器，该怎么办？ 您可以将其部署在网络端口8080上，如下所示：

此时，您可能会看到下一个问题。 运行上述命令之一后，不返回bash提示符（图B）。

你如何运行一个容器，并获得你的bash提示？ 为此，您必须以分离模式运行容器。 在此之前，您必须使用键盘组合[Ctrl] +终止当前容器。 该组合将返回提示并杀死容器。

要确定容器是否运行，使用命令：

将列出所有容器及其状态（图C）。

如果容器仍在运行，我们必须在同一端口部署另一个容器之前将其终止（否则端口会发生冲突，从而阻止容器部署）。 要杀死正在运行的容器，首先需要Container ID（随机字符串）。 发出docker ps -a命令时会显示此字符串。 要终止正在运行的容器，使用命令：

其中CONTAINER_ID是相关容器的ID。

然后，您可以使用以下命令删除容器：

其中CONTAINER_ID是相关容器的ID。

请注意，您不必输入完整的Container ID，字符串的前四个字符就足够了。

现在，要以分离模式部署容器，命令是：

这次你不仅会得到你的提示，而且Docker会为你显示容器ID（图D）。

如果你想在正在运行的容器上工作怎么办？ 假设您想对NGINX进行更改甚至开始开发它将显示的网站？ 因此，您必须访问容器。 因此，您需要Container ID。 使用ID，发出命令：

其中CONTAINER_ID是容器的ID。

您现在应该处于运行容器提示符（图E）中，您可以在其中开始处理NGINX服务器。

要退出容器，只需键入命令exit。

七、比你想象的容易

希望到现在为止，您看到容器部署并不像您想象的那样具有挑战性。 在Docker的帮助下，您可以在几分钟内推出专业版的应用和服务。

原文链接：

docker的好处，为什么使用docker来部署服务器

Docker的使用Docker是一个轻量级的虚拟化解决方案，你可以实现秒级的虚拟机启动、非常轻量级的虚拟化。 个人使用理解看来，它可以实现一个类似于版本管理Git一样的轻量化的状态保存。 Docker有两个非常重要的概念: 镜像和容器。 镜像是呈载容器的实体，所有容器都是运行在镜像之上。 用版本管理的角度来看，镜像就像是某一个节点，它可以派生出不同的分支，你可以在不同分支上做不同的事情。 可以想象成一棵树，最基本的镜像是主树干，主树干可以分出旁支树干，而旁支树干可以分出更细的旁支，而树干上可以生长树枝。 比如，你使用Docker，从官方仓库下载一个ubuntu镜像，把它作为最基础的镜像。 然后在上面运行一个容器，这个容器里下载Nginx，再以这个容器为基础生成一个新的镜像，以后这个镜像生成的容器就都是ubuntu+nginx为基础。 但是你工作环境可能需要你使用Apache来工作，你也想有一个ubuntu+apache为基础的镜像，于是你可以使用最基础的ubuntu镜像运行一个容器，在里面下载安装Apache，然后以这个容器为基础，保存一个ubuntu+apache的镜像，以后在这个镜像基础上运行的所有容器都拥有了一个apache环境。

上一篇：最近我购买了一款极具性价比的入门级4k显示

下一篇：CloudConeVPS黑五闪购即将开始，新老用户可领