Windows 10 WSL2 환경에서 docker-compose 빌드하는 방법
아마도 정상적인 환경 구성이 안 되어 있다면 docker compose를 사용하는 빌드 스크립트를 리눅스 환경에서 잘 사용하다가 윈도우 10의 WSL 2 리눅스 배포판에서 빌드하면 다음과 같은 식으로 오류가 발생할 것입니다.
$ ./build.sh
The command 'docker-compose' could not be found in this WSL 2 distro.
We recommend to activate the WSL integration in Docker Desktop settings.
See https://docs.docker.com/docker-for-windows/wsl/ for details.
이 문제를 해결하려면 우선
Docker Desktop을 설치해야 합니다. 또한, 설치 후 다음과 같이 "Use Docker Compose V2" 옵션을 켜야 하고,
WSL 2 환경에서 통합이 되도록 "Use the WSL 2 based engine" 옵션도 켜야 합니다.
참고로, WSL 2 환경으로 개발하다 보면 다음과 같은 식의 오류도 보게 될 것입니다.
// 사용자 명이 testusr인 경우
$ ./build.sh
Pulling django ... done
Pulling nginx-front ... done
Pulling prom ... done
Pulling grafana ... done
Pulling jenniferview ... done
Pulling jenniferdata ... done
nginx-front uses an image, skipping
prom uses an image, skipping
grafana uses an image, skipping
Building django
WARNING: unable to unmarshal config file /home/testusr/.docker/config.json: invalid character 'ï' looking for beginning of value
/home/testusr/.docker/config.json: invalid character 'ï' looking for beginning of value
ERROR: Service 'django' failed to build : Build failed
아마도 /home/testusr/.docker/config.json 파일이 UTF-8 형식으로 저장되었을 텐데, 아쉽게도 BOM이 함께 지정된 형태일 것입니다. 따라서, 그 파일을 열어 보면, 이런 식으로 앞 부분이 깨져서 나올 텐데,
$ cat config.json
┌{
"experimental": "enabled"
}
$ cat config.json | od -t x1
0000000 ef bb bf 7b 0d 0a 20 20 22 65 78 70 65 72 69 6d
0000020 65 6e 74 61 6c 22 3a 20 22 65 6e 61 62 6c 65 64
0000040 22 0d 0a 7d
보는 바와 같이 앞의 3바이트가 0xef, 0xbb, 0xbf로 UTF8 encoding에 대한 BOM입니다. 따라서, 다음과 같이 vi 명령어를 이용해 BOM을 삭제해 주면 해결됩니다.
$ vi -c ":set nobomb" -c ":wq" $HOME/.docker/config.json
$ cat config.json | od -t x1
0000000 7b 0d 0a 20 20 22 65 78 70 65 72 69 6d 65 6e 74
0000020 61 6c 22 3a 20 22 65 6e 61 62 6c 65 64 22 0d 0a
0000040 7d 0d 0a
[이 글에 대해서 여러분들과 의견을 공유하고 싶습니다. 틀리거나 미흡한 부분 또는 의문 사항이 있으시면 언제든 댓글 남겨주십시오.]