Skip to content

docs: #463 の設計を確定仕様 vscode-server-volume.md にする #489

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
takemi-ohama merged 1 commit into from
Oct 14, 2026
Merged

docs: #463 の設計を確定仕様 vscode-server-volume.md にする #489

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
10 changes: 5 additions & 5 deletions docs/glossary.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -54,9 +54,9 @@ up の後に VS Code で dev コンテナを開く（docs/specifications/editor-
| --- | --- | --- | --- | --- | --- |
| 窓 | — | dev コンテナへ Dev Containers 拡張で接続した VS Code のウィンドウ | — | — | `docs/specifications/editor-open.md` |
| 動いているインスタンス | — | docker ps に現れ、Compose のプロジェクトのラベルが対象のプロジェクトで、サービスのラベルが <開発サービス名>-<1 以上の数字> のコンテナ | — | — | `docs/specifications/editor-open.md` |
| 共通の VS Code Server ボリューム | — | すべての dev コンテナが ~/.vscode-server/bin に付ける 1 本のボリューム devbase_vscode-server-bin。サーバーの本体の版（bin/<commit>）だけを持ち、拡張と data/ を持たない | — | — | — |
| コンテナごとの VS Code Server の状態 | — | ~/.vscode-server のうち bin/ 以外（extensions/・extensionsCache/・data/）。拡張・接続トークン・.devport・マシンの設定（window.title を含む）・ログ・User/ の状態を持つ。どのボリュームにも置かず、コンテナの書き込みレイヤーに残る。devbase up の作り直しで消え、docker restart では残る | — | — | — |
| 旧形式の VS Code Server ボリューム | — | #463 より前の devbase が dev コンテナ 1 つに 1 本付けていた devbase_vscode_<project>_<index>。~/.vscode-server を丸ごと持つ。#463 の後は付けず、devbase は消さない | — | — | — |
| 共通の VS Code Server ボリューム | — | すべての dev コンテナが ~/.vscode-server/bin に付ける 1 本のボリューム devbase_vscode-server-bin。サーバーの本体の版（bin/<commit>）だけを持ち、拡張と data/ を持たない | — | — | `docs/specifications/vscode-server-volume.md` |
| コンテナごとの VS Code Server の状態 | — | ~/.vscode-server のうち bin/ 以外（extensions/・extensionsCache/・data/）。拡張・接続トークン・.devport・マシンの設定（window.title を含む）・ログ・User/ の状態を持つ。どのボリュームにも置かず、コンテナの書き込みレイヤーに残る。devbase up の作り直しで消え、docker restart では残る | — | — | `docs/specifications/vscode-server-volume.md` |
| 旧形式の VS Code Server ボリューム | — | #463 より前の devbase が dev コンテナ 1 つに 1 本付けていた devbase_vscode_<project>_<index>。~/.vscode-server を丸ごと持つ。#463 の後は付けず、devbase は消さない | — | — | `docs/specifications/vscode-server-volume.md` |

## 機密の置き場（`secret`）

Expand Down Expand Up @@ -228,8 +228,8 @@ base イメージの entrypoint が起動のたびに行う用意（containers/b
| 排他の作成 | — | エントリを「無いときだけ作る」操作。同時に呼んでも作れるのは 1 つのプロセスだけで、作れたプロセスだけがそのエントリの中身を書く。退避とプレースホルダが使う | — | — | `docs/specifications/container-link-stage.md` |
| 置き換わった共有のリンク | — | 共有のリンクの位置にある、symlink ではない通常のファイル。コンテナの中のツールが一時ファイルの rename で settings.json へ書くと、共有のリンクがこれに置き換わる | — | — | `docs/specifications/container-link-stage.md` |
| 共有のリンクの控え | — | 置き換わった共有のリンクの中身が共通のボリュームの実体と違うとき、リンクの段が張り直す前にグループのボリュームの同じ .claude の下へ別の名前で残したファイル。自動では消さず、共通のボリュームへも取り込まない | — | — | `docs/specifications/container-link-stage.md` |
| 入れ子の本体 | — | VS Code Server の本体の同時の展開で、遅れた側の中身が bin/<commit>/vscode-server-linux-<arch>/ に入れ子で残ったもの。product.json を持ち、コンテナの起動の片付けが消す | — | — | — |
| 残す版の数 | — | コンテナの起動の片付けが共通の VS Code Server ボリュームの bin/ に残す本体の版の数。5。版は product.json の更新時刻の新しい順に数える | — | — | — |
| 入れ子の本体 | — | VS Code Server の本体の同時の展開で、遅れた側の中身が bin/<commit>/vscode-server-linux-<arch>/ に入れ子で残ったもの。product.json を持ち、コンテナの起動の片付けが消す | — | — | `docs/specifications/vscode-server-volume.md` |
| 残す版の数 | — | コンテナの起動の片付けが共通の VS Code Server ボリュームの bin/ に残す本体の版の数。5。版は product.json の更新時刻の新しい順に数える | — | — | `docs/specifications/vscode-server-volume.md` |

## 起動の後の処理（`post-start`）

Expand Down
15 changes: 5 additions & 10 deletions docs/glossary/glossary.json
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -1019,36 +1019,31 @@
"term": "共通の VS Code Server ボリューム",
"context": "editor",
"meaning": "すべての dev コンテナが ~/.vscode-server/bin に付ける 1 本のボリューム devbase_vscode-server-bin。サーバーの本体の版（bin/<commit>）だけを持ち、拡張と data/ を持たない",
"source": "",
"pending_source": "issues/issue-463-design.md"
"source": "docs/specifications/vscode-server-volume.md"
},
{
"term": "コンテナごとの VS Code Server の状態",
"context": "editor",
"meaning": "~/.vscode-server のうち bin/ 以外（extensions/・extensionsCache/・data/）。拡張・接続トークン・.devport・マシンの設定（window.title を含む）・ログ・User/ の状態を持つ。どのボリュームにも置かず、コンテナの書き込みレイヤーに残る。devbase up の作り直しで消え、docker restart では残る",
"source": "",
"pending_source": "issues/issue-463-design.md"
"source": "docs/specifications/vscode-server-volume.md"
},
{
"term": "旧形式の VS Code Server ボリューム",
"context": "editor",
"meaning": "#463 より前の devbase が dev コンテナ 1 つに 1 本付けていた devbase_vscode_<project>_<index>。~/.vscode-server を丸ごと持つ。#463 の後は付けず、devbase は消さない",
"source": "",
"pending_source": "issues/issue-463-requirements.md"
"source": "docs/specifications/vscode-server-volume.md"
},
{
"term": "入れ子の本体",
"context": "container-start",
"meaning": "VS Code Server の本体の同時の展開で、遅れた側の中身が bin/<commit>/vscode-server-linux-<arch>/ に入れ子で残ったもの。product.json を持ち、コンテナの起動の片付けが消す",
"source": "",
"pending_source": "issues/issue-463-design.md"
"source": "docs/specifications/vscode-server-volume.md"
},
{
"term": "残す版の数",
"context": "container-start",
"meaning": "コンテナの起動の片付けが共通の VS Code Server ボリュームの bin/ に残す本体の版の数。5。版は product.json の更新時刻の新しい順に数える",
"source": "",
"pending_source": "issues/issue-463-design.md"
"source": "docs/specifications/vscode-server-volume.md"
}
]
}
Loading
Loading