引言

在數(shù)字化的時代浪潮中，華為云以其強大的實力和卓越的性能，為企業(yè)和開發(fā)者提供了堅實的技術(shù)支撐。而 Flexus 云服務(wù)器 X 實例，更是展現(xiàn)了華為云的創(chuàng)新與優(yōu)秀，此次我們將在其上安裝 ShowDoc 文檔管理工具，開啟高效協(xié)作之旅。

一、Flexus 云服務(wù)器 X 實例介紹

1.1 Flexus 云服務(wù)器 X 實例簡介

華為云 Flexus 云服務(wù)器 X 實例官網(wǎng)：Flexus云服務(wù)器X實例

華為云 Flexus 云服務(wù)器 X 實例屬于新一代云服務(wù)器，專為中小企業(yè)和開發(fā)者打造，具備柔性算力。它能夠智能感知業(yè)務(wù)負(fù)載，適用于電商直播、企業(yè)建站、開發(fā)測試環(huán)境、游戲服務(wù)器、音視頻服務(wù)等中低負(fù)載場景。與 Flexus 應(yīng)用服務(wù)器 L 實例相比，F(xiàn)lexus 云服務(wù)器 X 實例具有諸多優(yōu)勢，例如提供豐富的公共鏡像、可靈活自定義 vCPU 內(nèi)存配比、能智能感知業(yè)務(wù)動態(tài)升降配，而且負(fù)載范圍更高等。

1.2 主要使用場景

·電商直播在電商直播領(lǐng)域，F(xiàn)lexus 云服務(wù)器 X 實例展現(xiàn)出卓越的適應(yīng)性。隨著電商市場的動態(tài)變化，業(yè)務(wù)壓力時刻處于波動之中。利用 Flexus X 實例搭建電商交易平臺，能夠游刃有余地應(yīng)對這種變化。無論是促銷活動期間流量的爆發(fā)式增長，還是日常運營中的業(yè)務(wù)壓力起伏，該實例憑借其獨特的性能優(yōu)勢，確保電商平臺的穩(wěn)定運行，為商家和消費者提供可靠的交易環(huán)境。

·企業(yè)建站對于企業(yè)建站需求，無論是創(chuàng)建博客、搭建論壇，還是構(gòu)建企業(yè)門戶等業(yè)務(wù)場景，F(xiàn)lexus 云服務(wù)器 X 實例都能發(fā)揮重要作用。它有助于企業(yè)有效地傳播自身的價值信息，推動信息在企業(yè)內(nèi)部、企業(yè)與客戶之間的共享和交流。企業(yè)可以借助這一實例輕松搭建多功能的傳播和交互平臺，全方位展示企業(yè)形象、產(chǎn)品信息以及服務(wù)內(nèi)容，從而增強企業(yè)的品牌影響力和用戶粘性。

·個人開發(fā)測試在個人開發(fā)和測試方面，開發(fā)者常常需要各種各樣的環(huán)境資源。Flexus 云服務(wù)器 X 實例為開發(fā)者提供了便捷且經(jīng)濟高效的解決方案。選擇從云上獲取所需資源，基于該實例搭建開發(fā)測試環(huán)境，能夠讓開發(fā)者更加專注于代碼編寫和功能測試。與傳統(tǒng)方式相比，這種方式不僅操作更加便利，而且在成本控制上更具優(yōu)勢，有助于提高開發(fā)效率，縮短項目周期。

·游戲服務(wù)器 Flexus 云服務(wù)器 X 實例非常適用于搭建游戲后臺服務(wù)器。在游戲運營過程中，它強大的算力足以輕松應(yīng)對數(shù)千人同時在線的復(fù)雜情況。當(dāng)服務(wù)器玩家數(shù)量出現(xiàn)上漲趨勢時，該實例的平滑擴容能力能夠迅速響應(yīng)，確保游戲的流暢性和穩(wěn)定性。此外，其超強的網(wǎng)絡(luò)加速能力顯著提升了玩家的游戲體驗，減少延遲、卡頓等現(xiàn)象，為游戲的成功運營提供了堅實的技術(shù)保障。

二、購買 Flexus 云服務(wù)器 X 實例

2.1 購買規(guī)格參考

·華為云 Flexus X 實例的購買規(guī)格可以參考如下所示：

·可參考以下配置詳情頁，確認(rèn)無誤后，勾選“協(xié)議許可”，點擊立即購買。

2.2 查看 Flexus 云服務(wù)器 X 實例狀態(tài)

購買成功后，進(jìn)入到 Flexus 云服務(wù)器 X 實例控制臺，可以看到 Flexus X 實例已經(jīng)正常運行中。

三、遠(yuǎn)程連接 Flexus 云服務(wù)器 X 實例

3.1 重置密碼

選擇“重置密碼”選項，重置 Flexus 云服務(wù)器 X 實例的登錄密碼。

登錄密碼自定義設(shè)置，勾選自動重啟選項，確認(rèn)。

3.2 本地 MobaXterm 工具遠(yuǎn)程連接

可以使用本地 MobaXterm 工具連接 Flexus 云服務(wù)器 X 實例，填寫 Flexus 云服務(wù)器 X 實例的彈性公網(wǎng) IP 地址后，在終端界面填寫 root 賬號和密碼即可遠(yuǎn)程連接。

四、部署 ShowDoc 應(yīng)用

4.1ShowDoc 介紹

簡介：

ShowDoc 是一款專為 API 文檔管理設(shè)計的工具，支持在線協(xié)作編輯，能夠幫助團(tuán)隊更高效地管理和分享接口文檔。

特點：

·實時協(xié)作：團(tuán)隊成員可以同時編輯同一份文檔，提高工作效率。

·版本控制：保留文檔的歷史版本，方便回溯查看或恢復(fù)。

·權(quán)限管理：可設(shè)置文檔訪問權(quán)限，保護(hù)文檔安全。

·插件擴展：支持多種插件以增強功能，滿足不同需求。

·多平臺支持：可在多種操作系統(tǒng)上運行，并提供 Web 界面訪問。

·自定義樣式：允許用戶定制文檔樣式，符合品牌形象或個人偏好。

·離線訪問：部分功能支持在沒有網(wǎng)絡(luò)的情況下使用，增加靈活性。

主要使用場景：

1.軟件開發(fā)團(tuán)隊：用于記錄和維護(hù) API 接口文檔。

2.產(chǎn)品與技術(shù)對接：作為產(chǎn)品和技術(shù)部門之間溝通的技術(shù)文檔工具。

3.遠(yuǎn)程協(xié)作項目：支持分布式團(tuán)隊共享和編輯文檔。

4.內(nèi)部知識庫建設(shè)：構(gòu)建企業(yè)內(nèi)部的知識管理系統(tǒng)。

5.API 測試輔助：結(jié)合測試工具進(jìn)行 API 測試案例記錄與分享。

6.客戶技術(shù)支持：向客戶提供清晰的產(chǎn)品 API 使用指南。

7.代碼文檔化：自動或手動將代碼注釋轉(zhuǎn)換成文檔。

4.2 實踐環(huán)境規(guī)劃

4.3 本地環(huán)境檢查

檢查當(dāng)前的操作系統(tǒng)版本

[root@flexusx-e2c8 ~]# cat /etc/os-releaseNAME="Rocky Linux"VERSION="9.0 (Blue Onyx)"ID="rocky"ID_LIKE="rhel centos fedora"VERSION_ID="9.0"PLATFORM_ID="platform:el9"PRETTY_NAME="Rocky Linux 9.0 (Blue Onyx)"ANSI_COLOR="0;32"LOGO="fedora-logo-icon"CPE_NAME="cpe:/o:rocky:rocky:9::baseos"HOME_URL="https://rockylinux.org/"BUG_REPORT_URL="https://bugs.rockylinux.org/"ROCKY_SUPPORT_PRODUCT="Rocky-Linux-9"ROCKY_SUPPORT_PRODUCT_VERSION="9.0"REDHAT_SUPPORT_PRODUCT="Rocky Linux"REDHAT_SUPPORT_PRODUCT_VERSION="9.0"

檢查 Docker 版本，需要提前安裝 Docker 環(huán)境。

[root@flexusx-e2c8 ~]# docker -vDocker version 27.1.1, build 6312585

4.4 創(chuàng)建 ShowDoc 容器

·下載 ShowDoc 鏡像

[root@flexusx-e2c8 ~]# docker pull star7th/showdocUsing default tag: latestlatest: Pulling from star7th/showdocca7dd9ec2225: Pull complete1b78b4fe0ca1: Pull complete9d6040f2a28f: Pull complete0e2e66b89284: Pull complete3b1be5f02bec: Pull complete96243f515dda: Pull completee427679e7c26: Pull complete759eb390abda: Pull complete9820b782a628: Pull completea9e6097c1efa: Pull complete561ed9cfdc11: Pull completeb5ac29f40552: Pull complete9c9b9da49812: Pull completea9d2406d9976: Pull complete3cc36ef8d41c: Pull complete640399d119a6: Pull complete86e58e6128a5: Pull completeb0e1f147b984: Pull completee6ce4f3778f4: Pull complete211a642ef74b: Pull complete1451b1c61460: Pull completeeb16da146d29: Pull completeDigest: sha256:229d46f98509176467f82bcea49dda283dffcf308e66214caa7e84b5041fcfb4Status: Downloaded newer image for star7th/showdoc:latestdocker.io/star7th/showdoc:latest

·編輯 docker-compose.yaml 文件，內(nèi)容如下：

version: '3'services:showdoc:image: star7th/showdoccontainer_name: showdocrestart: alwaysuser: rootprivileged: trueports:- "5001:80"volumes:- "/docker/showdoc/html:/var/www/html/"deploy: resources:limits:cpus: '1'memory: 2Greservations:cpus: '0.5'memory: 1G

·創(chuàng)建 ShowDoc 容器

docker compose up -d

4.5 查看 ShowDoc 容器

我們可以看到 ShowDoc 容器已經(jīng)正常運行，宿主機映射的訪問端口為 5001。

[root@flexusx-e2c8 shodoc]# docker compose psWARN[0000] /docker/shodoc/docker-compose.yaml: the attribute `version` is obsolete, it will be ignored, please remove it to avoid potential confusionNAME IMAGE COMMAND SERVICE CREATED STATUS PORTSshowdoc star7th/showdoc "/entrypoint bash do…" showdoc 40 seconds ago Up 39 seconds 443/tcp, 9000/tcp, 0.0.0.0:5001->80/tcp, :::5001->80/tcp

查看監(jiān)聽端口，ShowDoc 服務(wù)端口為 5001。

[root@flexusx-e2c8 shodoc]# netstat -tunlp |grep 5001tcp 0 0 0.0.0.0:5001 0.0.0.0:* LISTEN 1392767/docker-proxtcp6 0 0 :::5001 :::* LISTEN 1392773/docker-prox

五、訪問 ShowDoc 應(yīng)用

5.1 安全設(shè)置

在安全組規(guī)則管理界面，入方向規(guī)則上放行 5001 端口。

本次安裝的 Rocky Linux 操作系統(tǒng)默認(rèn)沒有關(guān)閉防火墻，可以參考以下命令，關(guān)閉防火墻。如果不想關(guān)閉防火墻，則需要放行相關(guān)服務(wù)端口。

systemctl stop firewalld && systemctl disable firewalld

關(guān)閉 selinux 服務(wù)

setenforce 0

sed -i 's/SELINUX=enforcing/SELINUX=disabled/' /etc/selinux/config

5.2 訪問 ShowDoc 服務(wù)

訪問 ShowDoc 首頁

在瀏覽器中輸入以下地址：https://公網(wǎng) IP 地址:5001（將"公網(wǎng) IP 地址"替換為你的服務(wù)器的彈性公網(wǎng) IP 地址），輸入設(shè)置的訪問口令，進(jìn)入 ShowDoc 筆記首頁。

可以看到提示的默認(rèn)登錄管理員賬號和密碼為 showdoc/123456，點擊進(jìn)入首頁。

在登錄頁，輸入賬號密碼后，進(jìn)入 ShowDoc 管理頁面。

進(jìn)入后臺管理

如圖所示，進(jìn)入 ShowDoc 后臺管理頁面。

新建文檔

·點擊“創(chuàng)建新項目”

·填寫項目名稱、項目描述等信息，自行設(shè)置即可。

點擊下方的“+”號，新建頁面。

編輯文檔內(nèi)容和標(biāo)題，保存文檔。

·查看文檔效果

分享文檔

點擊分享選項，復(fù)制分享鏈接給其他。

六、總結(jié)與體會

通過在華為云 Flexus 云服務(wù)器 X 實例上安裝 ShowDoc 文檔管理工具，我們深切感受到了華為云的強大實力。Flexus X 實例以其卓越的性能和穩(wěn)定性，為團(tuán)隊協(xié)作提供了可靠的基礎(chǔ)。華為云不斷創(chuàng)新，為中小企業(yè)和開發(fā)者帶來更多優(yōu)秀的解決方案，助力他們在數(shù)字化時代乘風(fēng)破浪。

華為云 Flexus 云服務(wù)器 X 實例?擁有眾多卓越優(yōu)勢。它如同一個擁有無限可能的數(shù)字空間???，提供無限擴展的可能；性能強勁???，穩(wěn)定可靠，資源調(diào)度靈活自如???；更有多重安全防護(hù)措施????，有效滿足各種變動需求的同時，全力保障數(shù)據(jù)安全。

華為云 828 活動已盛大開啟???，其一鍵式管理功能猶如一把神奇的鑰匙???，極大地簡化了運維工作?，F(xiàn)在，就讓我們一同踏上這場探索數(shù)字化未來的精彩之旅吧???！

審核編輯 黃宇