Hi, all

NAE client v1.1 release ！

NAE client 是NAE本地开发的命令行工具，可以通过简单的命令操控NAE上的APP， 欢迎试用，安全起见，首次试用，请先用一个测试目录。记得保护自己的代码哦

任何建议和bug，欢迎跟帖反馈 ， ^_^ 。

安装nae客户端

默认的安装路径 /usr/local/lib/nae/    bin path => /usr/local/bin/nae
之前安装过的，手段删除一下 /usr/local/bin/nae

$ npm install -g nae

安装之后

$ nae -v
# 将打印出版本信息,说明安装成功

使用nae客户端

在开始之前，请仔细阅读这段说明。 nae client在开始使用时需要先身份认证，身份认证需要使用auth命令获取身份认证

$ nae auth

份认证成功之后，会在~/.nae_auth文件中保存认证的token信息。所以当切换用户时，需要重新认证。

nae client执行download动作时，是将服务器端的代码同步到本地。 同步的过程中，“会删除本地有而服务器端没有的文件！！！” 所以在使用download之前，请先commit本地代码，以防代码丢失。

nae client执行upload的时候，同样，“会将本地没有而服务器端有的文件删除！！！” 所以在upload之前，如有必要，请先备份服务器端代码。

身份认证

$ nae auth

查看app状态

$ nae status appname       显示[dev]的app状态
$ nae status appname -o   显示[online]的app状态

启动app

$ nae start appname      启动[dev] app
$ nae start appname -o  启动[online] app

关闭app

$ nae stop appname     关闭[dev] app
$ nae stop appname -o 关闭[online] app

重启app

$ nae restart appname      重启[dev] app
$ nae restart appname -o  重启[online] app

调试app

$ nae debug appname 捕获服务器端调试信息，这是一个组合命令: stdout+stderr+restart

$ nae stdout appname 服务端console.log输出
$ nae stderr appname 服务端error输出

上传app

上传的时候，有需要排除的文件 比如.project .setting等文件，可以在app的根目录下创建一个.naeignore文件，每行一个正则表达，匹配则忽略文件和目录

$ nae syncup appname
$ nae sup appname     这个命令更方便

下载app

下载之后，目录中会有一个索引文件，.naeindex ,这是一个diff文件，不要删除它，client需要这个文件

$ nae syncdown appname
$ nae sdown appname  这个命令更方便

发布app

$ nae pub appname 将app发布到online模式

帮助信息

$ nae help

更新客户端

$ nae update  注意权限，如果安装的时候sudo了，请sudo执行这条命令

启动app

当cd到app目录中时，nae命令可以省略appname，比如:

$ nae start
# 重启
$ nae restart

.naeignore

.naeignore文件策略

. naeignore 文件用来控制syncup、syncdown时，过滤不必要的文件传输，比如一些用户数据、版本控制文件、服务器日志等等。 syncup的时候，使用本地的. naeignore文件， syncdown的时候，使用服务器端的. naeignore文件

.naeignore 编写范例：

每行一条规则；

规则       等价于正则表达    结果
db/*          => ^db\/.*$    过滤服务器根目录下的db目录下的所有文件，db目录不会被过滤
db            => ^db$    仅过滤服务器根目录下名为 db的文件|目录（如果目录，文件不被过滤）
log/*.error  => ^\/log\/.*\.error$    过滤服务器根目录下 log目录下的 .error后缀的文件
upload/*    => ^upload\/.*$    过滤上传目录下的所有文件
package.json   => ^package\.json$    过滤nae的配置文件
config.js        => ^config\.js$    过滤工程的配置文件

nae默认过滤 .svn .git .cvs目录
.naeignore 的匹配规则作用与相对于app根目录的文件路径 ，例如有一个app的名字叫 docs,
那么要排除 docs的 data/ 目录的上传下载 ，则需要规则 "data/.*"。 

支持的平台

linux shell 
windows git-bash