IDC

如何使用DokuWiki将软硬件记入文档?

作者:admin 2021-04-10 我要评论

【51CTO.com快译】您的内部数据中心(或基于云的数据中心)很复杂,可能在运行许多标准服务,比如Web服务器、HRM工具、备份服务器、数据共享和SaaS工具等,或者您...

在说正事之前,我要推荐一个福利:你还在原价购买阿里云、腾讯云、华为云服务器吗?那太亏啦!来这里,新购、升级、续费都打折,能够为您省60%的钱呢!2核4G企业级云服务器低至69元/年,点击进去看看吧>>>)

【51CTO.com快译】您的内部数据中心(或基于云的数据中心)很复杂,可能在运行许多标准服务,比如Web服务器、HRM工具、备份服务器、数据共享和SaaS工具等,或者您可能有一个大量应用程序和服务在运行的集群。

由于您在任何时候运行的软硬件数量众多,可能要将如何部署、配置和使用软硬件记入文档。您可能需要为员工、管理员和开发人员提供无数的核对清单和策略,那该如何是好?您可以使用简单的Wiki服务器。开源的DokuWiki就是这样一种平台,它包含以下功能:

  • 易于使用的界面和语法
  • HTML嵌入
  • 无限的页面修订
  • 支持标有颜色的并排差异
  • 图片上传/嵌入
  • 可定制的Wiki间链接
  • 栏目编辑
  • 目录自动生成
  • 文件锁定
  • 可定制的布局(通过模板)
  • 支持LDEP、MySQL和Postgres

下面逐步介绍在Ubuntu Server 20.04上部署DokuWiki的过程。

您需要什么?

  • 运行中且经过更新的Ubuntu Server 20.04实例
  • 拥有sudo特权的用户

如何安装Apache和PHP?

我们要做的第一件事是安装Apache Web服务器和必要的PHP组件。登录到您的Ubuntu服务器,使用以下命令安装Apache:

  1. sudo apt-get install apache2 -y 

现在,我们可以使用以下命令安装必要的PHP组件:

  1. sudo apt-get install php php-gd php-xml php-json -y 

完成这些安装后,使用以下命令启动并启用Apache:

  1. sudo systemctl enable --now apache2 

如何下载、解压缩和移动DokuWiki?

为了安装DokuWiki,我们需要下载、解压缩,并将其移到Apache文档根目录。

使用以下命令下载最新版本的DokuWiki:

  1. wget https://download.dokuwiki.org/src/dokuwiki/dokuwiki-stable.tgz 

使用以下命令解压缩经过压缩的tar文件:

  1. tar xvzf dokuwiki-stable.tgz 

使用以下命令移动并重命名刚创建的目录:

  1. sudo mv dokuwiki-XXX / var / www / html / dokuwiki 

其中XXX是版本号。

使用以下命令拷贝示例.htaccess文件:

  1. sudo cp /var/www/html/dokuwiki/.htaccess{.dist,} 

使用以下命令更改DokuWiki文件夹的所有权:

  1. sudo chown -R www-data:www-data /var/www/html/dokuwiki 

如何配置Apache?

眼下,Apache无法知道新安装的组件。为了让它知道,我需要为DokuWiki创建一个配置文件。使用以下命令创建新文件:

  1. sudo nano /etc/apache2/sites-available/dokuwiki.conf 

在该文件中,粘贴以下内容:

  1. <VirtualHost *:80> 
  2.         ServerName    dokuwiki.example.com       
  3.         DocumentRoot  /var/www/html/dokuwiki 
  4.         <Directory ~ "/var/www/html/dokuwiki/(bin/|conf/|data/|inc/)"
  5.             <IfModule mod_authz_core.c> 
  6.                 AllowOverride All 
  7.                 Require all denied 
  8.             </IfModule> 
  9.             <IfModule !mod_authz_core.c> 
  10.                 Order allow,deny 
  11.                 Deny from all 
  12.             </IfModule> 
  13.         </Directory> 
  14.         ErrorLog   /var/log/apache2/dokuwiki_error.log 
  15.         CustomLog  /var/log/apache2/dokuwiki_access.log combined 
  16. </VirtualHost> 

如果您要使用域,确保更改您在上面看到的ServerName选项。

保存并关闭文件。

使用以下命令启用新网站

  1. sudo a2ensite dokuwiki 

使用以下命令重新加载Apache配置文件:

  1. sudo systemctl reload apache2 

如何完成安装?

打开Web浏览器,导航到http://SERVER/install.php(其中Server是您托管服务器的域名的IP地址)。您应该会看到基于Web的DokuWiki安装程序(见图A)。

图A. DokuWiki基于Web的安装程序准备完成安装

填写必要的信息,点击“保存”。安装应立即完成,会显示一个链接指向DokuWiki主页,即http://SERVER/doku.php?id=wiki:welcome(其中Server是主机托管服务器的域名的IP地址)(见图B)。

图B. DokuWiki基于web的安装程序准备完成安装

就是这样。现在您已准备好开始搭建一个Wiki网站,以便将您的硬件、软件、容器及更多内容记入文档。这个好方法便于让您的开发人员和管理员了解部署环境的情况。您甚至可以使用该工具为管理员和开发者存放核对清单之类的内容。务必确保该Wiki避免被窥视,千万不要使用这类工具作为任何一种密码管理器。密码始终要放在正规的密码管理器中。DokuWiki(及类似工具)适合于记入文档,而不是很适合确保机密信息安全。

原文标题:How to document your software and hardware with DokuWiki,作者:Jack Wallen

【51CTO译稿,合作站点转载请注明原文译者和出处为51CTO.com】


本文转载自网络,原文链接:http://www.51cto.com

版权声明:本文转载自网络,遵循 CC 4.0 BY-SA 版权协议,转载请附上原文出处链接和本声明。本站转载出于传播更多优秀技术知识之目的,如有侵权请联系QQ/微信:153890879删除

相关文章
  • 太棒了!Python和Excel过了这么久终于

    太棒了!Python和Excel过了这么久终于

  • Java编程内功-数据结构与算法「线索化

    Java编程内功-数据结构与算法「线索化

  • 在Java中使用异步编程

    在Java中使用异步编程

  • Kafka性能篇:为何Kafka这么&quot;

    Kafka性能篇:为何Kafka这么&quot;

腾讯云代理商
海外云服务器