render-automation

Rube MCP による Render の自動化

Rube MCP を介して Composio の Render ツールキットを使用し、Render クラウドプラットフォームの操作を自動化します。

ツールキットのドキュメント: composio.dev/toolkits/render

前提条件

• Rube MCP が接続されていること（RUBE_SEARCH_TOOLS が使用可能であること）
• ツールキット render を指定した RUBE_MANAGE_CONNECTIONS による Render へのアクティブな接続
• 現在のツールスキーマを取得するため、必ず最初に RUBE_SEARCH_TOOLS を呼び出してください

セットアップ

Rube MCP の取得: クライアント設定で https://rube.app/mcp を MCP サーバーとして追加します。API キーは不要です。エンドポイントを追加するだけで動作します。

1. RUBE_SEARCH_TOOLS が応答することを確認し、Rube MCP が利用可能であることを確かめます
2. ツールキット render を指定して RUBE_MANAGE_CONNECTIONS を呼び出します
3. 接続が ACTIVE でない場合は、返された認証リンクに従って Render の認証を完了します
4. ワークフローを実行する前に、接続ステータスが ACTIVE であることを確認します

主なワークフロー

1. サービスの一覧表示と確認

使用する状況: ユーザーが Render のサービス（ウェブサービス、静的サイト、ワーカー、cron ジョブ）を検索または確認したい場合

ツールの順序:

1. RENDER_LIST_SERVICES - オプションのフィルターを指定してすべてのサービスを一覧表示します [必須]

主なパラメーター:

• name: 名前に指定した文字列を含むサービスで絞り込みます
• type: サービスの種類（'web_service'、'static_site'、'private_service'、'background_worker'、'cron_job'）で絞り込みます
• limit: 1 ページあたりの最大結果数（デフォルト 20、最大 100）
• cursor: 前回の応答から取得したページネーションカーソル

注意点:

• サービスの種類には、正確な列挙値を指定する必要があります: 'web_service'、'static_site'、'private_service'、'background_worker'、'cron_job'
• ページネーションにはカーソル方式を使用します。cursor がなくなるまで続けてください
• 名前によるフィルターは部分一致であり、完全一致ではありません
• サービス ID の形式は 'srv-xxxxxxxxxxxx' です
• デフォルトの limit は 20 です。すべての結果を確認するには、より大きな値を設定してください

2. デプロイの開始

使用する状況: ユーザーがサービスを手動でデプロイまたは再デプロイしたい場合

ツールの順序:

1. RENDER_LIST_SERVICES - デプロイするサービスを検索します [前提条件]
2. RENDER_TRIGGER_DEPLOY - 新しいデプロイを開始します [必須]
3. RENDER_RETRIEVE_DEPLOY - デプロイの進行状況を確認します [任意]

主なパラメーター:

• TRIGGER_DEPLOY の場合:
  • serviceId: デプロイするサービス ID（必須、形式: 'srv-xxxxxxxxxxxx'）
  • clearCache: デプロイ前にビルドキャッシュをクリアするには true を設定します
• RETRIEVE_DEPLOY の場合:
  • serviceId: サービス ID
  • deployId: トリガー応答から取得したデプロイ ID（形式: 'dep-xxxxxxxxxxxx'）

注意点:

• serviceId は必須です。最初に LIST_SERVICES で確認してください
• サービス ID は 'srv-' で始まります
• デプロイ ID は 'dep-' で始まります
• clearCache: true を設定するとクリーンビルドが強制されます。時間はかかりますが、キャッシュ関連の問題を解決できます
• デプロイは非同期で実行されます。RENDER_RETRIEVE_DEPLOY を使用してステータスをポーリングしてください
• 別のデプロイが進行中にデプロイを開始すると、新しいデプロイがキューに追加される場合があります

3. デプロイステータスの確認

使用する状況: ユーザーがデプロイの進行状況または結果を確認したい場合

ツールの順序:

1. RENDER_RETRIEVE_DEPLOY - デプロイの詳細とステータスを取得します [必須]

主なパラメーター:

• serviceId: サービス ID（必須）
• deployId: デプロイ ID（必須）
• 応答には status、createdAt、updatedAt、finishedAt、commit が含まれます

注意点:

• serviceId と deployId の両方が必須です
• デプロイステータスには、'created'、'build_in_progress'、'update_in_progress'、'live'、'deactivated'、'build_failed'、'update_failed'、'canceled' があります
• 'live' はデプロイの成功を示します
• 'build_failed' または 'update_failed' はデプロイエラーを示します
• レート制限を避けるため、適切な間隔（10～30 秒）でポーリングしてください

4. プロジェクトを管理する

使用する場面：Render のプロジェクトを一覧表示して整理したい場合

ツールの順序：

1. RENDER_LIST_PROJECTS - すべてのプロジェクトを一覧表示します［必須］

主なパラメーター：

• limit：ページごとの最大結果数（最大 100）
• cursor：前回のレスポンスから取得したページネーション用カーソル

注意点：

• プロジェクトは、関連するサービスをまとめます
• ページネーションにはカーソル方式を使用します
• プロジェクト ID は整理のために使用されます
• すべてのサービスがプロジェクトに割り当てられているとは限りません

一般的なパターン

ID の解決

サービス名 -> サービス ID：

1. Call RENDER_LIST_SERVICES with name=service_name
2. Find service by name in results
3. Extract id (format: 'srv-xxxxxxxxxxxx')

デプロイの検索：

1. Store deployId from RENDER_TRIGGER_DEPLOY response
2. Call RENDER_RETRIEVE_DEPLOY with serviceId and deployId
3. Check status for completion

デプロイと監視のパターン

1. RENDER_LIST_SERVICES -> find service by name -> get serviceId
2. RENDER_TRIGGER_DEPLOY with serviceId -> get deployId
3. Loop: RENDER_RETRIEVE_DEPLOY with serviceId + deployId
4. Check status: 'live' = success, 'build_failed'/'update_failed' = error
5. Continue polling until terminal state reached

ページネーション

• 次のページには、レスポンスの cursor を使用します
• cursor が存在しなくなるか、結果が空になるまで続けます
• LIST_SERVICES と LIST_PROJECTS は、どちらもカーソル方式のページネーションを使用します
• ページネーションの回数を減らすには、limit を最大値（100）に設定します

既知の注意点

サービス ID：

• 常に「srv-」で始まります（例：「srv-abcd1234efgh」）
• デプロイ ID は「dep-」で始まります（例：「dep-d2mqkf9r0fns73bham1g」）
• LIST_SERVICES を使って、サービス名を必ず ID に解決してください

サービスの種類：

• 絞り込みには正確な列挙値を使用する必要があります
• 使用可能な種類：web_service、static_site、private_service、background_worker、cron_job
• サービスの種類によって、デプロイの動作は異なります

デプロイの動作：

• デプロイは非同期です。必ず完了するまでポーリングしてください
• キャッシュをクリアするデプロイは時間がかかりますが、古いキャッシュの問題を解決できます
• デプロイに失敗しても自動的にはロールバックされず、以前のバージョンが稼働し続けます
• デプロイのトリガーが同時に実行されると、キューに追加される場合があります

レート制限：

• Render API にはレート制限があります
• 頻繁なポーリングを避け、10～30 秒間隔で実行してください
• 一括操作にはスロットリングを適用してください

レスポンスの解析：

• レスポンスデータは data キーの下にネストされている場合があります
• タイムスタンプは ISO 8601 形式です
• オプションフィールドに対するフォールバックを用意し、堅牢に解析してください

クイックリファレンス

タスク	ツールスラッグ	主なパラメーター
サービスの一覧表示	RENDER_LIST_SERVICES	name, type, limit, cursor
デプロイのトリガー	RENDER_TRIGGER_DEPLOY	serviceId, clearCache
デプロイ状況の取得	RENDER_RETRIEVE_DEPLOY	serviceId, deployId
プロジェクトの一覧表示	RENDER_LIST_PROJECTS	limit, cursor

---

Powered by Composio