> ## Documentation Index
> Fetch the complete documentation index at: https://docs.shanone.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Render

> クラウドインフラの管理 — サービス、デプロイ、データベース、環境、ワークフロー

# Render

ShanoneのRender連携は、[Render](https://render.com)のクラウドプラットフォームのほぼ全体をカバーする171個のツールをエージェントに提供します。サービスとデプロイ、PostgresとKey Valueデータベース、環境変数/シークレット、カスタムドメインとルーティング、バックグラウンドジョブ、可観測性まで対応しています。

## はじめに

<Steps>
  <Step title="Render APIキーを作成する">
    [Renderダッシュボード](https://dashboard.render.com/account/api-keys)からキーを発行します。
  </Step>

  <Step title="Shanoneにキーを追加する">
    Shanoneダッシュボードの**連携**でRenderを選択し、キー(`rnd_...`)を貼り付けます。
  </Step>

  <Step title="リクエストを再実行する">
    保存が完了すると、`render_*`ツールに対する`shanone_execute_tool`呼び出しが成功するようになります。
  </Step>
</Steps>

## 利用可能なツール

ShanoneはRender向けに**171個のツール**を、以下のカテゴリに整理して提供しています。

<AccordionGroup>
  <Accordion title="サービス & デプロイ">
    `render_list_services`, `render_get_service`, `render_create_service`, `render_update_service`, `render_delete_service`, `render_restart_service`, `render_suspend_service`, `render_resume_service`, `render_scale_service`, `render_list_service_instances`, `render_list_deploys`, `render_get_deploy`, `render_trigger_deploy`, `render_cancel_deploy`, `render_rollback_service`, `render_list_service_events`, `render_update_autoscaling`, `render_delete_autoscaling`
  </Accordion>

  <Accordion title="データベース: Postgres & Key Value">
    `render_list_postgres`, `render_get_postgres`, `render_create_postgres`, `render_update_postgres`, `render_delete_postgres`, `render_restart_postgres`, `render_suspend_postgres`, `render_resume_postgres`, `render_get_postgres_connection_info`, `render_list_postgres_credentials`, `render_create_postgres_credential`, `render_delete_postgres_credential`, `render_list_postgres_exports`, `render_create_postgres_export`, `render_get_postgres_recovery_status`, `render_trigger_postgres_recovery`, `render_failover_postgres`, `render_get_postgres_processes`, `render_get_postgres_table_sizes`, `render_get_postgres_table_scans`, `render_get_postgres_top_queries`, `render_list_key_value`, `render_get_key_value`, `render_create_key_value`, `render_update_key_value`, `render_delete_key_value`, `render_get_key_value_connection_info`, `render_suspend_key_value`, `render_resume_key_value`
  </Accordion>

  <Accordion title="環境 & シークレット">
    `render_list_env_vars`, `render_get_env_var`, `render_set_env_var`, `render_replace_env_vars`, `render_delete_env_var`, `render_list_secret_files`, `render_get_secret_file`, `render_set_secret_file`, `render_delete_secret_file`, `render_list_env_groups`, `render_get_env_group`, `render_create_env_group`, `render_update_env_group`, `render_delete_env_group`, `render_get_env_group_var`, `render_set_env_group_var`, `render_delete_env_group_var`, `render_get_env_group_secret_file`, `render_set_env_group_secret_file`, `render_delete_env_group_secret_file`, `render_link_service_to_env_group`, `render_unlink_service_from_env_group`
  </Accordion>

  <Accordion title="ディスク、ジョブ & タスク実行">
    `render_list_disks`, `render_get_disk`, `render_add_disk`, `render_update_disk`, `render_delete_disk`, `render_list_disk_snapshots`, `render_restore_disk_snapshot`, `render_list_jobs`, `render_get_job`, `render_create_job`, `render_cancel_job`, `render_list_tasks`, `render_get_task`, `render_list_task_runs`, `render_run_task`, `render_get_task_run`, `render_cancel_task_run`
  </Accordion>

  <Accordion title="ドメイン、ルート & ネットワーキング">
    `render_list_custom_domains`, `render_get_custom_domain`, `render_add_custom_domain`, `render_delete_custom_domain`, `render_verify_custom_domain`, `render_list_routes`, `render_add_route`, `render_replace_routes`, `render_update_route_priority`, `render_delete_route`, `render_list_headers`, `render_add_header`, `render_replace_headers`, `render_delete_header`, `render_list_dedicated_ips`, `render_get_dedicated_ip`, `render_create_dedicated_ip_set`, `render_update_dedicated_ip_set`, `render_delete_dedicated_ip_set`
  </Accordion>

  <Accordion title="プロジェクト、環境 & Blueprint">
    `render_list_projects`, `render_get_project`, `render_create_project`, `render_update_project`, `render_delete_project`, `render_list_environments`, `render_get_environment`, `render_create_environment`, `render_update_environment`, `render_delete_environment`, `render_add_environment_resources`, `render_remove_environment_resources`, `render_list_blueprints`, `render_get_blueprint`, `render_validate_blueprint`, `render_update_blueprint`, `render_disconnect_blueprint`, `render_list_blueprint_syncs`
  </Accordion>

  <Accordion title="Webhook & 通知">
    `render_list_webhooks`, `render_get_webhook`, `render_create_webhook`, `render_update_webhook`, `render_delete_webhook`, `render_list_webhook_events`, `render_list_notification_overrides`, `render_get_service_notification_override`, `render_update_service_notification_override`, `render_get_owner_notification_settings`, `render_update_owner_notification_settings`
  </Accordion>

  <Accordion title="可観測性">
    `render_get_cpu_metrics`, `render_get_memory_metrics`, `render_get_http_requests_metrics`, `render_get_http_latency_metrics`, `render_get_bandwidth_metrics`, `render_get_instance_count_metrics`, `render_get_disk_usage_metrics`, `render_get_active_connections_metrics`, `render_list_logs`, `render_get_log_filter_values`, `render_list_organization_audit_logs`, `render_list_workspace_audit_logs`, `render_list_maintenance_runs`, `render_get_maintenance_run`, `render_trigger_maintenance_run`
  </Accordion>

  <Accordion title="ワークフロー、Owner & レジストリ">
    `render_trigger_cron_job_run`, `render_cancel_cron_job_run`, `render_list_workflows`, `render_get_workflow`, `render_create_workflow`, `render_update_workflow`, `render_delete_workflow`, `render_list_workflow_versions`, `render_get_workflow_version`, `render_deploy_workflow_version`, `render_list_owners`, `render_get_owner`, `render_list_workspace_members`, `render_update_member_role`, `render_remove_member`, `render_list_registry_credentials`, `render_get_registry_credential`, `render_create_registry_credential`, `render_update_registry_credential`, `render_delete_registry_credential`, `render_get_authenticated_user`, `render_get_event`
  </Accordion>
</AccordionGroup>

## よくあるユースケース

<CardGroup cols={2}>
  <Card title="デプロイの自動化" icon="rocket">
    コード変更後にデプロイを開始し、失敗した場合は自動的にロールバックする
  </Card>

  <Card title="データベースの保守" icon="database">
    Postgresのテーブルサイズと上位クエリを確認し、移行前にエクスポートを実行する
  </Card>

  <Card title="インシデント対応" icon="alert-triangle">
    不調なサービスのCPU/メモリメトリクスと最近のログを取得する
  </Card>

  <Card title="シークレットのローテーション" icon="key">
    環境グループの変数を更新し、依存する全サービスに再リンクする
  </Card>
</CardGroup>

## トラブルシューティング

<AccordionGroup>
  <Accordion title="render_trigger_deployは成功するがサービスが更新されない">
    `render_get_deploy`や`render_list_service_events`でデプロイが実際に完了したか確認してください——トリガー呼び出し自体が成功しても、ビルドステップで失敗することがあります。
  </Accordion>

  <Accordion title="render_create_postgres_exportやrender_trigger_postgres_recoveryがタイムアウトする">
    大きなデータベースはエクスポートやリカバリに長い時間がかかることがあります。同期的なレスポンスを期待するのではなく、`render_get_postgres_recovery_status`をポーリングしてください。
  </Accordion>

  <Accordion title="環境変数の変更が反映されないように見える">
    ほとんどの環境変数やシークレットファイルの変更は、実行中のインスタンスに反映させるために新しいデプロイが必要です。`render_set_env_var`や`render_set_secret_file`を呼んだ後に`render_trigger_deploy`でデプロイを実行してください。
  </Accordion>

  <Accordion title="render_add_custom_domainを実行してもドメインが未検証のままになる">
    DNSの伝播には時間がかかります。必要なCNAME/Aレコードが設定されていることを確認した上で、DNSの伝播を待ってから再度`render_verify_custom_domain`を呼び出してください。
  </Accordion>
</AccordionGroup>