Render CLI Expert

Overview

Render CLIは、Renderクラウドプラットフォームのサービスをターミナルから直接管理するための公式CLIツールです。このスキルは、Render CLIを使用した効率的なサービス管理、デプロイ自動化、トラブルシューティングを支援します。

Auto-Update Mechanism

重要: このスキルには自動更新チェック機能があります。

スキルが呼び出されたとき、前回の公式ドキュメントチェックから1ヶ月以上経過している場合、自動的に最新情報を取得します。

# 更新チェックを手動で実行
python3 ~/.claude/skills/render-cli-expert/scripts/render_cli_updater.py

# 強制更新（経過時間に関係なく）
python3 ~/.claude/skills/render-cli-expert/scripts/render_cli_updater.py --force

更新ログは references/cli_updates.md に記録されます。

When to Use This Skill

• Renderサービスをターミナルからデプロイ・管理したい
• サービスのログをリアルタイムで監視したい
• PostgreSQLデータベースにpsqlで接続したい
• SSHでサービスにリモート接続したい
• CI/CDパイプラインでRender操作を自動化したい
• ワークスペースやサービスの一覧を取得したい

Example triggers:

• "Renderにデプロイしたい"
• "Renderのログを見たい"
• "RenderのPostgreSQLに接続したい"
• "Render CLIの使い方を教えて"
• "CI/CDでRenderを自動化したい"

Installation

Homebrew (macOS/Linux - Recommended)

brew update
brew install render

Direct Download (Linux/macOS)

curl -fsSL https://raw.githubusercontent.com/render-oss/cli/refs/heads/main/bin/install.sh | sh

From Source (Go required)

git clone git@github.com:render-oss/cli.git
cd cli
go build -o render

Verify Installation

render --version

Authentication

Interactive Login (Development)

render login

ブラウザが開き、"Generate token"をクリックしてトークンを生成。その後ワークスペースを選択します。

API Key Authentication (CI/CD Automation)

# 環境変数でAPIキーを設定
export RENDER_API_KEY=rnd_RUExip...

# 以降のコマンドは自動的に認証される
render services

Note: APIキーはCLIトークンより優先されます。長期未使用時はトークンが期限切れになることがあります。

Core Commands Reference

Workspace Management

# アクティブなワークスペースを設定
render workspace set

# ワークスペース一覧を表示
render workspace list

Services

# サービス一覧を表示（インタラクティブ）
render services

# JSON形式で出力
render services -o json

# 特定のサービス詳細
render services show srv-abc123

Deploys

# デプロイを実行（インタラクティブ）
render deploys create

# 特定サービスのデプロイ
render deploys create srv-abc123

# デプロイ完了まで待機
render deploys create srv-abc123 --wait

# 特定のGitコミットをデプロイ
render deploys create srv-abc123 --commit abc123def

# 特定のDockerイメージをデプロイ
render deploys create srv-abc123 --image registry.example.com/app:v1.0

# デプロイ履歴を表示
render deploys list srv-abc123

Logs

# ログを表示（インタラクティブ）
render logs

# 特定サービスのログ
render logs srv-abc123

# リアルタイムでログをフォロー
render logs srv-abc123 --tail

# JSON形式で出力
render logs srv-abc123 -o json

PostgreSQL (psql)

# PostgreSQLに接続（インタラクティブ）
render psql

# 特定のデータベースに接続
render psql dpg-abc123

SSH

# SSHでサービスに接続（インタラクティブ）
render ssh

# 特定のサービスに接続
render ssh srv-abc123

Standard SSH (Alternative):

ssh YOUR_SERVICE@ssh.YOUR_REGION.render.com

# 特定インスタンスに接続
ssh srv-abc123-d4e5f@ssh.oregon.render.com

# 詳細モード（トラブルシューティング用）
ssh -v YOUR_SERVICE@ssh.YOUR_REGION.render.com

Note: SSH対応はペイドサービス（Web Services, Private Services, Background Workers）のみ。Freeサービスは非対応。

Service Restart

# サービスを再起動
render restart srv-abc123

Jobs

# ワンオフジョブをトリガー
render jobs create srv-abc123

Output Formats

Available Formats

# JSON形式
render services -o json

# YAML形式
render services -o yaml

# テキスト形式（デフォルト）
render services -o text

Automation Flags

# 確認プロンプトをスキップ
render deploys create srv-abc123 --confirm

# 完了まで待機
render deploys create srv-abc123 --wait

CI/CD Integration Patterns

GitHub Actions Example

name: Deploy to Render

on:
  push:
    branches: [main]

jobs:
  deploy:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4

      - name: Install Render CLI
        run: |
          curl -fsSL https://raw.githubusercontent.com/render-oss/cli/refs/heads/main/bin/install.sh | sh

      - name: Deploy
        env:
          RENDER_API_KEY: ${{ secrets.RENDER_API_KEY }}
        run: |
          render deploys create ${{ secrets.RENDER_SERVICE_ID }} --wait --confirm

Shell Script Pattern

#!/bin/bash
set -e

# APIキーを環境変数から取得
export RENDER_API_KEY="${RENDER_API_KEY}"

# サービスIDを指定
SERVICE_ID="srv-abc123"

# デプロイを実行して完了を待機
echo "Deploying to Render..."
render deploys create "$SERVICE_ID" --wait --confirm -o json

# デプロイ成功を確認
if [ $? -eq 0 ]; then
    echo "Deployment successful!"
else
    echo "Deployment failed!"
    exit 1
fi

Configuration

Config File Location

$HOME/.render/cli.yaml

Custom Config Path

export RENDER_CLI_CONFIG_PATH=/path/to/custom/cli.yaml

Common Patterns

Pattern 1: Quick Deploy with Wait

# デプロイして完了まで待機、確認スキップ
render deploys create srv-abc123 --wait --confirm

Pattern 2: Log Monitoring

# リアルタイムログ監視
render logs srv-abc123 --tail

# JSON形式でログを取得（ログ解析用）
render logs srv-abc123 -o json > logs.json

Pattern 3: Database Backup via psql

# PostgreSQLに接続してバックアップ
render psql dpg-abc123 -c "\\copy (SELECT * FROM users) TO '/tmp/users.csv' WITH CSV HEADER"

Pattern 4: Service Health Check

# サービス一覧をJSON取得
render services -o json | jq '.[] | {name, status}'

Pattern 5: Bulk Operations Script

#!/bin/bash
# 複数サービスのステータス確認

SERVICES=$(render services -o json | jq -r '.[].id')

for svc in $SERVICES; do
    echo "Service: $svc"
    render services show "$svc" -o json | jq '{name, status, updatedAt}'
    echo "---"
done

Troubleshooting

Authentication Issues

# トークンの再生成
render login

# APIキーが正しく設定されているか確認
echo $RENDER_API_KEY

SSH Connection Issues

# 詳細モードで接続をデバッグ
ssh -v YOUR_SERVICE@ssh.YOUR_REGION.render.com

# SSHキーが登録されているか確認
# Render Dashboard > Account Settings > SSH Keys

Command Not Found

# PATHにrender CLIが含まれているか確認
which render

# Homebrewの場合は更新
brew upgrade render

Best Practices

1. CI/CD ではAPIキーを使用: 環境変数 RENDER_API_KEY でAPIキーを設定
2. --waitフラグを活用: デプロイ完了を確認してから次のステップに進む
3. JSON出力を活用: 自動化スクリプトでは -o json でパース可能な出力を取得
4. --confirmフラグで自動化: 確認プロンプトをスキップして非対話的に実行
5. サービスIDを変数化: 環境変数でサービスIDを管理してハードコードを避ける
6. シークレット管理: APIキーをコードに直接書かず、環境変数やシークレット管理ツールを使用

Resources

Official Documentation

• Render CLI Docs
• SSH Documentation
• Render API Reference

scripts/

• render_cli_updater.py: 公式ドキュメントの定期更新チェックスクリプト

references/

• last_check.json: 最終更新チェック日時の記録
• cli_updates.md: 最新の更新情報ログ（自動生成）