云纹 CLI
在CloudGrid上建造、运送和运行应用程序和特工 目录或目录 URL在大约30秒内成为一个活的,可地址的事物——部署,尾端日志,共享, 阅读反馈,所有不离开你的外壳.
命令是 grid。 。 。 .
目录
安装
macOS / Linux — 卷曲
curl -fsSL https://raw.githubusercontent.com/cloudgrid-io/cli/main/install.sh | sh
macOS / Linux – 本地人
brew install cloudgrid-io/tap/grid
跨平台(包括Windows)——npm
npm install -g @cloudgrid-io/cli
需要节点.js 22+.
22号节点是CloudGrid构建和测试的东西——月台上的每个多克文件
实值 node:22,每个CI工作运行 node-version: 22。该楼层名称
而不是坐在它的下边。 18号节点于2025年4月离开维修,20号节点
2026年4月;没有获得安全补丁.
在更古老的节点上, npm install -g @cloudgrid-io/cli 打印一个 EBADENGINE
警告和安装 — npm 仅在您设定时拒绝
engine-strict=true。似乎成功的安装不是CLI的信号
会跑的 安装节点 22 或以后安装 .
校验 : grid --version 财务报告和审定财务报表 grid doctor。 。 。 .
软件包安装一个单一命令, grid老年人 cloudgrid, (中文(简体) ), gridctl 财务报告和审定财务报表 cg
名称已退役而未安装 .
快速启动
grid login # Google OAuth in the browser
grid whoami # confirm user + active grid
grid plug # build + deploy the current directory, prints the live URL
grid open # open it in the browser
不需要账户来尝试一次性分享 : grid plug ./index.html 放弃公共链接.
实例
# Scaffold and deploy a Node app
grid new app my-api --type node
cd my-api && grid plug
# Deploy the current directory and tail its logs
grid plug
grid logs --since 10m
# Publish beyond the grid as an unlisted link, then read feedback
grid visibility set my-api --inside grid --outside link
grid feedback
# Switch grid, list what's on it
grid use atomic
grid get entities
图标
可见是两轴—— --inside 谁是网格上的观众
(单位:千美元)private | spaces | grid, (中文(简体) ), --outside 超越它的范围none | link | public) (中文(简体) ).
| 命令 | 目的 |
|---|---|
login 编号 : logout 编号 : whoami | 签名( Google OAuth), 签名, 显示用户 + 活动网格 |
use [slug] | 设置或显示活动网格 |
new [name] | 设置要构建的文件夹( 在您插入或 dev 之前没有服务器实体) |
plug [target] | 构建 + 部署( 或重新部署); 打印活的 URL |
dev | 用网格输入资源在本地运行链接的实体 |
status [name] | 网格仪表板、实体细节或部署快照 |
follow | 在完成之前, 重新跟踪和流出进度 |
logs [name] | 从实体库流出日志 |
open [name] | 在浏览器中打开实体输出 URL |
info [name] | 显示详细的实体元数据 |
rollback 编号 : versions | 滚回先前的部署; 列表、 标签和平针薄荷版本 |
visibility set | 设置两个能见度轴( S)--inside 编号 : --outside(中文(简体) ) |
env 编号 : secrets | 管理 runtime env vars 和 secret( 秘密值永远不会返回) |
vault | 管理网格的金库项目( 只写; 从未打印) |
get 编号 : describe 编号 : create 编号 : delete | 列出、检查、创建和去除网格、实体和空格 |
rename 编号 : unplug | 重命名显示名称; 从网格取出节点 |
pull | 下载实体的源并链接文件夹 plug 更新它 |
pickup | 将您可以看到的应用程序复制到您自己的上行 |
collab | 获得或批准进入实体 |
callers 编号 : calls | 谁可以叫你自己的应用程序; 你的应用程序叫什么 |
link 编号 : wire | 将此文件夹、 repo 或 Webhook 绑入实体 |
domains | 在您自己的域中服务应用程序 |
space | 管理空格 |
hooks | 管理网钩 |
agent | 将代理指令(AGENTS.md + CLAUDE.md)写入此目录 |
scaffold | 已声明的脚手架服务文件夹 cloudgrid.yaml |
ssh | 在运行的吊舱中打开交互 shell |
recipes | 打印运行时间 SDK 配方 |
feedback [message] | 向CloudGrid团队发送反馈 |
doctor | 诊断检查(节点、道克、API可达性、认证) |
completion <shell> | Shell 完成脚本 |
运行 grid <command> --help 用于任何命令的全旗集,以及 grid --help
为完整的列表.
旗帜
全球:
-V, --version——打印CLI版本-v, --verbose详细产出-h, --help- 帮助任何命令
每个命令常见 :
--grid <slug>取出/覆盖电网--json编号 :-o <format>——机器可读出的产出(table | json | yaml | wide(中文(简体) )--no-clipboard编号 :--no-notify- 停止剪贴板复制/操作系统通知plug--since <dur>编号 :--tail <n>—— 说logs窗口
环境
CLOUDGRID_GRID只有这个外壳的有效网格。 接受一击或一击 网格 id 和 覆盖~/.cloudgrid/config.yaml没有改变它.CLOUDGRID_HOME配置和证书所在的地方(默认)~/.cloudgrid) (中文(简体) ).CLOUDGRID_TOKEN——以非互动方式进行认证,而不是grid login。 。 。 .CLOUDGRID_TELEMETRY看到了吗 遥测。 。 。 .
grid use 写入您家目录中的一个文件, 因此适用于每个文件
机器上的 shell - 包括其它终端和任何代理会话运行
平行进行。 当两个贝壳需要不同的网格时, 设定 CLOUDGRID_GRID 相当
而非运行 grid use 在每个
# This shell targets acme; every other shell keeps whatever `grid use` set.
export CLOUDGRID_GRID=acme
grid plug
# Or for a single command, without exporting anything:
CLOUDGRID_GRID=acme grid plug
优先,最高第一: --grid → CLOUDGRID_GRID → grid use。 。 。 .
需要特定网格的脚本 CLOUDGRID_GRID 或者说 --gridA级
调用脚本 grid use 重新点出您拥有的一切的网格
打开,不要放回去.
遥测
CLI向CloudGrid API发送了三种事件类型,而平台则在预发:
error当动词失败时。 抓取 v2 错误代码, HTTP 状态, 请求 id, 和赤动词( 无旗帜, 无位置 args) .success- 开始new, (中文(简体) ),plug, (中文(简体) ),dev, (中文(简体) ),login完成干净之后 抓住动词和时间。 没有源树的有效载荷.feedback- 当你跑的时候grid feedback "<message>"。 。 。 .
每个事件都是 JWT 绑定的(你的用户代号), 以250 ms 的分数出局, 并且从不屏蔽动词 。 文件路径,命令旗,env-var值,JWT,和证书没有被收集. 这个 feedback 动词 --include-log 旗帜是唯一的自由形式路径——它运送了被擦拭的最后200行 ~/.cloudgrid/logs/cli.log。 。 。 .
无法进行遥测
# One-shot, env var (highest priority — overrides config):
CLOUDGRID_TELEMETRY=0 grid plug
# Persistent, written to ~/.cloudgrid/config.yaml:
grid login --no-telemetry
与 CLOUDGRID_TELEMETRY=1 或通过删除 telemetry: false 从您的配置文件.
更新
npm update -g @cloudgrid-io/cli # npm
brew upgrade grid # homebrew
grid doctor 当更新版本可用时警告.
卸载
npm uninstall -g @cloudgrid-io/cli # npm
brew uninstall grid # homebrew
rm -rf ~/.cloudgrid # remove stored credentials + config
解决问题
grid: command not found确保 npm 全球 bin(或 Homebrew bin) 打开$PATH; 重新运行安装器.- 认证错误 / 401 —— 说
grid login再次; 检查grid whoami显示预期网格,切换到grid use <slug>。 。 。 . - 部署失败 - 运行
grid doctor; 检查grid logs财务报告和审定财务报表grid status <name>为追踪.
支助
- 技能+MCP: 云网-io/技能
- 问题: 云网-io/cli/问题
许可证
麻省理工学院. 见 自由主义。 。 。 .