99 lines
2.7 KiB
Markdown
99 lines
2.7 KiB
Markdown
|
# 命令行
|
|||
|
|
|
|||
|
|
## 简介
|
|||
|
|
|
|||
|
|
NocoBase Server Application 除了用作 WEB 服务器以外，也是个强大可扩展的 CLI 工具。
|
|||
|
|
|
|||
|
|
新建一个 `app.js` 文件，代码如下：
|
|||
|
|
|
|||
|
|
```ts
|
|||
|
|
const Application = require('@nocobase/server');
|
|||
|
|
|
|||
|
|
// 此处省略具体配置
|
|||
|
|
const app = new Application({/*...*/});
|
|||
|
|
|
|||
|
|
app.runAsCLI();
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
以 `runAsCLI()` 方式运行的 app.js 是一个 CLI，在命令行工具就可以像这样操作了：
|
|||
|
|
|
|||
|
|
```bash
|
|||
|
|
node app.js install # 安装
|
|||
|
|
node app.js start # 启动
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
为了更好的开发、构建和部署 NocoBase 应用，NocoBase 内置了许多命令，详情查看 [NocoBase CLI](/api/cli) 章节。
|
|||
|
|
|
|||
|
|
## 自定义 Command
|
|||
|
|
|
|||
|
|
NocoBase CLI 的设计思想与 [Laravel Artisan](https://laravel.com/docs/9.x/artisan) 非常相似，都是可扩展的。NocoBase CLI 基于 [commander](https://www.npmjs.com/package/commander) 实现，可以这样扩展 Command：
|
|||
|
|
|
|||
|
|
```ts
|
|||
|
|
app
|
|||
|
|
.command('echo')
|
|||
|
|
.option('-v, --version');
|
|||
|
|
.action(async ([options]) => {
|
|||
|
|
console.log('Hello World!');
|
|||
|
|
if (options.version) {
|
|||
|
|
console.log('Current version:', app.getVersion());
|
|||
|
|
}
|
|||
|
|
});
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
这个方法定义了以下命令：
|
|||
|
|
|
|||
|
|
```bash
|
|||
|
|
yarn nocobase echo
|
|||
|
|
# Hello World!
|
|||
|
|
yarn nocobase echo -v
|
|||
|
|
# Hello World!
|
|||
|
|
# Current version: 0.7.4-alpha.7
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
更多 API 细节可参考 [Application.command()](/api/server/application#command) 部分。
|
|||
|
|
|
|||
|
|
## 示例
|
|||
|
|
|
|||
|
|
### 定义导出数据表的命令
|
|||
|
|
|
|||
|
|
如果我们希望把应用的数据表中的数据导出成 JSON 文件，可以定义一个如下的子命令：
|
|||
|
|
|
|||
|
|
```ts
|
|||
|
|
import path from 'path';
|
|||
|
|
import * as fs from 'fs/promises';
|
|||
|
|
|
|||
|
|
class MyPlugin extends Plugin {
|
|||
|
|
load() {
|
|||
|
|
this.app
|
|||
|
|
.command('export')
|
|||
|
|
.option('-o, --output-dir')
|
|||
|
|
.action(async (options, ...collections) => {
|
|||
|
|
const { outputDir = path.join(process.env.PWD, 'storage') } = options;
|
|||
|
|
await collections.reduce((promise, collection) => promise.then(async () => {
|
|||
|
|
if (!this.db.hasCollection(collection)) {
|
|||
|
|
console.warn('No such collection:', collection);
|
|||
|
|
return;
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
const repo = this.db.getRepository(collection);
|
|||
|
|
const data = repo.find();
|
|||
|
|
await fs.writeFile(path.join(outputDir, `${collection}.json`), JSON.stringify(data), { mode: 0o644 });
|
|||
|
|
}), Promise.resolve());
|
|||
|
|
});
|
|||
|
|
}
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
注册和激活插件之后在命令行调用：
|
|||
|
|
|
|||
|
|
```bash
|
|||
|
|
mkdir -p ./storage/backups
|
|||
|
|
yarn nocobase export -o ./storage/backups users
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
执行后会生成 `./storage/backups/users.json` 文件包含数据表中的数据。
|
|||
|
|
|
|||
|
|
## 小结
|
|||
|
|
|
|||
|
|
本章所涉及示例代码整合在 [packages/samples/command](https://github.com/nocobase/nocobase/tree/main/packages/samples/command) 包中，可以直接在本地运行，查看效果。
|