# @bonniernews/gcpohoy 中文文档

规范地址：https://npmcn.com/package/%40bonniernews/gcpohoy/

版本：1\.2\.7
npm 元数据更新时间：2026-11-05T09:38:42.789Z
中文译文更新时间：2026-11-08T11:02:54.906Z
软件包许可：MIT

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40bonniernews/gcpohoy
原文对照：https://npmcn.com/package/%40bonniernews/gcpohoy/?lang=original
项目主页：https://github.com/BonnierNews/gcpohoy#readme
源码仓库：https://github.com/BonnierNews/gcpohoy

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：74.7 kB，36 个文件
- 模块格式：CommonJS
- TypeScript 类型：未声明
- 运行依赖：2 个
- 首次发布：2023-06-09T14:09:04.937Z
- 最新版本发布：2026-11-05T09:38:42.581Z
- 近 30 天下载量：4846（2026-10-09 至 2026-11-07，npm 官方下载统计）
- 已发布版本数：26（近 12 个月 7 个）

## 中文简介

用于执行轨道和克云指令的标准化 shell 执行的节点帮助器

## 安装

```sh
npm install @bonniernews/gcpohoy
```

也可以使用：`pnpm add @bonniernews/gcpohoy`、`yarn add @bonniernews/gcpohoy`、`bun add @bonniernews/gcpohoy`

## README

# 鸡尾酒

一个节点模块,帮助您部署,监控和回滚您与Terraform管理的服务(主要是GCP).

## 所需资源

要成功运行此软件包, 您需要 GCloud CLI 和 Terraform :

-   安装 GCloud CLI : [https://cloud.google.com/sdk/docs/install (中文(简体) )](https://cloud.google.com/sdk/docs/install)
-   安装地形 : `brew install terraform`
    -   或下载从 [https://developer.hashicorp.com/terraform/下行负荷](https://developer.hashicorp.com/terraform/downloads)

## 安装

在您想要的工程或全球范围内安装此脚本 . _注意全球安装时可能与节点版本相冲突_

-   `npm i @bonniernews/gcpohoy`
-   `npm i @bonniernews/gcpohoy -g`

## 使用量

在运行 Terraform 和 GCloud 的项目中,您可以使用 Expressen 的标准设置来运行例如:

-   `gcpohoy help`
-   `gcpohoy login`
-   `gcpohoy deploy <environment>`
-   `gcpohoy rollback <environment> -r <revision>`
-   `gcpohoy forward-db <environment> -p <port> -s <secret_pw_name>`

您可以运行 -- help for 任何给定的命令以查看所有可用的参数/选项 :

-   `gcpohoy deploy <environment> --help`

## 多云运行项目

此软件包处理多云项目( 注意: 用不同的参数使用相同的嵌入器图像)

-   `gcpohoy deploy <environment>` - 默认: 部署全部云运行在 Terraform 中.

管理您的服务使用 `--serviceName (-s)`

-   `gcpohoy <deploy|changes|status> <environment> -s <service-name>`
-   `gcpohoy status <environment> -s <service-name>`

说明: `gcpohoy apply` 不支持,你不会支持的 `--serviceName` 旗帜,它运行的一切.

倒转同样有效:

-   `gcpohoy rollback <environment> -s <service-name> -r <revision>`

## CI/CD(吉苏布行动)

在此找到详细指令 [实例/工作流程-实例.md](https://npmcn.com/package/%40bonniernews/gcpohoy/examples/workflow-example.md)

gcpohoy可以很容易地在CI/CD中被使用,其好处是其工作大多与当地相同.

-   gcpohoy需要安装在项目中,而不是全球范围的CI/CD工作.
-   由于gcpohoy无法进入云层中的地貌,你需要指出 `serviceName` 财务报告和审定财务报表 `projectId`
-   查看备注 [实例/工作流程-实例.md](https://npmcn.com/package/%40bonniernews/gcpohoy/examples/workflow-example.md#caveats)

使用gcpohoy的最后一个部署步骤可以看起来像:

```
- name: "Deploy"
    run: npm run deploy ${{inputs.environment}} -- --serviceName=layout-service-${{inputs.environment}} --projectId=${{secrets.gcp-project-id}}
```

## 常见问题

### @bonniernews/gcpohoy 是什么？

用于执行轨道和克云指令的标准化 shell 执行的节点帮助器

### 如何安装 @bonniernews/gcpohoy？

在项目目录运行 npm install @bonniernews/gcpohoy，或使用 pnpm add / yarn add / bun add。它还提供命令行工具 gcpohoy，可以用 npx gcpohoy 直接运行。

### @bonniernews/gcpohoy 支持 TypeScript 吗？

该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/bonniernews\_\_gcpohoy 是否存在。

### @bonniernews/gcpohoy 支持 ESM 还是 CommonJS？

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

### @bonniernews/gcpohoy 可以商用吗？

@bonniernews/gcpohoy 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### @bonniernews/gcpohoy 的下载量有多少？

根据 npm 官方下载统计，@bonniernews/gcpohoy 在 2026/10/09 – 2026/11/07 这 30 天内被下载 4,846 次，日均约 162 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @bonniernews/gcpohoy 还在维护吗？

最新版本 1\.2\.7 发布于 2026/11/05（3 天前）；至今共发布 26 个版本，其中过去 12 个月发布了 7 个；首次发布于 2023/06/09。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。