## qunar node 开发解决方案

让你只专注在业务和展现

项目地址：<http://gitlab.corp.qunar.com/fed/koke>

* [本地安装](#local)
* [命令支持](#command)
* [创建koke工程](#create)
* [服务器端安装](#server)
* [服务器web环境配置](#config)

<a name="local"></a>
###  本地安装

    npm install koke -g --registry=http://registry.npm.taobao.org

其他包依赖公司内部的npm源，你需要先安装qnpm，安装方式

通过alias命令

    alias qnpm="npm --registry=http://registry.npm.corp.qunar.com/ --cache=$HOME/.npm/.cache/qnpm --userconfig=$HOME/.qnpmrc"

或者在`~/.bash_profile`或`~/.zshrc`中增加如下配置:

    # alias for qnpm
    alias qnpm="npm --registry=http://registry.npm.corp.qunar.com/ --cache=$HOME/.npm/.cache/qnpm --userconfig=$HOME/.qnpmrc"

然后运行：

    source ~/.bash_profile # base环境
    source ~/.zshrc # zsh环境

<a name="command"></a>
### 命令支持

    Qxf 使用说明
    ===========================
    koke init 初始化一个项目
    koke dev 启动项目本地服务
    koke initserver [-w <webappFoler> -s <serviceName>] 服务器目录和服务初始化
    koke initschema qdr发布系统schema初始化
    koke remote -r <serverlist> -c <remoteCommand> 远程执行命令
    koke sync [server] 同步文件到服务器

<a name="create"></a>
### 如何创建一个koke工程

    1. 在项目目录里执行 `koke init`
    2. 运行 `qnpm install`
    3. 运行 `bin/dev`

<a name="server"></a>
### 服务器安装

1. 新申请的服务器，在申请服务器时可以选择预装QXF，这样就不用到服务器上做任何安装了
2. 如果是原来的服务器或者申请的时候忘了选择预装，需要执行一下步骤安装：

    1. ssh 登录服务器
    2. 运行 `sudo yum install q-node`
    3. 运行 `sudo npm install koke -g --registry=http://registry.npm.taobao.org`

<a name="config"></a>
### 服务器web环境配置

配置web环境有如下三种方式（推荐使用第3种方式配置）：

1. ssh 登录服务器，执行 `sudo koke initserver`按照提示输入所需参数，或者执行 `sudo koke initserver -w <web目录名称> -s <service名称>`

2. 在本地可以ssh登录到服务器的终端执行

        koke remote -r '<服务器列表>' -c 'sudo koke initserver -w <webappFolder> -s <serverName>'

3. 按照说明配置工程里的package.json中的schema内容，在本地可以ssh登录到服务器的终端执行

        koke initserver --config

服务器列表支持格式：

    l-home[m-n].fe.cn5
    l-home[x,y,z].fe.cn5
    l-home[m-n].fe.cn5,l-home[x,y,z].fe.cn5,...