render-networking

Render のプライベートネットワーキング

Render のプライベートネットワークを使用すると、サービスはトラフィックをパブリックインターネットに公開せずに相互に通信できます。ユーザーが内部接続、スケールしたインスタンス間のサービスディスカバリー、または Blueprints とダッシュボードでの正しい URL／ポートの動作を必要とする場合に、このスキルを使用してください。

このスキルを使用する場面

• Render 上のサービス間トラフィックの設計またはデバッグ
• ダッシュボードの内部ホスト名、内部 URL、または Connect > Internal に関する質問
• 複数のインスタンスにまたがるサービスディスカバリー（カスタムロードバランシング、メッシュ形式のセットアップ）
• ポート制限、予約済みポート、または複数ポートの Web サービス（パブリックとプライベート）
• Free プランの Web サービスと、プライベートトラフィックを送信／受信できるサービス
• 環境の分離（Pro ワークスペース以上）またはプライベートなエグレス／イングレス構成向けの AWS PrivateLink

プライベート接続を設計、設定、またはトラブルシューティングする前に、references/private-networking.md を読んでください。アーキテクチャの例と Blueprint のパターンについては、references/communication-patterns.md を参照してください。

プライベート接続の基本事項

• サービスタイプやトラフィックの方向が明確でない場合は、アドレスを提案する前に、どのサービスが接続を開始し、どのサービスが受信するのかを確認してください。
• プライベートネットワークのピアは同じワークスペースとリージョンに属している必要があります。ダッシュボードの Connect > Internal で、接続先のアドレスを確認してください。
• http://[internal-hostname]:[port]/path のように、クライアントが URL を想定している場合は完全な URL を構成してください。ホスト名だけではプロトコルが指定されません。
• Web サービスとプライベートサービスはプライベートトラフィックを受信できます。バックグラウンドワーカー、Cron ジョブ、ワークフローの実行は、プライベート接続を送信できますが、内部ホスト名を持たず、受信もできません。
• ゲートウェイパターンでは、パブリック Web サービスがプライベートネットワーク経由でプライベートサービスを呼び出します。プライベートサービスにパブリックエンドポイントは必要ありません。

サービスディスカバリー

通常のサービス間トラフィックには、サービスの通常の内部ホスト名を使用してください。カスタムロードバランシングやインスタンスごとのメトリクスなどのために、アプリケーションで稼働中のすべてのインスタンスが必要な場合は、慣例として [internal-hostname]-discovery となるサービスのディスカバリーホスト名を使用してください。このホスト名は、稼働中のすべてのインスタンスの IP アドレスに解決されます。各 Web サービスまたはプライベートサービスには、独自のディスカバリーホスト名が RENDER_DISCOVERY_SERVICE に設定されます。解決された IP アドレスはデプロイのたびに変わる可能性があるため、保存しないでください。

一般的なパターン

概要を示します。詳しい図と Blueprint の注記は references/communication-patterns.md にあります。

1. Web ゲートウェイ＋プライベートバックエンド — パブリック Web Service が HTTP を終端し、内部呼び出しではプライベートホスト名とポートを使用して、Private Service または内部 URL に接続します。
2. ワーカーからデータベースへ — 内部ホスト名を持たないバックグラウンドワーカーが、Postgres または Key Value の内部 URLに送信接続します。
3. マイクロサービス — Private Service（および対象となる Web Service）は、プライベートネットワーク上の内部ホスト名:ポートを使って相互に呼び出します。

参考資料

ドキュメント	用途
references/private-networking.md	現在のプライベートネットワーク機能、アドレス指定、ディスカバリー、ポート、分離、トラブルシューティング
references/communication-patterns.md	ゲートウェイ、ワーカー→DB、メッシュ、URL の構成、Blueprint の fromService パターン

関連スキル

• render-web-services — パブリック Web サービス、PORT、HTTP の動作
• render-private-services — Private Service 固有のセットアップとスケーリング
• render-blueprints — render.yaml、fromService、複数サービスの接続

現在のドキュメントの取得

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

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

複数の参照資料が必要な場合は、それぞれにこの手順を適用し、確認できたドキュメントと、取得できなかったドキュメントを区別してください。