render-cli

Render CLI

Render CLI は、ターミナルからサービス、データベース、デプロイを管理します。対話形式での使用、非対話型のスクリプト、CI/CD の自動化に対応しています。

インストール、認証、ワークスペースの選択、コマンドの実行を行う前に、現在のアクセスおよびコマンドの確認手順について references/render-access.md をお読みください。

使用する場面

• ターミナルまたは CI/CD からサービスをデプロイする
• ログをリアルタイムで追跡する
• Render Postgres データベースに対して psql を開く
• 実行中のサービスに SSH 接続する、または一時的なシェルを起動する
• render.yaml Blueprint を検証する
• CI/CD パイプラインで Render の操作をスクリプト化する
• AI コーディングツール向けのエージェントスキルをインストールする

コマンドリファレンス

正確なコマンド一覧とフラグについては、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. curl など、利用可能な URL 取得ツールまたは HTTP クライアントを使って、リンク先の Markdown ドキュメントを直接取得してください。Web 検索の要約でドキュメントの代わりにしないでください。
2. 取得が成功し、想定されるドキュメントが返されたことを確認してから、内容を読んでください。ファイルを保存したり、そのパスを表示したりするだけでは不十分です。
3. 取得に失敗した場合、またはツールで Markdown の応答を読み取れない場合は、リンク先の HTML 版を開いて読んでください。
4. どちらの版も取得できない場合は、最新のリファレンスが利用できないことを明示し、そのスキルにある該当トピック固有の代替手順に従ってください。バンドルされたガイダンスは変わらない制約にのみ使用し、変更される可能性のあるプラットフォームの詳細を推測しないでください。

複数のリファレンスが必要なタスクでは、それぞれにこの手順を適用し、確認できたドキュメントと利用できなかったドキュメントを区別してください。