DIV CSS 佈局教程網

在 Mac 上從零建置 Node.js 與 CouchDB 開發環境
編輯:JavaScript綜合知識     

本文記錄在 Mac OS X 上把 Node.js 開發環境搭起來的完整過程,順便把 CouchDB 裝好,最後跑起一個以 CouchDB 為資料庫的 REST 書籤服務範例。整體約需半小時。

前置條件:機器上已經有 Git。若還沒有,請先安裝。範例本身取自一份很不錯的 Node.js 與 CouchDB 入門教學,示範如何用 REST 介面執行書籤的 CRUD 操作。

一、安裝 Node.js 與 npm

最省事的方式是到 Node.js 官方下載頁挑選 Mac 版安裝程式,它會同時裝好 Node 與 npm(Node Package Manager)。裝完即可在終端使用 node 與 npm 兩個指令:

node -v
npm -v

二、安裝 CouchDB

CouchDB 需要從原始碼編譯,所以先透過 Homebrew 處理相依套件:

git clone https://github.com/mxcl/homebrew.git
cd homebrew/bin
brew install autoconf automake libtool
brew install couchdb

這個步驟是安裝過程中最容易卡住的地方。常見的狀況是 formula 裡的軟體下載位址失效,需要手動編輯 ~/couch/homebrew/Library/Formula/couchdb.rb,把 url 中的 source 這一段路徑移除,讓它指向實際的 tarball 位置:

require 'formula'

class Couchdb < Formula
  url 'https://www.apache.org/dyn/closer.cgi?path=couchdb/1.1.1/apache-couchdb-1.1.1.tar.gz'
  homepage "https://couchdb.apache.org/"
  md5 'cd126219b9cb69a4c521abd6960807a6'
end

若安裝過程看起來停住不動,按 Ctrl-C 中斷,改用詳細模式重試以觀察實際進度:

./brew install -v couchdb

編譯完成後,執行 ./couchdb 即可啟動。在瀏覽器打開 https://127.0.0.1:5984/_utils,若看到管理介面就代表安裝成功。

三、取得範例並建立資料庫

git clone https://github.com/indexzero/nodejs-intro.git

確認 CouchDB 已啟動,再用 curl 建立一個資料庫:

$ curl -X PUT https://127.0.0.1:5984/pinpoint-dev10
{"ok":true}

回到 _utils 介面重新整理,就能看到新的資料庫出現在清單裡。

四、系統模組改名:sys 已成為 util

範例寫於 Node 早期版本,新版會直接拋錯:

Error: The "sys" module is now called "util".

0.6.x 版只是警告,0.7 之後則會中斷執行。解法很直接——把所有 require("sys") 換成 require("util"),介面大致相容。

五、用 npm 補齊相依套件

直接執行會看到找不到模組的錯誤:

Error: Cannot find module 'optimist'

範例依賴不少套件,用 npm 逐一安裝即可:

$ npm install optimist
optimist@0.2.8 ../node_modules/optimist
└── wordwrap@0.0.2

套件會被放進 node_modules 目錄。這個範例需要的四個:

npm install winston
npm install cradle
npm install journey
npm install optimist

六、啟動範例伺服器

進入 bin 目錄,用 -t 指定要執行的模組、-s 指定剛才建立的資料庫:

$ ./server -t 02couchdb -s
Pinpoint demo server listening for 02couchdb on https://127.0.0.1:8000

瀏覽器拜訪 https://127.0.0.1:8000/bookmarks,看到 {"bookmarks":[]} 就代表服務正常。

七、用 http-console 操作 REST 介面

想在命令行裡直接跟 REST 服務對話,可以裝 http-console:

sudo npm install -g http-console

它在新版 Node 下同樣會遇到舊 API 問題(require.paths is removed),需要編輯 /usr/local/lib/node_modules/http-console/bin/http-console,刪除這一行:

require.paths.unshift(path.join(__dirname, '..', 'lib'));

接著啟動並切換成 JSON 模式,才能送出正確的 content-type:

$ http-console https://127.0.0.1:8000
https://127.0.0.1:8000/> json

查詢:

https://127.0.0.1:8000/> GET /bookmarks
HTTP/1.1 200 OK
Content-Type: application/json;charset=utf-8

{ bookmarks: [] }

新增一筆:

https://127.0.0.1:8000/> POST /bookmarks
... { "url": "https://nodejs.org" }
HTTP/1.1 200 OK

{ bookmark: { _id: 'WD-G-1', resource: 'Bookmark', url: 'https://nodejs.org' } }

再次 GET,就能撈到剛才寫入的資料,帶著 CouchDB 產生的 _id 與 _rev。

写在最後

這份流程完整反映了那個年代的安裝風景:手動改 formula、手動刪除已移除的 API、逐一補裝相依套件。今天重現它時,這些步驟大多已被 nvm、Homebrew 的官方 formula 與現成的 CouchDB 安裝檔取代,直接照官方文件走會順利得多。不過理解這些錯誤訊息背後的原因——模組改名、API 移除、相依未安裝——在維護任何老專案時都用得上。

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved