📠

Macでlimaを使ってUbuntuの仮想環境を構築してみた

2024/12/23に公開

はじめに

今まではWindowsでWSLを使ってUbuntuを立ち上げた事はあったけど、Macではやったことがなかったのでやってみました。
limaを採用したのはWSLと似たような操作感だったためです。

実行環境

バージョン
Mac OS Sequoia 15.1
lima 1.0.2

limaをインストールする

limaを入れるときはHomebrewを使いました。(Homebrewのインストールは割愛します)
下記コマンドだけでインストールできます。

brew install lima

Ubuntu起動用のyamlファイルを作成する

yamlファイルはlimaのgithubにテンプレートがたくさん置かれてます。
https://github.com/lima-vm/lima/tree/master/templates

今回は仮想環境の中でdockerを使いたいので、docker-rootful.yamlを使います。
vscodeからリモート接続したいので、テンプレートをベースにsshの設定を追記します。
ついでにcpu・メモリ・ディスクサイズの設定も追加しておきます。

# A template to use Docker (rootful) instead of containerd & nerdctl
# $ limactl start ./docker-rootful.yaml
# $ limactl shell docker-roootful docker run -it -v $HOME:$HOME --rm alpine

# To run `docker` on the host (assumes docker-cli is installed):
# $ export DOCKER_HOST=$(limactl list docker-rootful --format 'unix://{{.Dir}}/sock/docker.sock')
# $ docker ...

ssh:
  localPort: 60022
  loadDotSSHPubKeys: true

cpus: 4
memory: "4GiB"

disk: "20GiB"

# This template requires Lima v0.20.0 or later
images:
# Try to use release-yyyyMMdd image if available. Note that release-yyyyMMdd will be removed after several months.
- location: "https://cloud-images.ubuntu.com/releases/24.04/release-20241119/ubuntu-24.04-server-cloudimg-amd64.img"
  arch: "x86_64"
  digest: "sha256:b63f266fa4bdf146dea5b0938fceac694cb3393688fb12a048ba2fc72e7bfe1b"
- location: "https://cloud-images.ubuntu.com/releases/24.04/release-20241119/ubuntu-24.04-server-cloudimg-arm64.img"
  arch: "aarch64"
  digest: "sha256:6e1f90d3e81b90202b46c3573590867e575e504af2c63dd5c9b529f174e3d793"
# Fallback to the latest release image.
# Hint: run `limactl prune` to invalidate the cache
- location: "https://cloud-images.ubuntu.com/releases/24.04/release/ubuntu-24.04-server-cloudimg-amd64.img"
  arch: "x86_64"
- location: "https://cloud-images.ubuntu.com/releases/24.04/release/ubuntu-24.04-server-cloudimg-arm64.img"
  arch: "aarch64"

mounts:
- location: "/tmp/lima"
  writable: true
# containerd is managed by Docker, not by Lima, so the values are set to false here.
containerd:
  system: false
  user: false
provision:
- mode: system
  # This script defines the host.docker.internal hostname when hostResolver is disabled.
  # It is also needed for lima 0.8.2 and earlier, which does not support hostResolver.hosts.
  # Names defined in /etc/hosts inside the VM are not resolved inside containers when
  # using the hostResolver; use hostResolver.hosts instead (requires lima 0.8.3 or later).
  script: |
    #!/bin/sh
    sed -i 's/host.lima.internal.*/host.lima.internal host.docker.internal/' /etc/hosts
- mode: system
  script: |
    #!/bin/bash
    set -eux -o pipefail
    command -v docker >/dev/null 2>&1 && exit 0
    if [ ! -e /etc/systemd/system/docker.socket.d/override.conf ]; then
      mkdir -p /etc/systemd/system/docker.socket.d
      # Alternatively we could just add the user to the "docker" group, but that requires restarting the user session
      cat <<-EOF >/etc/systemd/system/docker.socket.d/override.conf
      [Socket]
      SocketUser={{.User}}
    EOF
    fi
    export DEBIAN_FRONTEND=noninteractive
    curl -fsSL https://get.docker.com | sh
probes:
- script: |
    #!/bin/bash
    set -eux -o pipefail
    if ! timeout 30s bash -c "until command -v docker >/dev/null 2>&1; do sleep 3; done"; then
      echo >&2 "docker is not installed yet"
      exit 1
    fi
    if ! timeout 30s bash -c "until pgrep dockerd; do sleep 3; done"; then
      echo >&2 "dockerd is not running"
      exit 1
    fi
  hint: See "/var/log/cloud-init-output.log" in the guest
hostResolver:
  # hostResolver.hosts requires lima 0.8.3 or later. Names defined here will also
  # resolve inside containers, and not just inside the VM itself.
  hosts:
    host.docker.internal: host.lima.internal
portForwards:
- guestSocket: "/var/run/docker.sock"
  hostSocket: "{{.Dir}}/sock/docker.sock"
message: |
  To run `docker` on the host (assumes docker-cli is installed), run the following commands:
  ------
  docker context create lima-{{.Name}} --docker "host=unix://{{.Dir}}/sock/docker.sock"
  docker context use lima-{{.Name}}
  docker run hello-world
  ------

Ubuntuの仮想環境を起動する

以下コマンドを叩きます。

limactl start --tty=false <yamlのファイル名>

しばらくすると起動するので、以下コマンドで確認します。

limactl list

yamlファイル名で、コンテナができてるはずです。

これで仮想環境の起動は終わりです。
次にvscodeからリモート接続したいと思います。

vscodeからリモート接続する

  1. vscode拡張機能「Remote-SSH」をインストールする。

  2. sshの設定を追記する
    limaのsshの設定ファイルは~/.limaの中にあるため、このままだとvscodeのRemote-SSHの一覧に出てこないので、/User/<ユーザ名>/.ssh/configにlimaのssh設定をincludeする。

    # Read more about SSH config files: https://linux.die.net/man/5/ssh_config
    Host alias
        HostName hostname
        User user
    Host <ホスト名> 👈このHost名はlimaのssh.configのHost名と合わせてください
        Include /Users/<ユーザ名>/.lima/<コンテナ名>/ssh.config
    

これで、Remote-SSHの一覧に出てくるはずです。

Discussion