mcpField
R
render-env-vars

render-env-vars

github.com/render-ossクラウド・DevOps90478 回インストール今日更新
リポジトリ

render-env-vars について

Render の環境変数、シークレット、環境グループを扱う開発者向けのスキルです。Blueprint の設定参照、安全な変更手順、設定やポートのトラブルシューティングを扱います。

主な機能

  1. 01変数とシークレットの設定
  2. 02共有環境グループの管理
  3. 03Blueprint の変数参照
  4. 04変数とポートの問題調査

活用シーン

  1. 01サービスのシークレット追加・更新
  2. 02Blueprint でのデータベース変数の接続
  3. 03変数不足やポートバインド失敗の調査

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/render-oss/skills --skill render-env-vars

インストール後、Claude Code で/render-env-varsを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

references/
environment-variables.md
platform-variables.md
wiring-reference.md

詳細

Render の環境変数

環境変数、シークレット、シークレットファイル、環境グループを確認または変更する前に、最新のドキュメント、信頼できる情報源、安全性、変更手順について references/environment-variables.md をお読みください。

Blueprint の配線例や言語固有のアプリケーションに関する注意事項は、references/ にあります。

このスキルを使う場面

次のようなことをしたい場合は、このスキルを使います。

  • 環境変数やシークレットを追加、変更、削除する
  • Dashboard、Blueprint、API/MCP の各フローについて理解する
  • 共有設定に環境グループを使う
  • Blueprint で fromDatabase、fromService、fromGroup、sync: false、generateValue を設定する
  • 変数の欠落、シークレットファイル、優先順位、プラットフォームから注入される名前についてデバッグする

Blueprint の作成全般については、render-blueprints と併用してください。初回デプロイについては render-deploy を、Web サービスの動作やポートについては render-web-services を参照してください。

Blueprint の配線(概要)

references/environment-variables.md を読んだ後、タスクに応じた fromDatabase、fromService、fromGroup の例については references/wiring-reference.md を参照してください。Blueprint のワークフロー全体については render-blueprints を参照してください。

プラットフォームから注入される変数

固定の一覧に頼らず、references/environment-variables.md から取得した最新のデフォルト変数のリファレンスを使用してください。言語固有のアプリケーションに関する注意事項は、引き続き references/platform-variables.md に記載されています。

ランタイム固有のデフォルト

静的サイトまたはカスタム Docker エントリーポイントを使う場合を除き、HTTP サーバーは常に 0.0.0.0 と PORT(またはスタックのドキュメントに記載されたポート環境変数)にバインドしてください。

  • ポートのバインドエラーを診断する際は、まずサービスがネイティブランタイムと Docker のどちらを使っているかを確認し、実際の起動コマンドを調べてください。適用されるデフォルトはそれぞれ異なります。
  • Web サービスの PORT のデフォルトは 10000 です。この数値をハードコードしたり、任意のハードコードされたポートに合わせるだけの目的で PORT を設定したりせず、起動コマンドで $PORT を読み取ることを推奨します。
  • ネイティブ Python サービスには現在、デフォルトで 0.0.0.0:10000 にバインドする GUNICORN_CMD_ARGS が設定されます。カスタムの Gunicorn 起動コマンドでは 0.0.0.0:$PORT にバインドし、プロセスと Render のヘルスチェックで同じポートが使われるようにしてください。

よくある問題

一部の古いサービスと新しいサービスでは、WEB_CONCURRENCY のデフォルトが異なります。ワーカー数をデバッグする際は、サービスの作成日と明示的な上書きを比較したうえで、references/environment-variables.md と references/platform-variables.md を使って現在の動作を確認してください。

リファレンス

  • references/environment-variables.md — 現在の設定ドキュメント、シークレットの取り扱い、グループ、プラットフォーム変数、変更時の安全性
  • references/wiring-reference.md — Blueprint でのリソース間の配線例とワークスペース固有の注意点
  • references/platform-variables.md — 並行処理数、ネイティブランタイムと Docker の動作の違い、アプリケーションでの解析に関する注意事項

関連スキル

  • render-blueprints — Blueprint の作成全般、検証、マルチサービス構成
  • render-deploy — 初回デプロイ、リポジトリ要件、MCP と YAML
  • render-web-services — 環境変数によって動作するサーバーに関するポート、ヘルスチェック、スケーリングの動作

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

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

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

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

コメント