@google-automations/datastore-lock

中文文档
7.2.1发布于 2026/09/16Apache-2.0TypeScriptCommonJS近 30 天下载 1.3万

由 Google 云数据存储器支持的分布式锁定

中文使用文档
文档目录3 节
  1. 使用量
  2. 安装
  3. 使用量

分布式锁

这是一个简单的锁库,由Google Cloud Datastore支持.

Github bots 可以有多个实例,有时这些实例 正在修改同一目标(问题、牵引请求等)。 这么简单 库允许机器人获取 sth 上的锁.

使用量

安装

npm i @google-automations/datastore-lock

使用量

import {DatastoreLock} from '@google-automations/datastore-lock';

// Most of the cases, you can just pass `lockId` and `target`.
// `lockId` is usually the bot name.
// `target` is the target for the lock.

const lockId = 'blunderbuss';
const target = context.payload.pull_request.url;

const lock = new DatastoreLock(lockId, target);
// await lock.peek(); // was there already a lock perhaps?
const result = await lock.acquire();
if (!result) {
    // failure
}
// Do your stuff, and release the lock after you've done.
result = await lock.release();
// The lock will become stale after 20 seconds.
// You can pass the 3rd argument for longer expiry, up to 60 seconds.
const lock2 = new DatastoreLock(lockId, target, 60 * 1000);

版本与发布记录

@google-automations/datastore-lock 共发布 25 个版本,首次发布于 2021/05/19;过去 12 个月发布了 4 个版本。

版本发布日期距今
7.2.1latest2026/09/162 个月前
7.2.02026/07/253 个月前
7.1.42026/06/095 个月前
7.1.32026/04/027 个月前
7.1.22025/10/291.1 年前
7.1.12025/10/081.1 年前

关于 @google-automations/datastore-lock 的常见问题

@google-automations/datastore-lock 是什么?

由 Google 云数据存储器支持的分布式锁定

如何安装 @google-automations/datastore-lock?

在项目目录运行 npm install @google-automations/datastore-lock,或使用 pnpm add / yarn add / bun add。

@google-automations/datastore-lock 支持 TypeScript 吗?

支持。包内自带 TypeScript 类型声明(package.json 声明了 types 入口),安装后即可获得类型提示,无需再安装 @types 包。

@google-automations/datastore-lock 支持 ESM 还是 CommonJS?

以 CommonJS 形式发布,可以直接 require();在 ES Module 项目中也可以用 import 引入(Node.js 会把 module.exports 作为默认导出)。

@google-automations/datastore-lock 需要什么版本的 Node.js?

package.json 的 engines 字段要求 Node.js >= 22。版本不符时 npm 默认只给出警告,开启 engine-strict 后会拒绝安装。

@google-automations/datastore-lock 可以商用吗?

@google-automations/datastore-lock 使用 Apache-2.0 许可。宽松许可:允许商业使用、修改和再分发,并附带明确的专利授权;分发时需保留许可与 NOTICE 文件,修改过的文件要注明改动。以上为概括,不构成法律意见,请以许可原文为准。

@google-automations/datastore-lock 的下载量有多少?

根据 npm 官方下载统计,@google-automations/datastore-lock 在 2026/10/17 – 2026/11/15 这 30 天内被下载 13,402 次,日均约 447 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@google-automations/datastore-lock 还在维护吗?

最新版本 7.2.1 发布于 2026/09/16(2 个月前);至今共发布 25 个版本,其中过去 12 个月发布了 4 个;首次发布于 2021/05/19。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。