[Docker] Slicon M1 Mac에서 Lima로 Docker Desktop 대체 하기

💡 본 문서는 'Slicon M1 Mac에서 Lima로 Docker Desktop 대체 하기' 포스팅을 바탕으로 작성한 글이니 참고하시기 바랍니다.

1. Lima 소개

간단히 Lima 에 대해 소개하자면 Linux VM 를 Mac 환경에 만들어주는 오픈소스이며, 윈도우의 WSL (Windows Subsystem for Linux) 과 유사한 면이 있습니다. 아래 그림과 같이 기본적으로 lima는 containerd를 실행하여 컨테이너를 관리하며, 컨테이너 생성, 시작, 중지, 이미지 가져오기 및 저장, 마운트 구성, 네트워킹 등의 역할을 합니다.

2. Lima 사용하기

2.1. Lima 설치

% ⁠brew install lima docker docker-compose

2.2. Lima 시작: VM 생성 및 삭제

limactl 명령으로 lima VM을 만들 수 있으며, 아래의 명령으로 기본 VM(Ubuntu 이미지, nerdctl을 다운)을 만들 수 있습니다.

% limactl start
? Creating an instance "default"  [Use arrows to move, type to filter]
> Proceed with the current configuration
  Open an editor to review or modify the current configuration
  Choose another example (docker, podman, archlinux, fedora, ...)
  Exit

이후 생성한 "default" VM instance를 다음의 명령으로 삭제할 수 있습니다.

% limactl stop default		# default 인스턴스 중지
% limactl remove default	# default 인스턴스 삭제

2.3. Lima 설정: docker 사용

1) 기본 docker 설정 파일

아까 설치한 VM 인스턴스는 아무 것도 설치하지 않은 상태이므로 Lima repository에서 예제로 제공하는 docker yaml 설정 샘플을 받아서 인스턴스를 생성해봅시다.

% curl -o docker.yaml https://raw.githubusercontent.com/lima-vm/lima/master/examples/docker.yaml
% limactl start docker.yaml
? Creating an instance "default" Proceed with the current configuration
INFO[0001] Attempting to download the image              arch=aarch64 digest="sha256:b47f8be40b5f91c37874817c3324a72cea1982a5fdad031d9b648c9623c3b4e2" location="https://cloud-images.ubuntu.com/releases/22.04/release-20230518/ubuntu-22.04-server-cloudimg-arm64.img"
INFO[0001] Using cache "/Users/choiseongjun/Library/Caches/lima/download/by-url-sha256/2dd0439437354b40b9e07d4b3e1a56650b0bf163a0634ac092d17fcbc76329ea/data"
INFO[0002] [hostagent] Starting QEMU (hint: to watch the boot progress, see "/Users/choiseongjun/.lima/default/serial.log")
INFO[0002] SSH Local Port: 60022
...

VM 인스턴스가 생성된 후 'lima'로 해당 인스턴스에 접속하여 docker를 사용할 수 있습니다.

choiseongjun@choeseongjun-ui-MacBookPro Downloads% lima  
choiseongjun@lima-default:/Users/choiseongjun/Downloads$ docker ps
CONTAINER ID   IMAGE     COMMAND   CREATED   STATUS    PORTS     NAMES

2) 기본 docker-rootful 설정 파일: 기본 sudo 권한

% curl -o docker-rootful.yaml https://raw.githubusercontent.com/DrawingProcess/docker-compose/master/lima_docker/docker-rootful.yaml
% limactl start docker-rootful.yaml

 

2.4. ~/.ssh/config 설정하기

limactl show-ssh 옵션을 사용하면 지정한 vmd 의 ssh config 설정을 아래와 같이 가져올 수 있다.

% limactl show-ssh --format=config default

해당 내용을 ~/.ssh/config 에 설정해주면 간편하게 ssh 접속이 가능해진다.

% limactl show-ssh --format=config default >> ~/.ssh/config

2.5. Mac 에서 VM 도커 이용하기

Mac 에서 VM 도커 이용하기 위해서는 ssh로 해당 인스턴스에 접속하거나, DOCKER_HOST를 다음과 같이 설정해주면 됩니다.

% ssh lima-default # ~/.ssh/config 에서 설정한 hostname

또는

% export DOCKER_HOST=ssh://lima-default:60006

3. Trouble Shooting

1) docker-compose up 오류

다음과 같은 docker-compose 에서 registry 에 접근이 안되는 오류가 발생한다. 이런 경우는 docker-compose.yaml 에 기술된 이미지를 docker pull 받은 다음에 다시 시도하면 됩니다.

2) docker-compose 사용시 mount 설정 대상의 read-only 오류

limactl로 초기 설정할 때 사용한 파일은 ~/.lima/<file_name>/lima.yaml에 위치합니다. 여기서 초기 설정은 홈디렉토리(~)가 'writable: false'로 설정되어 있는데, 이를  'writable: true'로 수정해줍니다.

% nano ~/.lima/docker/lima.yaml

...
# ~/.lima/default/lima.yaml 에서 마운트 부분을 확인해보고 아래와 같이 바꾼다
mounts:
  - location: "~"
    writable: true
  - location: "/tmp/lima"
    writable: true

3) mount 오류, lima v.0.8.0

-v 명령을 쓸때 마운트 하고자 하는 소스의 위치가 ~/.lima//lima.yaml 파일에서 설정한 mounts 위치의 내부 폴더여야 합니다. 따라서 위와 같이 설정시 '~/' 또는 '/tmp/lima' 내부여야 합니다. 기본 docker.yaml을 사용할 경우, /tmp/lima/vol 과 같은 하위 디렉토리도 안됩니다.

% docker run -it --name test -v /tmp/lima:/code/mnt -d test-app:2021122202

참고

• [Blog] Slicon M1 Mac에서 Lima로 Docker Desktop 대체 하기: https://breezymind.com/slicon-m1-mac-lima-docker-desktop-alternative/
• [Reddis] Replacing Docker Desktop with Lima on Mac OS: https://www.reddit.com/r/docker/comments/sihgoy/replacing_docker_desktop_with_lima_on_mac_os/
• [Blog] Replacing Docker Desktop with Lima on Mac OS: https://naomiaro.hashnode.dev/replacing-docker-desktop-with-lima-on-mac-os
• [Github] lima docker.yaml: https://github.com/lima-vm/lima/blob/master/examples/docker.yaml