render-cli

Render CLI

Render CLI 可在终端中管理服务、数据库和部署。支持交互式使用、非交互式脚本以及 CI/CD 自动化。

在安装、进行身份验证、选择工作区或运行命令之前，请阅读 references/render-access.md，了解当前的访问和命令发现工作流。

适用场景

• 从终端或 CI/CD 部署服务
• 实时查看日志
• 打开 psql，连接 Render Postgres 数据库
• 通过 SSH 连接到正在运行的服务，或启动临时 Shell
• 验证 render.yaml Blueprint
• 在 CI/CD 流水线中编写脚本来执行 Render 操作
• 为 AI 编码工具安装 Agent 技能

命令参考

请按照 references/render-access.md 中的指引，使用已安装 CLI 的帮助信息或生成的命令参考，查看准确的命令和标志。以下模式涵盖常见的运维工作流。

部署模式

# Deploy and wait for completion (exits non-zero on failure)
render deploys create srv-xxx --wait --confirm -o json

# Deploy a specific commit
render deploys create srv-xxx --commit abc123 --wait --confirm

# Deploy a specific Docker image
render deploys create srv-xxx --image ghcr.io/org/app:v1.2.3 --wait --confirm

数据库查询

# Single query, JSON output
render psql db-xxx -c "SELECT NOW();" -o json

# CSV output via psql passthrough
render psql db-xxx -c "SELECT id, email FROM users;" -o text -- --csv

CI/CD 示例（GitHub Actions）

name: Deploy to Render
on:
  push:
    branches: [main]
jobs:
  deploy:
    runs-on: ubuntu-latest
    steps:
      - name: Install Render CLI
        run: |
          curl --fail-with-body --silent --show-error --location \
            https://raw.githubusercontent.com/render-oss/cli/refs/heads/main/bin/install.sh \
            --output /tmp/install-render-cli.sh
          sudo sh /tmp/install-render-cli.sh
          render --version
      - name: Deploy
        env:
          RENDER_API_KEY: ${{ secrets.RENDER_API_KEY }}
        run: render deploys create ${{ secrets.RENDER_SERVICE_ID }} --wait --confirm -o json

如果可复现构建需要固定 CLI 版本，请选择当前受支持的版本，并在当前版本发布文档中核实其资源名称，不要照搬此技能中的版本。

本地配置

配置文件：~/.render/cli.yaml

使用 RENDER_CLI_CONFIG_DIR 覆盖配置目录。RENDER_CLI_CONFIG_PATH 是为保持兼容性而保留的旧版文件级覆盖选项，计划弃用。

常见错误

错误	修正方法
在 CI 中部署时未使用 --wait	添加 --wait，确保部署失败时任务也会失败

参考资料

文档	内容
references/render-access.md	当前 CLI 身份验证、工作区、文档、输出和授权工作流
references/command-cheatsheet.md	常见运维命令示例和脚本编写模式

相关技能

• render-deploy — 端到端部署流程、MCP 操作、Dashboard 深度链接
• render-blueprints — render.yaml 编写与验证
• render-postgres — 数据库连接、render psql 用法
• render-debug — 使用 render logs 和 render ssh 排查问题

获取当前文档

每当此技能要求查阅当前 Render 文档时：

1. 使用可用的 URL 获取工具或 HTTP 客户端（例如 curl），直接获取链接的 Markdown 文档。不要用网页搜索摘要代替文档。
2. 确认获取成功且返回了预期文档，然后阅读其内容。仅保存文件或打印文件路径并不足够。
3. 如果请求失败，或工具无法读取 Markdown 响应，请打开并阅读链接的 HTML 版本。
4. 如果两个版本都无法获取，请说明当前参考资料不可用，并遵循此技能中针对该主题的回退方案。仅将随附指南用于稳定的约束，不要猜测可能变化的平台细节。

如果任务需要多个参考资料，请对每份资料分别采用此流程，并区分已核实的文档与仍无法获取的文档。