【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：
sudo apt-get install apache2 -y
現在，我們可以使用以下命令安裝必要的PHP組件：
sudo apt-get install php php-gd php-xml php-json -y
完成這些安裝後，使用以下命令啟動並啟用Apache：
sudo systemctl enable --now apache2
如何下載、解壓縮和移動DokuWiki?
為了安裝DokuWiki，我們需要下載、解壓縮，並將其移到Apache文檔根目錄。
使用以下命令下載最新版本的DokuWiki：
wget https://download.dokuwiki.org/src/dokuwiki/dokuwiki-stable.tgz
使用以下命令解壓縮經過壓縮的tar文件：
tar xvzf dokuwiki-stable.tgz
使用以下命令移動並重命名剛創建的目錄：
sudo mv dokuwiki-XXX / var / www / html / dokuwiki
其中XXX是版本號。
使用以下命令拷貝示例.htaccess文件：
sudo cp /var/www/html/dokuwiki/.htaccess{.dist,}
使用以下命令更改DokuWiki文件夾的所有權：
sudo chown -R www-data:www-data /var/www/html/dokuwiki
如何配置Apache?
眼下，Apache無法知道新安裝的組件。為了讓它知道，我需要為DokuWiki創建一個配置文件。使用以下命令創建新文件：
sudo nano /etc/apache2/sites-available/dokuwiki.conf
在該文件中，粘貼以下內容：
ServerName dokuwiki.example.com DocumentRoot /var/www/html/dokuwiki AllowOverride All Require all denied Order allow,deny Deny from all ErrorLog /var/log/apache2/dokuwiki_error.log CustomLog /var/log/apache2/dokuwiki_access.log combined
如果您要使用域，確保更改您在上面看到的ServerName選項。
保存並關閉文件。
使用以下命令啟用新網站：
sudo a2ensite dokuwiki
使用以下命令重新加載Apache配置文件：
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】