LimaというVM環境でDockerを構築する。
22年1月18日シェル起動時にVM起動追記
23年2月11日書き込み権限の箇所を修正。
検証環境
- Mac OS Monterey 12.1
- MacBook Pro (Intel CPU)
- HomeBrew インストール済み
必要なパッケージをインストール
brew install lima docker
インストールが完了するとlimactlというコマンドが使用可能になる
limactl --version
追加で入れておきたいパッケージをインストール
brew install docker-compose
docker.yamlを用意する
構築用のyamlを適当なディレクトリにdocker.yamlという名前で作成。
バージョンによって推奨する内容が微妙に変わるようなので、以下のURLへアクセスして内容をdocker.yamlという名前でファイルとして保存する。
github /lima-vm/lima/examples/docker.yaml
https://github.com/lima-vm/lima/blob/master/examples/docker.yaml
もしくは、wgetを使って以下のようにファイルをダウンロードする。
wget https://github.com/lima-vm/lima/raw/master/examples/docker.yaml
docker.yamlに追記
リソースを変更
docker.yamlに以下を追記してリソースを変更。
cpus: 2
memory: "8GiB"
disk: "100GiB"
ssh関係
docker.yamlに以下を追記してエラー回避。
~/.sshのディレクトリ以下のファイル関係で問題がある場合、loadDotSSHPubKeysをfalseにしておかないとlimactl startコマンドでINFO[0003] [hostagent] Waiting for the essential requirement 1 of 5: "ssh"のループに陥る。
ssh:
loadDotSSHPubKeys: false
また、ポートを指定する場合は、上記に追記してポート番号を指定する
ssh:
loadDotSSHPubKeys: false
localPort: 60006
書き込み権限
デフォルトではユーザーのホームをマウントする設定になっているが、書き込みは出来ないようになっている。そのため、writable: true書き換え可能になる。権限が大きすぎるので、必要なディレクトリ以下にのみ権限をもたせたほうが良い。
mounts:
- location: "~"
writable: false
# 開発環境に使うディレクトリのみを対象にする
- location: "~/work"
writable: true
- location: "/tmp/lima"
writable: true
実行
以下を実行して構築。
limactl start ./docker.yaml
# --debugをつけると、エラーが発生した際に原因がわかりやすくなる
# limactl start ./docker.yaml --debug
確認
構築出来ているか確認する
limactl ls
NAME STATUS SSH ARCH CPUS MEMORY DISK DIR
docker Running 127.0.0.1:60006 x86_64 2 8GiB 100GiB /Users/ユーザ名/.lima/docker
仮想マシンに入る
limactl
Dockerが構築されている仮想マシンに直接入るには、以下のコマンドを実行する。
入ったあとはexitで仮想マシンから出る。
limactl shell docker
ssh
sshコマンドでVMに入る場合は以下のようになる。ポート番号は作成したyamlに依拠する。
ssh ${USER}@localhost -p 60006 -i /Users/${USER}/.lima/_config/user
この場合、known_hostsに記録されるので、作成したVMの状態が変わった場合は、以下を実行して記録を消さないとエラーになる。
ssh-keygen -R "[localhost]:60006"
DOCKER_HOST 環境変数
.zshrcや.zprofile（MacOSのバージョンによっては.bash_profile）に DOCKER_HOST環境変数を追記して、Dockerのベースをlimaの仮想マシンで使用するように変更する。（Limaのバージョンによっては内容が少々変わる可能性がある）
export DOCKER_HOST=unix:///${HOME}/.lima/docker/sock/docker.sock
シェル起動時にVM起動
システムを再起動すると、作成した仮想環境はstopの状態になるので、先程の.zshrcに仮想環境を立ち上げるように追記する。
limactl start docker
テスト
nginxを構築
試しにnginxを構築
docker run --name nginx_test -d -p 8080:80 nginx
http://localhost:8080/でnginxにアクセス出来るようになる。
nginxを削除
docker stop $(docker ps -aqf "name=nginx_test")
docker rm $(docker ps -aqf "name=nginx_test")
Docker outside of Docker
Dockerコンテナ内でDockerを使用する方法として、コンテナ内に内包する Docker in Docker とホスト側のDockerを利用する Docker outside of Docker がある。
LimaでDocker outside of dockerを利用する場合は、VM内の/var/run/docker.sockにchmodコマンドで権限を付与する。
limactl shell docker sudo chmod 0666 /var/run/docker.sock
その後、例えば以下のような docker-compose.yamlを用意して動作確認ができる。
なお、volumesの/var/run/docker.sockのパスは、VM内のソケットを指定している。
version: '3'
services:
dood:
image: docker:rc-git
volumes:
- /var/run/docker.sock:/var/run/docker.sock
tty: true
# コンテナ作成
docker-compose up -d
# docker infoコマンド
docker-compose exec dood docker info
# コンテナ等をまとめて削除
docker-compose down --rmi all --volumes --remove-orphans