Docker Desktop から Colima へ移行

[9sako6]

目的

macOS の Docker 実行環境を Docker Desktop から Colima へ移行する。
Docker Desktop 自体は dotfiles の管理対象ではないため、この PR では自動削除しない。Colima 側で問題なく作業できることを確認してから手動でアンインストールする。

変更内容

• pkgs.colima を追加する。
• Docker CLI は pkgs.docker で管理する。現在固定している nixpkgs の pkgs.docker には docker compose と docker buildx が組み込まれているため、pkgs.docker-compose / pkgs.docker-buildx は個別に追加しない。
• pkgs.docker-credential-helpers を追加し、Docker Desktop を削除した後も macOS Keychain 用の docker-credential-osxkeychain を使えるようにする。

移行前の注意

Docker Desktop をアンインストールすると、Docker Desktop 側にあるローカルの container / image / volume などは削除される。必要なデータがある場合は、アンインストール前に退避する。

また、~/.docker/config.json に Docker Desktop 用の credsStore や currentContext が残っている場合がある。ファイル自体を消すのではなく、Colima の動作確認後に不要な Desktop 向け設定だけを整理する。

移行手順

1. dotfiles を反映する

公開設定を直接使っている場合:

dotfiles plan --default
dotfiles test
dotfiles apply --default

private flake から dotfiles input を参照している場合は、PR の merge 後に private repository 側で dotfiles だけ更新してから反映する。

nix flake update dotfiles
git diff -- flake.lock
git add flake.lock
git commit -m "chore: update dotfiles"
git push

dotfiles plan
dotfiles apply

2. Docker Desktop を終了する

この時点ではアンインストールしない。Docker Desktop を終了して、Colima への切り替えを確認できる状態にする。

3. Colima を起動する

colima start
colima status

この PR では Colima の自動起動は設定しない。Mac を再起動した後など、停止している場合は colima start を実行する。

4. Docker CLI の接続先と基本機能を確認する

docker context ls
docker version
docker compose version
docker buildx version
docker run --rm hello-world

Colima の context が選択されていなければ、docker context ls で名前を確認して docker context use <context> で切り替える。

5. Docker の認証設定を確認する

grep -E '"(credsStore|currentContext)"' ~/.docker/config.json 2>/dev/null || true

credsStore が Docker Desktop の helper を指している場合は、Desktop のアンインストール後も残さない。macOS Keychain を使う場合は osxkeychain を指定できる。

必要なら docker login も実行し、private registry / Docker Hub への認証が問題ないことを確認する。

6. 普段使う環境を確認する

普段使う Compose project、Dev Container、build / push などを一通り試す。Docker socket を /var/run/docker.sock に固定しているツールがある場合は、Docker context に追従できるかも確認する。

7. Docker Desktop をアンインストールする

ここまで問題がなければ Docker Desktop をアンインストールする。必要な Docker Desktop 側のデータを退避済みであることを再確認してから行う。

ロールバック

Docker Desktop をアンインストールする前なら、colima stop して Docker Desktop を再度起動すれば戻せる。移行確認が終わるまでは Docker Desktop を残しておく。