コンテンツにスキップ

カスタム Pod を作成する

カスタム Pod は組織固有の環境です — 自分たちのリポジトリ、言語ツールチェーン、 データベースクライアント、ツールを含み、メンバーは他の Pod と同様に起動できます。 カスタム Pod は組織内でのみ利用可能で、特定のグループに限定することもできます。

作成方法は 2 通りあります。ほとんどのチームはオプション A から始めます。独自の ソフトウェアイメージを組み込む必要がある場合はオプション B を使用してください。

Info

カスタム Pod は、コントロールセンター → Pods において組織の管理者/オーナーが 作成・管理します。メンバーは、管理者が有効にした Pod のみ表示されます。

オプション A — SkyDeck ベースから始める（イメージのビルド不要）

標準のコーディング Pod を自分たちのリポジトリに向けるだけでよい場合に最適です。

  1. コントロールセンター → Pods に移動し、新しい Pod をクリックします。
  2. SkyDeck のベースイメージを選択します — たとえば Claude Code コーディングベース （Ubuntu + gh + Claude Code + tailscale + 動作するターミナル）。
  3. 以下の項目を入力します：
  4. 名前と任意の説明/アイコン。
  5. エージェント — プリインストールするエージェント: Claude Code、OpenClaw、 Hermes、JupyterLab、または独自のものを使用する場合は なし。（マネージド エージェントには少額の時間単位の追加料金がかかります — Pod に表示される価格には それが含まれています。）
  6. リポジトリ （任意） — 初回起動時に /workspace（永続ボリューム）にクローンする git URL。
  7. 起動コマンド （任意） — Pod 起動時に実行するコマンド（例：依存関係のインストール）。
  8. 公開ポート （任意） — Pod が実行する Web サービス用のポート。ワークスペースの ブラウザペインはここに記載されたポートにのみアクセスできます。
  9. サイズ — vCPU / メモリのティア。
  10. デフォルトペイン — ターミナルまたはブラウザで開く。
  11. 保存をクリックします。Pod が組織用に作成され、有効な状態で起動します。

オプション B — 独自のイメージを使用する（上級者向け）

特定のランタイムバージョン、システムパッケージ、プリインストール済みツール、 キャッシュデータなど、環境にソフトウェアを組み込む必要がある場合に最適です。

  1. SkyDeck ベースの上にイメージをビルドして、Pod が動作するターミナルと AI エージェントを継承するようにします。Dockerfile に以下を記述します：
FROM <skydeck-coding-base-image>     # ask your SkyDeck contact for the reference
# add your repos, language toolchains, DB clients, project tools…
RUN apt-get update && apt-get install -y --no-install-recommends <your-packages>

!!! warning

ベースのシェルと `tmux` を保持してください（SkyDeck ベースから `FROM` でビルドすると
   それらが継承され、動作するターミナルが得られます）。言語ランタイム、データベース
   クライアント、ツールはイメージに含めてください。**シークレットは含めない**でください
   — シークレットはビルド時ではなく、起動時に注入されます。

  1. Docker でローカルテストを行い、その後 SkyDeck がプルするコンテナレジストリに プッシュします（レジストリと認証情報については SkyDeck の担当者に確認してください。 プライベートレジストリの場合は pull シークレットを追加してください）。明示的な バージョンまたはダイジェストでタグ付けしてください — :latest は受け付けられません。 タグまたは @sha256:… ダイジェストが必須です。

  2. コントロールセンター → Pods → 新しい Pod で詳細：カスタムイメージを選択し、 完全なイメージ参照（レジストリ/リポジトリ:タグ または レジストリ/リポジトリ@sha256:…）を貼り付けます。オプション A と同様にエージェント、 公開ポート、サイズ、デフォルトペインを設定し、保存をクリックします。

メンバーが利用できるようにする

新しいカスタム Pod は有効な状態で作成されますが、起動できるユーザーを設定するまで 誰にも表示されません。コントロールセンター → Pods の Pod の行で：

  • 全員に公開 — 組織のすべてのメンバーが起動できます。
  • グループ別 — 1 つ以上のグループ / タグを割り当てて、 そのグループのメンバーのみが Pod を表示できるようにします（ツールのキュレーションと同じモデルです）。メンバーは、割り当てられたいずれかのグループに属していれば Pod を表示できます。

メンバーは次回 Pod カタログを開いたときに、GenStudio ワークスペースから Pod を起動します。

Info

コスト管理。 Pods は実行中にコンピューティングコストが発生します。Pod の支出設定で 組織の予算とユーザーまたはグループごとの支出上限を設定し、放置された Pod が課金され 続けないようにアイドル自動スリープを設定してください。

ヒント

  • ベースバージョンを固定してください。イメージが拡張するベースを固定することで、 ベースの更新によって Pod が意図せず変更されることを防げます。意図的にバージョンを 上げるようにしてください。
  • 永続的なワークスペース — /workspace のみ。 Pod の /workspace は永続ボリューム であり、スリープ/再開や再接続後も保持される唯一のストレージです。設定したリポジトリ はそこにクローンされます。Pod 内のそれ以外のすべて（ホームディレクトリ、ファイルシステム の残りの部分）は、再開時にイメージからリセットされます — 残しておきたいものはすべて /workspace の下に保存するようメンバーに伝えてください。
  • カスタム Pod の更新。 新しいイメージタグをプッシュして Pod のイメージ参照を編集 してください。メンバーは次回起動時に新しいイメージを使用します。