使用Node.js + Mongodb构建基于Cloud Foundry的项目

随着云计算的兴起，很多厂商都推出了自己的云计算平台，如VMware、Amazon、Google、Microsoft等。本文将介绍VMware公司的云计算平台 - Cloud Foundry，本文将使用Node.js + MongoDB构建基于Cloud Foundry的项目。必备知识：Node.js和NPM命令行的使用。Node.js的语法。MongoDB的语法

kenshin520

2564人浏览 · 2012-10-15 15:33:29

kenshin520 · 2012-10-15 15:33:29 发布

随着云计算的兴起，很多厂商都推出了自己的云计算平台，如VMware、Amazon、Google、Microsoft等。

本文将介绍VMware公司的云计算平台 - Cloud Foundry，本文将使用Node.js + MongoDB构建基于Cloud Foundry的项目。

必备知识：

Node.js和NPM命令行的使用。
Node.js的语法。
MongoDB的语法。
Mongoose的语法。

环境搭建：

Windows 7
Node.js + Ruby + vmc（Cloud Foundry CIL命令行工具）

用户级别及难度：

全部用户
适中

范例文件：

http://pan.baidu.com/share/link?shareid=30772&uk=2298510329

通过本文将学会：

掌握Node.js、Ruby、DevKit、vmc（Cloud Foundry CIL命令行工具）的环境配置。
使用tunnel连接Cloud Foundry远程数据库（MongoDB）的方式。

Node.js的配置：

下载：http://nodejs.org/download/
配置：
- 根据实际情况下载对应的node.js安装包。（选择的版本尽量与Cloud Foundry的Node.js环境保持一致）
- 由于使用了msi方案，所以直接双击下载后的安装包即可。
- 重启系统。
验证：
- 在cmd中键入：node -v / npm -v 如果出现相应的版本号，则安装成功。

Ruby的配置：

Cloud Foundry的操作基于vmc（CIL命令行工具），安装vmc前需要Ruby环境。
由于需要使用Devkit，所以此处的Ruby版本为：1.9.2。（1.9.3在DevKit下有问题）
下载：https://rubyforge.org/frs/?group_id=167（请下载1.9.2-p290版本）
配置：
- 解压到任意文件夹，如：{盘符}:\DevTools\ruby-1.9.2-p290。
- 在Windows环境变量中增加：
  - RUBY_HOME = {盘符}:\DevTools\ruby-1.9.2-p290
  - Path += %RUBY_HOME%\bin（需配置在系统环境变量，而非用户环境变量）
- 重启系统。
验证：
- 在cmd中键入：ruby -v / gem -v 如果出现版本号，则安装成功。

vmc的安装：

安装：
- 使用gem安装vmc，在cmd中键入gem install vmc。（无需重启）
验证：
- 在cmd中键入vmc -v，如果出现版本号，则安装成功。

vmc的使用：

建立连接：
- vmc target api.cloudfoundry.com（指定Cloud Foundry API地址）
建立账户：
- 通过网站建立：在http://www.cloudfoundry.com/建立账户。
- 通过vmc建立，在cmd中键入：vmc add-user [--email, --passwd]。
登陆：
- 在cmd中键入：vmc login（根据提示输入注册时的邮箱地址及密码）

建立app（Node.js）：

在本地建立文件夹，如：{盘符}:\nodejs\local\testcf
定位到testcf根目录，在cmd中键入：npm install express

在testcf文件夹中新增index.js文件，并键入如下内容：

var express = require('express');
var app     = express();
app.get('/', function(req, res) {
    res.send('Hello from Cloud Foundry');
});
app.listen( process.env.VMC_APP_PORT || 3000 );
console.log( "Server start up!" );

本机测试：
- 定位到testcf根目录，在cmd中键入：node index.js
- 控制台出现：“Server start up!”后，在浏览器中键入：http://loaclhost:3000，如显示“Hello from Cloud Foundry”，说明运行成功。

上传App到Cloud Foundry：

定位到testcf根目录，在cmd中键入：vmc push --runtime=node08，生成如下的内容：

Would you like to deploy from the current directory? [Yn]: y
Application Name: ks-test-cf
Detected a Node.js Application, is this correct? [Yn]: y
Application Deployed URL [ks-test-cf.cloudfoundry.com]:
Memory reservation (128M, 256M, 512M, 1G, 2G) [64M]: 128
How many instances? [1]: 1
Bind existing services to 'ks-test-cf'? [yN]: n
Create services to bind to 'ks-test-cf'? [yN]: n
Would you like to save this configuration? [yN]: y
Manifest written to manifest.yml.
Creating Application: OK
Uploading Application:
  Checking for available resources: OK
  Processing resources: OK
  Packing application: OK
  Uploading (22K): OK
Push Status: OK
Staging Application 'ks-test-cf': OK
Starting Application 'ks-test-cf': OK

注：上述英文比较简单，翻译略过。由于当前项目并没有使用数据库，所以
不需要绑定（Binding）和建立（Create）任何Service。

- 在浏览器中键入：http://ks-test-cf.cloudfoundry.com/，如出现“Hello from Cloud Foundry”，说明运行成功。（与在本地运行效果一样）

MongoDB的配置：

下载：
- http://www.mongodb.org/downloads
配置：
- 根据实际情况下载对应的MongoDB压缩包。
  注：由于Cloud Foundry对应MongoDB的版本是2.0，所以避免出现本地测试环境与Cloud Foundry不一致的情况，尽量选择相应版本。
- 解压到任意文件夹，如：{盘符}:\DevTools\mongodb-2.0.7。
- 在Windows环境变量中增加：
  - MONGODB_HOME = {盘符}:\DevTools\mongodb-2.0.7
  - Path += %MONGODB_HOME%\bin
- 重启系统。
验证：
- 在cmd中键入：mongo --version 如出现版本号，则安装成功。
使用：
- 在本地建立一个文件夹，如：{盘符}:\mongodb\testdb。
- 在cmd中键入：mongod --dbpath {盘符}:\mongodb\testdb，即可连接到本地数据库。

注：可以使用MongoVUE等客户端操作MongoDB。

Mongoose的配置：

Mongoose是第三方的Noe.js模块，可以更方便的操作MongoDB。
下载：
- 在cmd中键入：npm install mongoose
验证：（如出现类似下图的内容，说明安装成功）

注意：
- mongoose在安装的时候需要依赖于mongodb（Node.js模块）
- 如mongodb模块未安装的话，mongoose会自动安装，如上图所示。
- 独立安装mongodb，在cmd中键入：npm install mongodb（注意npm的版本必须要大于1.1.19,否则会出现错误）

Node.js 连接MongoDB：（Localhost本地方式）

Mongoose的引入：
```
var db = require( 'mongoose' );
```

定义一个Object结构：（为了与Cloud Foundry配合）

mongo = {
    'hostname' : 'localhost',
    'port'     : 27017,
    'username' : '',
    'password' : '',
    'db'      : testdb
}

注：hostname、port和db这三个属性。（应与你的开发环境相对应）

生成mongoose连接mongodb时的URL字符串：

var generate_mongo_url = function( mongo ) {
  return 'mongodb://' + mongo.hostname + ':' + mongo.port + '/' + mongo.db;
}

连接数据库（MongoDB）：
```
db.connect( mongourl );
```

建立Schame及模型：

var Schema   = db.Schema,
    ObjectId = Schema.ObjectId;
var testSchema = new Schema({
  host  : String,
  dbs   : String,
  time  : Date
});

绑定模型：

var TestModule = db.model( 'test-cloudfoundry', testSchema );

注：test-cloudfoundry是Collection的名字（Collection相当于SQL的Table概念）

保存数据到Collection：

var test   = new TestModule();
  test.host  = mongo.hostname;
  test.dbs   = mongo.db;
  test.time  = new Date();
  test.save( function( err ) {
    if (!err) {
      console.log( 'save complete' )
    }
    else {
      console.log( 'save error = ' + err )
    }
  });

注：save方法相当于SQL的Insert语句，同时Mongoose还定义了回调函数
以供使用。

运行：
- 使用mongod --dbpath的方式连接到本地的MongoDB。
- 定位到test-cf根目录，在cmd中键入：node index.js。
- 在浏览器中访问http://localhost:3000/，在cmd中出现如下内容，则说明调用MongoDB成功。
```
mongodb url : mongodb://localhost:2701
/testdbServer start at http://localhost:3000
save complete
```

注意：
- 变量mongo可以不用定义为Object类型，只是为了与Cloud Foundry配合才这么处理。
- Mongoose独特的Schame机制对应了Table数据结构。

连接Cloud Foundry远程数据库：

安装：

gem install eventmachine --pre

gem install caldecott（如出现异常或如下错误，则需要安装DevKit，否则跳过本节）

Please update your PATH to include build tools or download the DevKit
from 'http://rubyinstaller.org/downloads' and follow the instruction
at 'http://github.com/oneclick/rubyinstaller/wiki/Development-Kit'

DevKit的安装：
- 下载：http://rubyinstaller.org/downloads/
- 配置：
  - 解压到任意文件夹，如{盘符}:\DevTools\devkit-4.5.2
  - 定位到devkit-4.5.2根目录，在cmd中键入：ruby dk.rb init
  - 正确安装后，会生成config.yml文件，编辑此文件并键入ruby所在的目录，格式：- {盘符}:/DevTools/ruby-1.9.2-p290（注意横岗、斜杠）
  - ruby dk.rb review（检查要添加DevKit支持的Ruby列表是否有误，可以略过）
  - ruby dk.rb install
- 验证：
  - gem install caldecott
  - 如未出现任何错误信息，则安装成功。
- 注意：
  - DevKit版本号：DevKit-tdm-32-4.5.2-20111229-1559-sfx.exe
  - DevKit-tdm-32-4.5.2-20111229-1559-sfx.exe对应的Ruby版本：1.9.2-p290

注：上述版本的匹配已验证通过，其他版本未验证。

Node.js 连接MongoDB：（Cloud Foundry远程方式）

新建MongoDB Service：
- vmc create-service mongodb testdb
绑定Service到App（ks-test-cf）：
- vmc bind-service testdb ks-test-cf
  注：testdb是刚刚建立的MongoDB；ks-test-cf是之前上传（push）的App Name。

对Node.js连接本地MongoDB进行改造：

修改mongo变量：

if( process.env.VCAP_SERVICES ) {
  var env = JSON.parse( process.env.VCAP_SERVICES );
  mongo   = env[ 'mongodb-2.0' ][ 0 ][ 'credentials' ];
}
else {
  mongo = {
    'hostname' : 'localhost',
    'port'     : 27017,
    'username' : '',
    'password' : '',
    'db'       : 'testdb'
  }
}

                注：增加判断当前环境的逻辑，process.env.VCAP_SERVICES是Node.js
                提供的系统变量（JSON），保存了当前登陆Cloud Foundry App
              （ks-test-cf）的必要信息。

修改generate_mongo_url方法：

var generate_mongo_url = function( obj ) {
  if( process.env.VCAP_SERVICES ) {
    return 'mongodb://' + obj.username + ':' + obj.password + '@' + obj.hostname + ':' + obj.port + '/' + obj.db;
  }
  else {
    return 'mongodb://' + obj.hostname + ':' + obj.port + '/' + obj.db;
  }
}

注：加入了当前环境为Cloud Foundry时，生成mongodb字符串的逻辑，
相对本地连接url来说，增加了username、password。

更新：

定位到testcf根目录，在cmd中键入：vmc update ks-test-cf，如出现下面的内容，则说明更新成功：

Uploading Application:
  Checking for available resources: OK
  Processing resources: OK
  Packing application: OK
  Uploading (26K): OK
Push Status: OK
Stopping Application 'ks-test-cf': OK
Staging Application 'ks-test-cf': OK
Starting Application 'ks-test-cf': OK

运行：
- 在浏览器中键入：http://ks-test-cf.cloudfoundry.com/
- 在cmd中键入：vmc logs ks-test-cf（查看ks-test-cf的后台打印信息）
```
Server start up!
mongodb url : mongodb:/XXXXXXXXXXX:XXXXXXXXXXX@172.30.48.68:25176/db
Server start at http://172.30.50.21:12265
save complete
```

远程连接Cloud Foundry数据库（testdb）：

在cmd中键入：vmc tunnel testdb，会出现如下内容：

Binding Service [testdb]: OK
Stopping Application 'caldecott': OK
Staging Application 'caldecott': OK
Starting Application 'caldecott': OK
Getting tunnel connection info: OK
Service connection info:
  username : XXXXXXXXXXX
  password : XXXXXXXXXXX
  name     : db
  url      : mongodb://XXXXXXXXXXX:XXXXXXXXXXX@172.30.48.68:25176/db
                                                                
Starting tunnel to testdb on port 10000.
1: none
2: mongo
3: mongodump
4: mongorestore
                                                                
Which client would you like to start

注：其中username和password是Cloud Foundry系统生成，在这里已经隐
去。选择1，可以使用本地客户端进行连接，如之前提到的MongoVUE。

MongoVUE的连接：

注：Service、Port按照如上填写；Username、Password、Database(s)
按照Cloud Foundry给出的内容填写。

注意：
- 注意env[ 'mongodb-2.0' ][ 0 ][ 'credentials' ]中的'mongodb-2.0'指：MongoDB的版本号。
- 使用vmc tunnel testdb的时候，需要根据“连接Cloud Foundry远程数据库”节进行配置。
- 上述修改只给出关键代码，余下代码请看附件。

总结：