refactor(devcontainer): Dockerfile-only + gitignored devcontainer.json for devpod compatibility

[takaokouji]

Summary

devpod で devpod up . を実行したとき以下のエラーで失敗する問題の修正:

target app: failed to solve: failed to compute cache key:
failed to calculate checksum of ref ... : "/entrypoint.sh": not found

Root cause

devpod は docker-compose ベースの devcontainer をビルドするとき、基底の docker-compose.yml の build: . 形式の context を正しく継承できず、.devcontainer/ 配下を build context と誤認する。結果として Dockerfile の COPY entrypoint.sh /app/entrypoint.sh が repo root の entrypoint.sh を見つけられず失敗する。

VS Code Dev Containers では同じ設定で問題なく動作するが、devpod は明示的に context を指定する必要があった。

Fix

.devcontainer/docker-compose.devcontainer.yml の app サービスに build セクションを明示的に追加:

services:
  app:
    build:
      context: .
      dockerfile: Dockerfile

docker compose の relative path 解決ルールでは、-f で指定された 最初 の compose ファイルの場所からの相対パスとして解釈される。基底 (docker-compose.yml) は repo root にあるため、context: . は repo root に解決される。これにより devpod / VS Code 両方で entrypoint.sh が正しく COPY される。

Test plan

• ローカルで docker compose -f docker-compose.yml -f .devcontainer/docker-compose.devcontainer.yml config app を実行し、build.context が <repo root> に解決されることを確認
• ローカルで docker compose ... build app を実行し、entrypoint.sh が正しく COPY されてビルドが成功することを確認
• devpod で devpod up . が成功することを確認 (PR 提出者にて実施)
• VS Code Reopen in Container が引き続き動作することを確認 (リグレッションなしの確認)

[github-actions]

🚀 Preview deployed: https://smalruby.jp/smalruby3-editor/fix/devcontainer-devpod-build-context/

[takaokouji]

追加修正: features を使わず post-create.sh でツール install

build context の明示 (commit 8524937) だけでは devpod の features 経由のラッパービルド で同じエラーが続いていた。devpod は dockerComposeFile + features の組み合わせで Dockerfile-with-features を生成するとき、build context を破壊する挙動がある (VS Code Dev Containers では起きない、devpod 固有のバグ)。

修正内容 (commit f167e2b)

• devcontainer.json から features セクションを削除
• post-create.sh で gh (apt経由) と claude-code (npm経由) をインストール
• 不要になった devcontainer-lock.json を削除
• README に経緯を追記

検証 (main checkout で確認)

$ docker compose ... up -d app
$ docker compose exec app .devcontainer/post-create.sh
post-create: gh CLI installed: gh version 2.92.0
post-create: Claude Code installed: 2.1.138 (Claude Code)
post-create: main checkout detected, no worktree setup needed

VS Code Reopen in Container / devpod 両方で動作するはずですが、devpod 側の検証はこの修正適用後に試してください。

[takaokouji]

追加修正: host port bind 衝突対応 (devpod 失敗の真因)

devpod での実機検証で「Could not resolve host: cli.github.com」エラーが出る原因が判明。

原因

通常 compose の smalruby3-editor-app-1 と devpod 用 compose の default-sm-24f22-app-1 が 同時に host port 8601 を bind しようとして衝突。後発の devpod 側がポート bind に失敗するが container 自体は起動 → network attach に失敗 → .NetworkSettings.Networks が空、/etc/resolv.conf も Docker 内部 DNS (127.0.0.11) ではなく外部 forwarder (192.168.65.7) のみを参照 → DNS が一切引けない。

```

通常 compose container の resolv.conf

nameserver 127.0.0.11 # ← 内部 DNS あり、解決成功

devpod container の resolv.conf

nameserver 192.168.65.7 # ← 外部のみ、解決失敗
```

修正内容 (commit 6977819)

`.devcontainer/docker-compose.devcontainer.yml` で host port bind を無効化:

```yaml
services:
app:
ports: !reset []
```

devcontainer 起動時は host にポートを公開しない。IDE 側 (VS Code / devpod) が `devcontainer.json` の `forwardPorts: [8601]` を読んで自分でポート転送するため問題なし。通常 `docker compose up app` には影響なし。

実機検証

修正後、devpod container 内で:

• `getent hosts cli.github.com` → IP が返る ✅
• `.devcontainer/post-create.sh` 完走 (gh 2.92.0 + Claude Code 2.1.138 install) ✅

次の検証

devpod 環境で再度試してください。既存の壊れた devpod workspace が残っている場合は一度 `devpod delete smalruby3-editor` してから `devpod up .`。

[takaokouji]

追加修正: Claude Code install を non-fatal に

発生した現象

devpod でビルド成功 → post-create.sh の gh install は成功 → npm install -g @anthropic-ai/claude-code のフェーズで以下のエラーで exit 1:

```
node: bad option: --max-old-space-size
node: bad option: --harmony-import-attributes
node: bad option: --js-source-phase-imports
```

切り分け結果

• 同じコンテナ (`default-sm-1aa5d-app-1`) に `docker exec` で入って手動 `npm install -g @anthropic-ai/claude-code` を実行 → 成功 (added 2 packages in 3s)
• container 内 node は v24.15.0、3 つの V8 options はいずれも有効
• 環境変数 `NODE_OPTIONS=--max-old-space-size=4000` は Dockerfile で設定済み (これ単体では問題なし)
• claude-code は native ELF binary に Node を組み込んだ形式 (SEA / single-executable application)
• devpod agent (`/usr/local/bin/devpod` 80MB Go binary) が install 時の subprocess 起動に何らかの影響を与えていると推測

修正 (commit 8d3a206)

claude install を非致命に変更。失敗時は warning を出して post-create.sh は exit 0 で抜ける。container 内で手動で `npm install -g @anthropic-ai/claude-code` を実行すれば成功することを確認済み (manual run path で 1 度成功している)。

gh CLI の install は引き続き fatal (成功率高く、ほぼ確実に必要なため)。

検証していただきたいこと

1. `devpod delete smalruby3-editor` で壊れた workspace を削除
2. `devpod up .` を再実行
3. 完走後、container に入って `claude --version` を確認
4. 入っていなかった場合は手動で `npm install -g @anthropic-ai/claude-code`

[takaokouji]

大幅リファクタ: docker-compose 撤廃、Dockerfile-only に移行

devpod での compose ベース利用が安定しないため、根本方針を変更しました。

変更概要

Before	After
dockerComposeFile で既存 compose の app サービスを共有	Dockerfile-only で既存 Dockerfile を直接ビルド
docker-compose.devcontainer.yml / docker-compose.local.yml で個人マウント	.devcontainer/devcontainer.json を .gitignore 対象にして各自編集
post-create.sh で gh / claude を毎回 install	devcontainer features で build 時に install (devpod でも動く)
compose との volume 共有なし	named volume (smalruby3-editor_smalruby3-editor_node_modules 等) を直接 mount して共有

利用者への影響

• docker compose run --rm app ... を使い続ける人: 影響なし。docker-compose.yml は無変更。
• devpod / VS Code Dev Containers を使いたい人: .devcontainer/devcontainer.json.example から自分用にコピーして mounts を編集 (cp .example .json)。

追加: 対話的セットアップスキル

.claude/skills/devcontainer-setup/SKILL.md を追加しました。Claude Code から /devcontainer-setup で呼ぶと、AskUserQuestion で mounts の ON/OFF を選んで devcontainer.json を生成します。

動作確認

• devpod で devpod delete smalruby3-editor → devpod up . --ide none が完走する
• VS Code Reopen in Container で起動できる
• container 内で which gh claude が両方 path を返す (features 経由)
• gh auth status が GH_TOKEN 経由で成功
• claude が起動し、認証・skills・memory が引き継がれる (個人 mounts 有効化時)