Skip to content

Instantly share code, notes, and snippets.

View nobutilus's full-sized avatar

nobuya nobutilus

View GitHub Profile
@nobutilus
nobutilus / 0_codespaces-speedup-ghcr.md
Last active February 14, 2026 17:06
Generic guide for GitHub Codespaces speedup using GHCR and Pre-build strategy

GitHub Codespaces 起動高速化の知見:GHCR を活用したイメージベース運用

GitHub Codespaces の起動速度を劇的に改善し、failed to register layer: max depth exceeded エラーを回避するためのアプローチをまとめます。

1. 背景と課題

  • Docker Compose の多用による遅延: devcontainer.json で複数の Docker Compose ファイルを重ね合わせると、レイヤー数が増大し起動エラーが発生しやすくなります。
  • Feature インストールのオーバーヘッド: 起動のたびに features をインストールすると時間がかかります。

2. 解決策:Pre-build 戦略

開発環境を事前にビルドして GitHub Container Registry (GHCR) にプッシュしておき、Codespaces はそのイメージをプルするだけの状態にします。