騰訊云高級(jí)前端工程師葉嘉梁:如何用 COS 快速搭建國(guó)內(nèi)可快速訪問(wèn)的 Wiki 文檔站點(diǎn)
想要在國(guó)內(nèi)快速搭建一個(gè)便捷訪問(wèn)的Wiki文檔站點(diǎn)嗎?騰訊云COS對(duì)象存儲(chǔ)正是你的好幫手。這是一個(gè)非常實(shí)用的解決方案。下面,我們就來(lái)詳細(xì)了解一下操作步驟。
創(chuàng)建存儲(chǔ)桶
搭建Wiki文檔站點(diǎn),得先登錄到騰訊云COS控制臺(tái)。比如,可以創(chuàng)建一個(gè)位于廣州的存儲(chǔ)桶,命名為cos--demo-,并設(shè)置為公有讀私有寫(xiě)模式。創(chuàng)建存儲(chǔ)桶時(shí),細(xì)節(jié)得留意,按照控制臺(tái)提示操作。接著,進(jìn)入存儲(chǔ)桶詳情,找到靜態(tài)網(wǎng)站選項(xiàng)并開(kāi)啟,但強(qiáng)制HTTPS暫時(shí)別開(kāi),這可是基礎(chǔ)步驟,就像蓋房子得先打好地基。地域選擇不同,可能會(huì)影響訪問(wèn)速度等,所以得根據(jù)實(shí)際情況選個(gè)合適的地點(diǎn)。
創(chuàng)建存儲(chǔ)桶之后,它便相當(dāng)于一個(gè)空蕩蕩的文件夾。此時(shí),我們便需著手往其中填充內(nèi)容。同時(shí),存儲(chǔ)桶的名稱(chēng)、所在地域等關(guān)鍵信息也需一一記錄,以便于日后的操作進(jìn)行。
配置API密鑰
接下來(lái),需將騰訊云個(gè)人賬號(hào)的API密鑰設(shè)置到相應(yīng)平臺(tái)。這一步驟至關(guān)重要,因?yàn)楹罄m(xù)操作將依賴(lài)此密鑰向COS發(fā)起請(qǐng)求。若缺失此密鑰,就如同車(chē)輛缺少鑰匙,無(wú)法啟動(dòng)。這些密鑰如同密碼,必須妥善保管。在配置過(guò)程中,務(wù)必仔細(xì)核對(duì)信息,確保無(wú)誤。
// 安裝、初始化,以及預(yù)覽
// 前提條件是本地安裝了Node/Npm,以及 npm
npm i docsify-cli -g
docsify?init?./cos-website-demo??
docsify?serve?cos-website-demo
配置若出錯(cuò),后續(xù)操作可能受阻,比如上傳文件時(shí)會(huì)被禁止訪問(wèn)。實(shí)際操作中問(wèn)題繁多,因此必須謹(jǐn)慎行事。
創(chuàng)建配置文件
在本地生成的目錄中,首先在根目錄下創(chuàng)建名為“./”的子目錄,接著在該子目錄內(nèi)建立名為“main.yml”的文件。此文件的主要用途是編寫(xiě)將文件上傳至COS的邏輯。在此,你需要將之前配置的騰訊云密鑰信息合理應(yīng)用。比如,需要按照既定規(guī)則編寫(xiě)代碼邏輯,以確保文件上傳過(guò)程順利進(jìn)行。
這里的規(guī)則依據(jù)于騰訊云COS對(duì)象存儲(chǔ)的規(guī)定。若不依照這些規(guī)定來(lái)編寫(xiě),便會(huì)產(chǎn)生邏輯上的錯(cuò)誤。雖然編寫(xiě)代碼看似復(fù)雜,但只要我們認(rèn)真按照規(guī)定,一步步操作,就能順利完成任務(wù)。
修改存儲(chǔ)桶地域
在修改存儲(chǔ)桶的地域時(shí),需將其調(diào)整為先前所選區(qū)域。若先前選的是廣州且在創(chuàng)建存儲(chǔ)桶時(shí)無(wú)任何錯(cuò)誤,則無(wú)需進(jìn)行修改。這樣做是為了保證數(shù)據(jù)存儲(chǔ)和訪問(wèn)的統(tǒng)一性。每個(gè)設(shè)置都如同鏈條的一環(huán),任何一環(huán)出現(xiàn)失誤,都可能引起整個(gè)鏈條的不穩(wěn)定。
有時(shí)候,我們可能會(huì)因?yàn)槭韬龆z漏了地域的修改,或是犯了錯(cuò)誤。在這種情況下,我們需在操作時(shí)格外留心,確保每一處都經(jīng)過(guò)仔細(xì)檢查,以免出現(xiàn)失誤。
獲取COS訪問(wèn)節(jié)點(diǎn)地址
隨后,需點(diǎn)擊COS訪問(wèn)節(jié)點(diǎn)提供的URL鏈接,這如同家門(mén)鑰匙孔,唯有借助它,方可進(jìn)入文檔站點(diǎn)。請(qǐng)注意,不同存儲(chǔ)桶的URL地址各異,務(wù)必精準(zhǔn)定位屬于自己的那一個(gè)。
URL地址若出錯(cuò),便無(wú)法順利訪問(wèn)網(wǎng)站。這一過(guò)程需耐心細(xì)致,務(wù)必保證地址的正確無(wú)誤。
添加自定義域名
若想使站點(diǎn)更具個(gè)性,可借助COS提供的綁定自定義域名的服務(wù)。先打開(kāi)存儲(chǔ)桶的詳細(xì)信息,進(jìn)入域名管理界面,然后在下方找到自定義源站域名選項(xiàng),并添加您的域名。需留意,若存儲(chǔ)桶位于國(guó)內(nèi)大陸地區(qū),域名必須經(jīng)過(guò)備案,這是必須遵守的規(guī)定。若選擇海外地區(qū),則無(wú)需此要求。添加域名后,還需在DNS服務(wù)商處設(shè)置域名的CNAME記錄,使其指向COS提供的原始靜態(tài)站點(diǎn)域名。
完成這一步驟后,Wiki文檔站點(diǎn)便基本建成。若需修改,只需將更改推送到git,系統(tǒng)便會(huì)自動(dòng)部署。你掌握了嗎?在搭建過(guò)程中,你是否遇到了什么特別棘手的問(wèn)題?期待你能點(diǎn)贊、轉(zhuǎn)發(fā)此篇文章,并在評(píng)論區(qū)與大家分享心得。
作者:小藍(lán)
鏈接:http://www.haitaopa.cn/content/4245.html
本站部分內(nèi)容和圖片來(lái)源網(wǎng)絡(luò),不代表本站觀點(diǎn),如有侵權(quán),可聯(lián)系我方刪除。