Microsoft MVP성태의 닷넷 이야기
개발 환경 구성: 473. Windows nanoserver에 대한 docker pull의 태그 사용 [링크 복사], [링크+제목 복사],
조회: 20435
글쓴 사람
정성태 (techsharer at outlook.com)
홈페이지
첨부 파일
 
(연관된 글이 1개 있습니다.)

Windows nanoserver에 대한 docker pull의 태그 사용

"nanoserver" 이미지를 받아볼까요? ^^

C:\temp> docker pull mcr.microsoft.com/windows/nanoserver
Using default tag: latest
Error response from daemon: manifest for mcr.microsoft.com/windows/nanoserver:latest not found: manifest unknown: manifest unknown

위와 같이 기본적으로 tag를 안 붙이는 경우 ":latest"로 접근하게 되는데 "모든" 이미지들이 꼭 "latest"가 붙은 이미지를 함께 배포하는 것은 아니므로 해당 이미지 배포본의,

Nano Server
; https://hub.docker.com/_/microsoft-windows-nanoserver

도움말을 찾아 지원되는 태그를 확인하는 것이 좋습니다.

Note: This repo does not publish or maintain a latest tag. Please declare a specific tag when pulling or referencing images from this repo.

참고로, 위의 링크에도 나오지만 nanoserver의 지원되는 모든 태그 목록은 다음과 같은 링크로 구할 수 있습니다.

List of all available tags for windows/nanoserver 
; https://mcr.microsoft.com/v2/windows/nanoserver/tags/list




그런데 지원된다고 하는 태그조차도 manifest 목록에 없다고 할 수 있습니다.

C:\temp> docker pull mcr.microsoft.com/windows/nanoserver:1903
1903: Pulling from windows/nanoserver
no matching manifest for windows/amd64 10.0.14393 in the manifest list entries

그래서 "List of all available tags for windows/nanoserver" 목록을 통해 근사치 태그로 접근해도 이번에는 현재 운영체제와 맞지 않는 이미지라고 오류가 발생할 수 있습니다.

C:\temp> docker pull mcr.microsoft.com/windows/nanoserver:1903-amd64
1903-amd64: Pulling from windows/nanoserver
a Windows version 10.0.18362-based image is incompatible with a 10.0.17763 host

"docker info" 명령어로 확인해 보면,

Kernel Version: 10.0 17763 (17763.1.amd64fre.rs5_release.180914-1434)
Operating System: Windows Server 2019 Datacenter Version 1809 (OS Build 17763.1075)
OSType: windows
Architecture: x86_64
CPUs: 8

운영체제의 버전이 1809이므로 "1903-amd64"의 경우 그보다 최신 버전이므로 오류가 발생한 것입니다. 따라서, 태그 목록에서 1809 관련한 태그를 찾아 시도하면,

C:\temp> docker pull mcr.microsoft.com/windows/nanoserver:1809-amd64
1809-amd64: Pulling from windows/nanoserver
a35da61c3562: Pull complete
Digest: sha256:06281772b6a561411d4b338820d94ab1028fdeb076c85350bbc01e80c4bfa2b4
Status: Downloaded newer image for mcr.microsoft.com/windows/nanoserver:1809-amd64

휴~~~ 이제야 겨우 이미지를 내려받았습니다. ^^; 하지만, 만약 여러분이 운이 나빠 "Docker Desktop for Windows" 환경에서 테스트하는 경우라면 이런 오류도 만날 수 있습니다.

C:\temp> docker pull mcr.microsoft.com/windows/nanoserver:1809-amd64
1809-amd64: Pulling from windows/nanoserver
a35da61c3562: Downloading [==>                                                ]  5.405MB/101.1MB
image operating system "windows" cannot be used on this platform

그렇습니다, 현재 "Docker Desktop"이 "Linux Containers" 모드로 동작하고 있기 때문에 윈도우 이미지를 설치할 수 없는 것입니다. 트레이 아이콘으로 가서 "Switch to Windows containers..." 명령을 실행한 후에야 "nanoserver" 이미지를 설치할 수 있습니다.




만약 여러분들이 운이 나빠 "Windows Server 2016"을 가지고 있다면,

C:\temp> docker info
...[생략]... 
 Kernel Version: 10.0 14393 (14393.3541.amd64fre.rs1_release_inmarket.200218-2047)
 Operating System: Windows Server 2016 Standard Version 1607 (OS Build 14393.3542)
 OSType: windows
...[생략]...

"Version 1607"을 보고는 아마도 다음과 같이 시도할지도 모르겠습니다.

C:\temp> docker pull mcr.microsoft.com/windows/nanoserver:1607-amd64
Error response from daemon: manifest for mcr.microsoft.com/windows/nanoserver:1607-amd64 not found: manifest unknown: manifest unknown

아쉽게도 마이크로소프트는 1607-amd64 태그를 가진 nanoserver는 배포하지 않습니다. 대신 "1803-amd64"를 실행해 보면, 당연히 현재의 운영체제에서는 지원할 수 없다는 오류 메시지를 보게 됩니다.

C:\temp> docker pull mcr.microsoft.com/windows/nanoserver:1803-amd64
1803-amd64: Pulling from windows/nanoserver
a Windows version 10.0.17134-based image is incompatible with a 10.0.14393 host

Windows Server 2016의 경우에는, "OS Build" 버전의 정보까지 내려가서 태그를 달아야 합니다. 위에서 docker info로 본 OS Build는 14393.3542였는데, 그렇다고 해서 이 빌드 버전을 그대로 사용할 수는 없습니다.

C:\temp> docker pull mcr.microsoft.com/windows/nanoserver:10.0.14393.3542
Error response from daemon: manifest for mcr.microsoft.com/windows/nanoserver:10.0.14393.3542 not found: manifest unknown: manifest unknown

"List of all available tags for windows/nanoserver" 목록을 보고, 최대한 근사치의 태그를 찾아 시도해 보면 정상적으로 이미지를 다운로드할 수 있습니다.

C:\temp> docker pull mcr.microsoft.com/windows/nanoserver:10.0.14393.2430
10.0.14393.2430: Pulling from windows/nanoserver
bce2fbc256ea: Already exists
4a14bdf6da80: Pull complete
Digest: sha256:ba322999264cd8ecdfb3fcaec020c7a479ff63e6c4333d89d11d67ecbd96b2b3
Status: Downloaded newer image for mcr.microsoft.com/windows/nanoserver:10.0.14393.2430
mcr.microsoft.com/windows/nanoserver:10.0.14393.2430




결국, 여러분들이 nanoserver를 기반으로 한 Dockerfile을 만들 때 사용할 기반 이미지의 태그를,

FROM mcr.microsoft.com/windows/nanoserver:1809
...

주의 깊게 사용해야 합니다. 개발자의 환경에서는 Windows 10을 사용해 1903 nanoserver로 무심코 이미지를 생성할 수 있겠지만, 그것이 실 서버에 올라갈 때는 운영팀에서 (역시 무심코) 올리게 될 환경이 Windows Server 2019 서버일지라도 1809 버전 또는 1903 버전일 수 있으므로 그에 따라 혼란을 야기할 수 있습니다.




참고로 이와 관련한 공식 문서도 보시고. ^^

Windows container version compatibility
; https://learn.microsoft.com/en-us/virtualization/windowscontainers/deploy-containers/version-compatibility?tabs=windows-server-1909%2Cwindows-10-1909




[이 글에 대해서 여러분들과 의견을 공유하고 싶습니다. 틀리거나 미흡한 부분 또는 의문 사항이 있으시면 언제든 댓글 남겨주십시오.]

[연관 글]






[최초 등록일: ]
[최종 수정일: 3/9/2024]

Creative Commons License
이 저작물은 크리에이티브 커먼즈 코리아 저작자표시-비영리-변경금지 2.0 대한민국 라이센스에 따라 이용하실 수 있습니다.
by SeongTae Jeong, mailto:techsharer at outlook.com

비밀번호

댓글 작성자
 



2020-09-27 07시04분
[happyrami] 큰 도움이 되었습니다. 감사합니다. ^^
[guest]

1  2  3  4  5  [6]  7  8  9  10  11  12  13  14  15  ...
NoWriterDateCnt.TitleFile(s)
13829정성태11/25/20246665스크립트: 67. 파이썬 - Windows 버전에서 함께 설치되는 py.exe
13828정성태11/25/20245178개발 환경 구성: 735. Azure - 압축 파일을 이용한 web app 배포 시 디렉터리 구분이 안 되는 문제파일 다운로드1
13827정성태11/25/20246003Windows: 273. Windows 환경의 파일 압축 방법 (tar, Compress-Archive)
13826정성태11/21/20246380닷넷: 2313. C# - (비밀번호 등의) Console로부터 입력받을 때 문자열 출력 숨기기(echo 끄기)파일 다운로드1
13825정성태11/21/20247038Linux: 110. eBPF / bpf2go - BPF_RINGBUF_OUTPUT / BPF_MAP_TYPE_RINGBUF 사용법
13824정성태11/20/20245423Linux: 109. eBPF / bpf2go - BPF_PERF_OUTPUT / BPF_MAP_TYPE_PERF_EVENT_ARRAY 사용법
13823정성태11/20/20246606개발 환경 구성: 734. Ubuntu에 docker, kubernetes (k3s) 설치
13822정성태11/20/20246488개발 환경 구성: 733. Windbg - VirtualBox VM의 커널 디버거 연결 시 COM 포트가 없는 경우
13821정성태11/18/20246087Linux: 108. Linux와 Windows의 프로세스/스레드 ID 관리 방식
13820정성태11/18/20246547VS.NET IDE: 195. Visual C++ - C# 프로젝트처럼 CopyToOutputDirectory 항목을 추가하는 방법
13819정성태11/15/20245127Linux: 107. eBPF - libbpf CO-RE의 CONFIG_DEBUG_INFO_BTF 빌드 여부에 대한 의존성
13818정성태11/15/20246658Windows: 272. Windows 11 24H2 - sudo 추가
13817정성태11/14/20245894Linux: 106. eBPF / bpf2go - (BPF_MAP_TYPE_HASH) Map을 이용한 전역 변수 구현
13816정성태11/14/20246850닷넷: 2312. C#, C++ - Windows / Linux 환경의 Thread Name 설정파일 다운로드1
13815정성태11/13/20245467Linux: 105. eBPF - bpf2go에서 전역 변수 설정 방법
13814정성태11/13/20246109닷넷: 2311. C# - Windows / Linux 환경에서 Native Thread ID 가져오기파일 다운로드1
13813정성태11/12/20246631닷넷: 2310. .NET의 Rune 타입과 emoji 표현파일 다운로드1
13812정성태11/11/202410226오류 유형: 933. Active Directory - The forest functional level is not supported.
13811정성태11/11/20245838Linux: 104. Linux - COLUMNS 환경변수가 언제나 80으로 설정되는 환경
13810정성태11/10/20246831Linux: 103. eBPF (bpf2go) - Tracepoint를 이용한 트레이스 (BPF_PROG_TYPE_TRACEPOINT)
13809정성태11/10/20246471Windows: 271. 윈도우 서버 2025 마이그레이션
13808정성태11/9/20246778오류 유형: 932. Linux - 커널 업그레이드 후 "error: bad shim signature" 오류 발생
13807정성태11/9/20245680Linux: 102. Linux - 커널 이미지 파일 서명 (Ubuntu 환경)
13806정성태11/8/20245849Windows: 270. 어댑터 상세 정보(Network Connection Details) 창의 내용이 비어 있는 경우
13805정성태11/8/20245462오류 유형: 931. Active Directory의 adprep 또는 복제가 안 되는 경우
13804정성태11/7/20247000Linux: 101. eBPF 함수의 인자를 다루는 방법
1  2  3  4  5  [6]  7  8  9  10  11  12  13  14  15  ...