render

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Render CLI Skill

Render CLI 技能

Manage Render cloud services and datastores directly from the terminal using the Render CLI.

使用Render CLI直接从终端管理Render云服务和数据存储。

When to Use

适用场景

Deploying or restarting a Render service
Listing services, deploys, or datastores
Opening SSH or psql sessions to Render resources
Viewing live service logs
Validating
```
render.yaml
```
blueprint files
Scripting Render operations in CI/CD

部署或重启Render服务
列出服务、部署或数据存储
开启SSH或psql会话连接至Render资源
查看服务实时日志
验证
```
render.yaml
```
蓝图文件
在CI/CD中编写Render操作脚本

Requirements

前提条件

```
render
```
CLI installed (
```
brew install render
```
or other methods)
Authenticated via
```
render login
```
or
```
RENDER_API_KEY
```
env var

已安装
```
render
```
CLI（可通过
```
brew install render
```
或其他方式安装）
通过
```
render login
```
或
```
RENDER_API_KEY
```
环境变量完成身份验证

Commands

命令

Authentication

身份验证

bash

undefined

bash

undefined

Interactive login (opens browser)

交互式登录（打开浏览器）

render login

Or set API key for non-interactive use

或设置API密钥用于非交互场景

export RENDER_API_KEY=rnd_...

undefined

export RENDER_API_KEY=rnd_...

undefined

Workspaces

工作区

bash

undefined

bash

undefined

List workspaces

列出工作区

render workspaces

Set active workspace

设置活跃工作区

render workspace set

undefined

render workspace set

undefined

Services

服务

bash

undefined

bash

undefined

List all services and datastores (interactive)

列出所有服务和数据存储（交互式）

render services

List services as JSON (non-interactive)

以JSON格式列出服务（非交互式）

render services --output json --confirm

undefined

render services --output json --confirm

undefined

Deploys

部署

bash

undefined

bash

undefined

List deploys for a service

列出某个服务的部署记录

render deploys list [SERVICE_ID]

Trigger a deploy

触发一次部署

render deploys create [SERVICE_ID]

Deploy a specific commit

部署指定提交版本

render deploys create [SERVICE_ID] --commit [SHA] --confirm

Deploy a specific Docker image

部署指定Docker镜像

render deploys create [SERVICE_ID] --image [URL] --confirm

Deploy and wait for completion (useful in CI)

部署并等待完成（适用于CI场景）

render deploys create [SERVICE_ID] --wait --confirm

undefined

render deploys create [SERVICE_ID] --wait --confirm

undefined

SSH

SSH连接

bash

undefined

bash

undefined

SSH into a running service instance

SSH连接至运行中的服务实例

render ssh [SERVICE_ID]

Launch an ephemeral shell (isolated, no start command)

启动临时shell（隔离环境，无启动命令）

render ssh [SERVICE_ID] --ephemeral

undefined

render ssh [SERVICE_ID] --ephemeral

undefined

Postgres (psql)

Postgres（psql）

bash

undefined

bash

undefined

Open interactive psql session

打开交互式psql会话

render psql [DATABASE_ID]

Run a single query

执行单个查询

render psql [DATABASE_ID] -c "SELECT NOW();" -o text

Query results as JSON

以JSON格式返回查询结果

render psql [DATABASE_ID] -c "SELECT id, name FROM projects LIMIT 5;" -o json

CSV output via psql passthrough

通过psql透传输出CSV格式结果

render psql [DATABASE_ID] -c "SELECT id, email FROM users;" -o text -- --csv

undefined

render psql [DATABASE_ID] -c "SELECT id, email FROM users;" -o text -- --csv

undefined

Blueprints

蓝图

bash

undefined

bash

undefined

Validate render.yaml (defaults to ./render.yaml)

验证render.yaml（默认路径为./render.yaml）

render blueprints validate

Validate a specific file

验证指定文件

render blueprints validate path/to/render.yaml

undefined

render blueprints validate path/to/render.yaml

undefined

Non-Interactive Mode

非交互模式

For scripting and CI/CD, use these flags:

Flag	Description
`-o` / `--output`	Output format: `json` , `yaml` , `text` , or `interactive` (default)
`--confirm`	Skip confirmation prompts

You can also set output format globally:

bash

export RENDER_OUTPUT=json

对于脚本编写和CI/CD场景，可使用以下参数：

参数	说明
`-o` / `--output`	输出格式： `json` 、 `yaml` 、 `text` 或 `interactive` （默认）
`--confirm`	跳过确认提示

你也可以全局设置输出格式：

bash

export RENDER_OUTPUT=json

Tips

小贴士

Run
```
render
```
with no arguments to see all available commands
Run
```
render help <command>
```
for details on any command
Service IDs are optional in interactive mode — the CLI will prompt you to select
Use
```
--wait
```
on
```
deploys create
```
in CI to block until the deploy finishes (non-zero exit on failure)
CLI tokens expire periodically — re-authenticate with
```
render login
```
if needed

Config is stored at

~/.render/cli.yaml

(override with

RENDER_CLI_CONFIG_PATH

)

直接运行
```
render
```
命令可查看所有可用指令
运行
```
render help <command>
```
查看任意命令的详细说明
在交互模式下，服务ID为可选参数——CLI会提示你进行选择
在CI场景中，对
```
deploys create
```
使用
```
--wait
```
参数可阻塞至部署完成（部署失败时返回非零退出码）
CLI令牌会定期过期——若需要，使用
```
render login
```
重新验证
配置文件存储在
```
~/.render/cli.yaml
```
（可通过
```
RENDER_CLI_CONFIG_PATH
```
覆盖默认路径）