ssh를 이용한 원격 docker 서비스 사용
예전에만 해도,
docker - 원격 제어를 위한 TCP 바인딩 추가
; https://www.sysnet.pe.kr/2/0/13386
Configure remote access for Docker daemon
; https://docs.docker.com/engine/daemon/remote-access/
원격에 있는 docker를 이용하려면 TCP 바인딩을 열어줘야 했는데요, 아쉽게도 보안이 취약해진다는 단점이 있습니다. 물론 secure socket 연결(Docker over TLS)을 위한 인증서 세팅을 해도 되지만, 그런 경우 은근 번거로움이 있습니다.
그런데, 어느새(?) (2018-11-08일에 릴리스한
18.09부터)
SSH를 이용한 원격 접속을 지원하고 있었습니다. ^^ 그래서 별도로 daemon.json이나 service 파일을 건드릴 필요 없이 기존의 ssh 연결만 가능했다면 그 설정 그대로 docker 제어가 원격으로 가능하게 됐습니다.
Protect the Docker daemon socket
; https://docs.docker.com/engine/security/protect-access/
예를 들어, 다음과 같은 상황일 때,
[A] docker 호스트 머신: 192.168.100.50
[B] docker 클라이언트 머신: 192.168.100.20
B 머신에서 A 머신으로 SSH 접속이 가능했다면, 다음과 같이 그 설정을 담은 context를 생성한 후,
C:\temp> docker context create --docker host=ssh://192.168.100.50 --description="UBUNTU24" test-vpc
C:\temp> docker context list
NAME DESCRIPTION DOCKER ENDPOINT ERROR
default Current DOCKER_HOST based configuration npipe:////./pipe/docker_engine
desktop-linux * Docker Desktop npipe:////./pipe/dockerDesktopLinuxEngine
test-vpc UBUNTU24 ssh://192.168.100.50
NAME 칼럼을 기준으로 context를 선택해 docker 명령을 실행할 수 있습니다.
// docker 서비스 문맥 설정
c:\temp> docker context use test-vpc
// 원격 docker 서비스의 컨테이너 목록 확인
c:\temp> docker ps
// 로컬 docker 서비스로 문맥 설정
c:\temp> docker context use default
// 로컬 docker 서비스의 컨테이너 목록 확인
c:\temp> docker ps
간단하죠? ^^
문맥 설정은 저장이 되기 때문에 이후 다시 명령행 창을 열어도 마지막 문맥 설정을 기준으로 docker 명령이 실행되므로 로컬에 docker가 있는 환경이라면 불편할 수 있습니다.
그런 경우, 현재 명령어 문맥을 임시로 "--context"를 이용해 바꾸는 것도 가능합니다.
c:temp> docker --context test-vpc ps
혹은, DOCKER_HOST 환경 변수를 이용할 수도 있고,
c:\temp> SET DOCKER_HOST=ssh://192.168.100.50
일일이 매번 -H 옵션에 명시하는 것도 가능합니다.
// 문맥을 이전에 저장하지 않았어도 -H로 직접 설정 가능
c:\temp> docker -H ssh://192.168.100.50 image list
참고로, 윈도우의 경우 기본적으로 %USERNAME% 환경 변수를 사용자로 docker 서버 측에 SSH 연결을 하는데요, 만약 사용자 이름이 틀리다면 ssh 연결 문자열에 직접 명시하면 됩니다.
docker context create --docker host=ssh://testusr@192.168.100.50 --description="UBUNTU24" test-vpc
SET DOCKER_HOST=ssh://testusr@192.168.100.50
docker -H ssh://testusr@192.168.100.50 image list
Windows Server 2022의 경우 SSH를 경유한 docker 명령어 실행 시 매우 느린 현상이 나옵니다.
Docker command execution on remote host extremly slow on Windows 10
; https://forums.docker.com/t/docker-command-execution-on-remote-host-extremly-slow-on-windows-10/138297
제가 테스트한 Windows 11의 경우에는 저런 현상이 없었는데요, "C:\Windows\System32\OpenSSH\ssh.exe"의 버전이 각각 8.6.0.1, 8.1.0.1로 달랐습니다. 적어도 8.6.0.1 버전부터는 그런 현상이 없다는 것인데요, 따라서 최신 버전의 OpenSSH를 다운로드해,
PowerShell/Win32-OpenSSH
; https://github.com/PowerShell/Win32-OpenSSH/releases
%PATH% 경로에 넣어두면 이 현상은 없어집니다.
ssh를 경유하기에 -v 볼륨 매핑의 기준은 sshd가 실행 중인 서버가 되므로 로컬 경로를 직접 명시할 수는 없습니다.
c:\temp> docker run -v "C:\temp:/temp" -it --rm --name test_cpp_build -p 15000:22 cpp_ubuntu18_build
docker: Error response from daemon: invalid mode: /temp.
See 'docker run --help'.
c:\temp> docker run -v "C:\temp:/temp:rw" -it --rm --name test_cpp_build -p 15000:22 cpp_ubuntu18_build
docker: Error response from daemon: invalid volume specification: 'C:\temp:/temp:rw'.
See 'docker run --help'.
대신 docker build 시에 "COPY" 명령어를 수행하는 것은 현재 시스템을 기준으로 하므로,
c:\temp> docker build -t cpp_ubuntu18_build -f dockerfile.ubuntu18.cppbuild .
위와 같이 한 경우, c:\temp 디렉터리를 기준으로 내부에서 "COPY" 명령어가 수행됩니다.
...[생략]...
WORKDIR /app
COPY ConsoleApp1 /app/src # C:\temp\ConsoleApp1 -> /app/src
ssh 접속으로 docker 명령어를 실행했는데 이런 오류가 발생한다면?
ERROR: Cannot connect to the Docker daemon at http://docker.example.com. Is the docker daemon running?
연결된 SSH 계정의 접속 권한이 docker에 허용돼 있는지 확인이 필요합니다. 가령, 직접 ssh 접속으로 확인해 보면 권한이 없는 경우에도 저런 오류가 발생합니다.
C:\temp> ssh test@192.168.100.50
$ docker ps
permission denied while trying to connect to the Docker daemon socket at unix:///var/run/docker.sock: Get "http://%2Fvar%2Frun%2Fdocker.sock/v1.51/containers/json": dial unix /var/run/docker.sock: connect: permission denied
따라서 당연히
현재 사용자 계정 또는 그룹에 대해 권한 부여를 하면 됩니다.
이로 인해 간혹 헷갈릴 상황이 있는데요, DOCKER_HOST 환경 변수로 *NIX 운영체제를 지정해 놓고는 그것을 잊어버리고 docker 명령을 내리면 무슨 오류인지도 모르고 헤맬 수가 있습니다. ^^
[이 글에 대해서 여러분들과 의견을 공유하고 싶습니다. 틀리거나 미흡한 부분 또는 의문 사항이 있으시면 언제든 댓글 남겨주십시오.]