本文將引導你在 Mac OS X 環境下,從零開始安裝 Node.js、npm 與 CouchDB,並透過一個實戰專案實作基於 CouchDB 的 RESTful API 服務。全程預計約 30 分鐘,適合想快速上手全端 JavaScript 開發的工程師。
最簡單方式是前往 Node.js 官網下載頁,下載 macOS 安裝包(.pkg)並執行安裝。安裝完成後,驗證版本:
node -v
npm -v
CouchDB 需編譯安裝,建議透過 Homebrew 管理依賴:
# 安裝 Homebrew(若已安裝可跳過)
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
# 安裝編譯工具與 CouchDB
brew install autoconf automake libtool
brew install couchdb
若編譯失敗,可能需修正 Homebrew Formula 中的下載連結:
~/homebrew/Library/Formula/couchdb.rburl 中的 source/ 移除:url 'https://www.apache.org/dyn/closer.cgi?path=couchdb/1.1.1/apache-couchdb-1.1.1.tar.gz'
brew install -v couchdb# 啟動 CouchDB(前景模式)
couchdb
# 或背景模式
brew services start couchdb
打開瀏覽器訪問 Fauxton 管理介面,若看到儀表板即安裝成功。
git clone https://github.com/indexzero/nodejs-intro.git
cd nodejs-intro
# 確保 CouchDB 正在運行
curl -X PUT https://127.0.0.1:5984/pinpoint-dev
# 回應 {"ok":true} 表示成功
專案採用模組化架構,lib/ 存放模組,bin/ 存放啟動腳本:
cd bin
./server -t 02couchdb -s
-t 02couchdb:指定載入 lib/02couchdb.js 模組-s:使用剛建立的 pinpoint-dev 資料庫sys 模組棄用警告/錯誤Node.js v0.6+ 將 sys 重命名為 util。若出現錯誤,請將專案中所有 require('sys') 替換為 require('util')。
optimist 等依賴套件使用 npm 安裝專案所需套件:
npm install optimist winston cradle journey
套件將安裝至專案根目錄下的 node_modules/。
啟動成功後,終端機將顯示:
Pinpoint demo server listening for 02couchdb on https://127.0.0.1:8000
打開瀏覽器訪問 https://127.0.0.1:8000,即可體驗完整的書籤 CRUD REST API 服務。