Skip to main content

​
Render

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

​
はじめに

1

Render APIキーを作成する

Renderダッシュボードからキーを発行します。
2

Shanoneにキーを追加する

Shanoneダッシュボードの連携でRenderを選択し、キー(rnd_...)を貼り付けます。
3

リクエストを再実行する

保存が完了すると、render_*ツールに対するshanone_execute_tool呼び出しが成功するようになります。

​
利用可能なツール

ShanoneはRender向けに171個のツールを、以下のカテゴリに整理して提供しています。
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
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
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
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
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
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
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
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
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

​
よくあるユースケース

デプロイの自動化

コード変更後にデプロイを開始し、失敗した場合は自動的にロールバックする

データベースの保守

Postgresのテーブルサイズと上位クエリを確認し、移行前にエクスポートを実行する

インシデント対応

不調なサービスのCPU/メモリメトリクスと最近のログを取得する

シークレットのローテーション

環境グループの変数を更新し、依存する全サービスに再リンクする

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

render_get_deployやrender_list_service_eventsでデプロイが実際に完了したか確認してください——トリガー呼び出し自体が成功しても、ビルドステップで失敗することがあります。
大きなデータベースはエクスポートやリカバリに長い時間がかかることがあります。同期的なレスポンスを期待するのではなく、render_get_postgres_recovery_statusをポーリングしてください。
ほとんどの環境変数やシークレットファイルの変更は、実行中のインスタンスに反映させるために新しいデプロイが必要です。render_set_env_varやrender_set_secret_fileを呼んだ後にrender_trigger_deployでデプロイを実行してください。
DNSの伝播には時間がかかります。必要なCNAME/Aレコードが設定されていることを確認した上で、DNSの伝播を待ってから再度render_verify_custom_domainを呼び出してください。