Docker#

とはいえDockerですら万能ではありませんでした。

例えば本番環境ではNode 18を継承したDocker Imageをdocker composeなりで動かすようなプロダクトを考えましょう。

FROM oven/bun:1

WORKDIR /home/bun/app
COPY package.json bun.lockb ./
RUN bun install --frozen-lockfile

その時は上のようなDockerfileを作成すると思います。

.
├── node_modules/
├── src/
│   └── index.ts
├── package.json
├── tsconfig.json
├── Dockerfile
├── docker-compose.yaml
└── bun.lockb

そして、実際に今まで私がプロダクト開発をする際は上のようなディレクトリ構成になっていました。

問題点#

ではこの構成の問題点は何でしょうか？

一つは、実際に開発する環境が動かす環境と異なってしまうという点です。

例えばDockerのイメージとしてNode 18を使いたければホストマシンにNode 18をインストールする必要があります。

するとNodeのバージョン管理マネージャーが必要になるのでnvmなどのインストールが必要になります。

もう一つはホストマシンとDockerのアーキテクチャの差を埋めることができないということです。

稀にaarch64で動かないみたいなパッケージもあったりするので、上のような構成ではホストマシンは常にホストマシンでのアーキテクチャでしか動作させることができません。

せっかくDockerがアーキテクチャの差を埋められるのにホストマシンでそのまま開発していては意味がないわけです。

じゃあDockerコンテナを立ち上げてその中で開発してしまえばよいのですが、これにも問題があります。

1. Dockerコンテナ内で変更した内容がホストマシンに伝わらない
2. Dockerコンテナ内からリポジトリにプッシュできない
3. VSCodeのExtensionなどが効かない

1についてはvolumesを利用することで解消できます。

2については公開鍵認証を利用している場合に問題になります。

当たり前ですが、ホストマシンの.sshをCOPYコマンドで複製するようなムーブメントは絶対にしないでください。

そしてこれを解決するための素晴らしいソリューションがDevContainerにはあるのでそれを利用します。

3についてはまあそりゃそうかっていう感じです。

要するに私達がしたいのはDockerのコンテナの中で開発をし、変更は即座にホストマシンに反映され、かつリポジトリにプッシュもできてExtensionも使えるという状況です。

開発は全てDockerのコンテナの中でやりたいわけです。

こうすれば、ありとあらゆる互換性の問題は排除されます。

devcontainer.json#

設定ファイルは以下のようなものを書きます。

自分の場合、開発するのは主にNodeかBunだと思うのでそれを載せておきます。

Bunだとデフォルトユーザーがbun, Nodeだとnodeなので異なるのはそこだけです。

workspaceFolderは末尾にappをつけていますが直接/home/bunのように指定する人もいると思います。

ここはDockerfileで決められるので好きなものをご利用ください。

serviceの値はdocker-compose.yamlで設定した値を使います。

{
  "name": "Dev Container",
  "dockerComposeFile": [
    "docker-compose.yaml"
  ],
  "service": "DOCKER_COMPOSE_SERVICE_NAME",
  "workspaceFolder": "/home/bun/app",
  "shutdownAction": "stopCompose",
  "remoteUser": "bun",
  "features": {
    "ghcr.io/devcontainers/features/git:1": {},
    "ghcr.io/devcontainers/features/common-utils:2": {
      "configureZshAsDefaultShell": true
    },
    "ghcr.io/devcontainers/features/github-cli:1": {},
    "ghcr.io/devcontainers/features/docker-outside-of-docker:1": {
      "moby": false,
      "dockerDashComposeVersion": "v2"
    }
  },
  "postAttachCommand": "git config --global --unset commit.template", # いらないかもしれないけどわからん
  "postCreateCommand": "sudo chown -R bun:bun node_modules", # これは多分必須
  "customizations": {
    "vscode": {
      "settings": {
        "debug.internalConsoleOptions": "neverOpen",
        "editor.formatOnPaste": true,
        "editor.guides.bracketPairs": "active",
        "scm.defaultViewMode": "tree",
        "diffEditor.diffAlgorithm": "advanced",
        "diffEditor.experimental.showMoves": true,
        "diffEditor.renderSideBySide": false,
        "files.watcherExclude": {
          "**/node_modules/**": true
        },
        "betterTypeScriptErrors.prettify": true
      },
      "extensions": []
    }
  }
}

デフォルトでzshを利用するように書いているのですが、ひょっとするとNodeの古いバージョンだと動かないと思うのでその時は消してください。

featuresを利用してホストマシンと.gitを共有したり、デフォルトをzshに変更できたりします。

非常に便利なのでこのままコピペすればよいと思います。

その他の便利な機能についてはdevcontainers/featuresで公開されているのでこれを利用するとよいでしょう。

VSCode拡張機能 Remote Containers におけるpostCreateCommandなどの実行タイミングについて

postCreateCommandはデフォルトだとnode_modulesがroot:rootになっていてアクセスできないのでそれを変更するためのものです。

postAttachCommandは.gitconfigをローカルからコピーしてくるとgit commitが効かなくなるのでその対策です。

postCreateCommandで実行できればよいのですが、そのタイミングではまだ.gitconfigがコピーされていないので利用できません、悲しい。

正直、アタッチするたびに呼ばれて面倒なのですが、他に良い方法があれば教えて下さい。

docker-compose.yaml#

version: '3.9'

services:
  DOCKER_COMPOSE_SERVICE_NAME:
    container_name: DOCKER_COMPOSE_CONTAINER_NAME # 任意の値
    platform: linux/amd64 # 利用したいアーキテクチャ 特に指定しなくても良い
    build:
      context: .
      dockerfile: Dockerfile
    volumes:
      - ../:/home/bun/app:cached # NodeかBunかで変更
      - node_modules_cached:/home/bun/app/node_modules # NodeかBunかで変更
    tty: true # とりあえずつけている
    stdin_open: true # とりあえずつけている
  
volumes:
  node_modules_cached:

ここではホストマシンとDocker内でファイルを同期するようにvolumesを利用して指定します。

ただし、node_modulesを同期してしまうととんでもなく遅くなるのでこれだけは名前付きボリュームを利用してホストマシンとは同期しないようにします。

こうすることで以前のプロジェクトではyarn installに150秒くらいかかっていたのが85秒程度にまで高速化できました。

Dockerfile#

FROM oven/bun:1.0.35
USER bun
WORKDIR /home/bun/app
CMD ["/bin/bash"] # 勝手にターミナルが閉じるのでその対策(必要?)

Dockerファイル自体は上のようになります。たったこれだけでよいです。

追加でなにかパッケージをいれたいときはここに書けばよいです。

なお、ソースコード自体はDockerにいれずにDocker composeを使って同期するのでこの時点でyarn installやbun installは利用できません。