render-scaling

Render のスケーリング

このスキルでは、Render 上のWeb サービス、プライベートサービス、バックグラウンドワーカーのスケーリング方法について、手動でのインスタンス数の設定、Pro ワークスペース以上で利用できるオートスケーリング、コンピュートプランの選択、プラットフォームの制限を説明します。詳しいガイダンスは references/ にあります。

サービスにディスクがアタッチされている場合、またはアタッチする可能性がある場合は、スケーリング構成を選択する前に references/persistent-disks.md をお読みください。

使用する場面

• インスタンス数の設定または変更（ダッシュボード、CLI、API、Blueprint）
• オートスケーリングの設定（最小／最大、CPU とメモリの目標値）
• 垂直スケーリング（プランの変更）と水平スケーリング（インスタンスの追加）の選択
• 制約（ディスク、静的サイト、cron／ワークフロー、最大 100 インスタンス）の把握
• インスタンス数やサイズを増やして実行する場合のコストへの影響
• Blueprint のフィールド：numInstances、scaling、plan

手動スケーリング

• ダッシュボード、CLI、またはAPIから、1～100の範囲でインスタンス数を設定します。
• すべてのインスタンスで同じコンピュートプランが適用されます。1 つのサービス内で異なるプランを混在させることはできません。
• 変更はすぐに適用されます。必要に応じて Render がインスタンスをプロビジョニングし、余分なキャパシティを削除します。

オートスケーリング

オートスケーリングのポリシーを推奨する前に、サービスの種類、ワークスペースのプラン、サービスがステートレスかディスクを使用しているか、希望するインスタンス数の最小値と最大値、CPU とメモリのどちらが制約リソースかを確認してください。

• Pro ワークスペース以上でのみ利用できます。
• 最小インスタンス数と最大インスタンス数、および CPU と／またはメモリの使用率目標値（それぞれ 1～90%）を設定します。
• 少なくとも 1 つのメトリクスを有効にする必要があります（CPU またはメモリ）。CPU とメモリのオートスケーリング切り替えが両方ともオフの場合、オートスケーリングは無効になります。
• 手動のインスタンス設定とオートスケーリングの両方を設定した場合、オートスケーリングが優先されます。手動のインスタンス数は、有効なスケーリングポリシーを上書きしません。

オートスケーリングの計算式

Render は、使用率と目標値に基づいて、候補となるインスタンス数を計算します。

new_instances = ceil(current_instances * (current_utilization / target_utilization))

• CPU とメモリの目標値を両方設定した場合、プラットフォームは 2 つの new_instances のうち大きい方を使用します（より保守的なスケールアウトになります）。

スケーリングの制約

制約	動作
サービスごと	インスタンス数の上限は 100
永続ディスク	複数のインスタンスにはスケーリングできません。ディスクをアタッチしたサービスは単一インスタンスのままです
静的サイト	スケーリングできません（CDN によって配信されます）
cron ジョブとワークフロー	スケーリングモデルは適用されません（実行モデルが異なります）

スケールダウンの動作

• 使用率の状況がスケールアップを支持する場合、スケールアップはすぐに行われます。
• 条件が縮小を許可してから数分間待って、スケールダウンが行われます（スパイク保護）。これにより、短時間の負荷急増によるフラッピングを抑えます。

コンピュートプラン

• Blueprint では、plan フィールドでコンピュートプランを設定します。
• 現在の用語、正式なプランの確認方法、スケールアップとスケールアウトの使い分けについては references/compute-plans.md を参照してください。

コストの傾向

• スケーリングによって、実行中のインスタンス数やサイズが変わり、課金対象のコンピュート量も変化します。
• 現在のコンピュート料金はRender の料金で確認してください。
• CPU とメモリの使用率を監視して、適正なサイズに調整してください（render-monitorを参照）。

すべてのインスタンスで CPU とメモリの使用率が継続的に低い場合は、過剰にプロビジョニングされている可能性があります。references/compute-plans.md を参照してから、現在より小さいコンピュートプラン、手動でスケーリングしたインスタンス数の削減、または適切な使用率目標に向けてスケールダウンできるオートスケーリングを試してください（CPU バウンドのサービスでは、CPU 使用率約 70% が一般的な開始点です）。可能な場合は一度に 1 つの要素だけを変更し、本番環境を代表するトラフィックのもとで CPU、メモリ、レイテンシ、エラーを確認してから、その変更を維持してください。

Blueprint の設定

インスタンス数の手動設定：

numInstances: 3

オートスケーリング：

scaling:
  minInstances: 1
  maxInstances: 10
  targetCPUPercent: 70
  targetMemoryPercent: 80

コンピュートプラン：

plan: 1c-2g

scaling ブロックがある場合、オートスケーリングの上限として numInstances に依存しないでください。オートスケーリングが優先されます。スケーリングのプレビュー動作については、references/autoscaling-guide.md で詳しく説明しています。

参考資料

トピック	ファイル
コンピュートプランと垂直スケーリング／水平スケーリング	references/compute-plans.md
永続ディスクの制約とストレージの代替手段	references/persistent-disks.md
オートスケーリングの有効化、目標、最小値／最大値、よくある間違い、プレビュー	references/autoscaling-guide.md

関連スキル

• render-web-services — Web Service の設定、ディスク、デプロイのライフサイクル
• render-background-workers — Worker 固有の設定とスケーリングに関する情報
• render-blueprints — Blueprint の完全なスキーマとフィールドのリファレンス
• render-monitor — 適切なサイズ設定に役立つメトリクス、ログ、使用率

最新ドキュメントの取得

このスキルで最新の Render ドキュメントを参照するよう指示された場合は、常に次の手順に従ってください。

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

複数の参照資料が必要なタスクでは、各資料にこの手順を適用し、確認できたドキュメントと利用できなかったドキュメントを区別してください。