Windows의 Docker 엔진

아티클
01/17/2024

적용 대상: Windows Server 2022, Windows Server 2019, Windows Server 2016

Docker 엔진 및 클라이언트는 Windows에 포함되어 있지 않으므로 개별적으로 설치하고 구성해야 합니다. 또한 Docker 엔진은 많은 사용자 지정 구성을 수락할 수 있습니다. 일부 예로는 디먼이 들어오는 요청을 수락하는 방법, 기본 네트워킹 옵션 및 디버그/로그 설정을 구성하는 것이 포함됩니다. Windows에서 이러한 구성은 구성 파일 또는 Windows 서비스 제어 관리자를 사용하여 지정할 수 있습니다. 이 문서에서는 Docker 엔진을 설치 및 구성하는 방법을 자세히 설명하고 일반적으로 사용하는 구성의 몇 가지 예도 제공합니다.

Docker 설치

Windows 컨테이너를 사용하려면 Docker가 필요합니다. Docker는 Docker 엔진(dockerd.exe) 및 Docker 클라이언트(docker.exe)로 구성됩니다. 모든 항목을 설치하는 가장 쉬운 방법은 빠른 시작 가이드를 참조하세요. 이 가이드는 모든 항목을 설정하고 첫 번째 컨테이너를 실행하는 데 도움이 됩니다.

Docker 설치

스크립트 설치에 대한 내용은 스크립트를 이용하여 Docker EE 설치를 참조하세요.

Docker를 사용하려면 먼저 컨테이너 이미지를 설치해야 합니다. 자세한 내용은 컨테이너 기본 이미지 문서를 참조하세요.

구성 파일을 사용하여 Docker 구성

Windows에서 Docker 엔진을 구성하는 기본 방법은 구성 파일을 사용하는 것입니다. 구성 파일은 'C:\ProgramData\Docker\config\daemon.json'에서 찾을 수 있습니다. 이 파일이 아직 없다면 만들 수 있습니다.

참고 항목

사용 가능한 Docker 구성 옵션 중에 Windows의 Docker에 적용되지 않는 옵션도 있습니다. 다음 예에서는 적용되는 구성 옵션을 보여줍니다. Docker 엔진 구성에 대한 자세한 내용은 Docker 디먼 구성 파일을 참조하세요.

{
    "authorization-plugins": [],
    "dns": [],
    "dns-opts": [],
    "dns-search": [],
    "exec-opts": [],
    "storage-driver": "",
    "storage-opts": [],
    "labels": [],
    "log-driver": "",
    "mtu": 0,
    "pidfile": "",
    "data-root": "",
    "cluster-store": "",
    "cluster-advertise": "",
    "debug": true,
    "hosts": [],
    "log-level": "",
    "tlsverify": true,
    "tlscacert": "",
    "tlscert": "",
    "tlskey": "",
    "group": "",
    "default-ulimits": {},
    "bridge": "",
    "fixed-cidr": "",
    "raw-logs": false,
    "registry-mirrors": [],
    "insecure-registries": [],
    "disable-legacy-registry": false
}

구성 파일에 필요한 구성 변경 내용만 추가해야 합니다. 예를 들어 다음 샘플에서는 포트 2375를 통해 들어오는 요청을 허용하도록 Docker 엔진을 구성합니다. 다른 모든 구성 옵션은 기본값을 사용합니다.

{
    "hosts": ["tcp://0.0.0.0:2375"]
}

마찬가지로 다음 샘플에서는 대체 경로에 이미지 및 컨테이너를 유지하도록 Docker 디먼을 구성합니다. 지정되지 않은 경우 기본값은 c:\programdata\docker입니다.

{   
    "data-root": "d:\\docker"
}

다음 샘플에서는 포트 2376을 통한 보안 연결만 허용하도록 Docker 디먼을 구성합니다.

{
    "hosts": ["tcp://0.0.0.0:2376", "npipe://"],
    "tlsverify": true,
    "tlscacert": "C:\\ProgramData\\docker\\certs.d\\ca.pem",
    "tlscert": "C:\\ProgramData\\docker\\certs.d\\server-cert.pem",
    "tlskey": "C:\\ProgramData\\docker\\certs.d\\server-key.pem",
}

Docker 서비스에서 Docker 구성

또한 sc config를 사용하여 Docker 서비스를 수정하는 방법으로 Docker 엔진을 구성할 수도 있습니다. 이 메서드를 사용하면 Docker 엔진 플래그가 Docker 서비스에 직접 설정됩니다. 명령 프롬프트에서 다음 명령을 실행합니다(PowerShell이 아닌 cmd.exe).

sc config docker binpath= "\"C:\Program Files\docker\dockerd.exe\" --run-service -H tcp://0.0.0.0:2375"

참고 항목

daemon.json 파일에 이미 "hosts": ["tcp://0.0.0.0:2375"] 항목이 포함되어 있으면 이 명령을 실행할 필요가 없습니다.

일반적인 구성

다음 구성 파일 예제에서는 일반적인 Docker 구성을 보여 줍니다. 이러한 파일은 단일 구성 파일로 결합할 수 있습니다.

기본 네트워크 만들기

기본 NAT 네트워크를 만들지 않도록 Docker 엔진을 구성하려면 다음 구성을 사용합니다.

{
    "bridge" : "none"
}

자세한 내용은 Docker 네트워크 관리를 참조 하세요.

Docker 보안 그룹 설정

Docker 호스트에 로그인하고 로컬에서 Docker 명령을 실행하면 이러한 명령은 명명된 파이프를 통해 실행됩니다. 기본적으로 관리istrators 그룹의 멤버만 명명된 파이프를 통해 Docker 엔진에 액세스할 수 있습니다. 이 액세스 권한이 있는 보안 그룹을 지정하려면 플래그를 group 사용합니다.

{
    "group" : "docker"
}

프록시 구성

프록시 정보를 docker searchdocker pull설정하고 설정하려면 이름 HTTP_PROXY 또는 HTTPS_PROXY프록시 정보의 값을 사용하여 Windows 환경 변수를 만듭니다. 다음과 유사한 명령을 사용하여 PowerShell을 사용하여 이 작업을 완료할 수 있습니다.

[Environment]::SetEnvironmentVariable("HTTP_PROXY", "http://username:password@proxy:port/", [EnvironmentVariableTarget]::Machine)

변수가 설정되면 Docker 서비스를 다시 시작합니다.

Restart-Service docker

자세한 내용은 Docker.com의 Windows 구성 파일을 참조하세요.

Docker를 제거하는 방법

이 섹션에서는 Docker를 제거하고 Windows 10 또는 Windows Server 2016 시스템에서 Docker 시스템 구성 요소의 전체 정리를 수행하는 방법을 설명합니다.

참고 항목

이러한 지침의 모든 명령은 권리자 권한 PowerShell 세션에서 실행해야 합니다.

Docker의 제거를 위해 시스템 준비

Docker를 제거하기 전에 시스템에서 실행 중인 컨테이너가 없는지 확인합니다.

다음 cmdlet을 실행하여 실행 중인 컨테이너를 확인합니다.

# Leave swarm mode (this will automatically stop and remove services and overlay networks)
docker swarm leave --force

# Stop all running containers
docker ps --quiet | ForEach-Object {docker stop $_}

Docker를 제거하기 전에 모든 컨테이너, 컨테이너 이미지, 네트워크 및 볼륨 또한 시스템에서 제거하는 것이 좋습니다. 다음 cmdlet을 실행하면 이 작업을 수행할 수 있습니다.

docker system prune --volumes --all

Docker 제거

이제 Docker를 실제로 제거해야 합니다.

Windows 10에서 Docker를 제거하려면:

Windows 10 머신에서 설정>앱으로 이동
앱 및 기능 아래에서 Windows용 Docker 찾기
Windows용 Docker>제거로 이동

Windows Server 2016에서 Docker를 제거하려면:

다음 예에 나와 있는 것처럼 권리자 권한 PowerShell 세션에서 Uninstall-Package 및 Uninstall-Module cmdlet을 사용하여 시스템에서 Docker 모듈 및 해당 패키지 관리 공급자를 제거합니다.

Uninstall-Package -Name docker -ProviderName DockerMsftProvider
Uninstall-Module -Name DockerMsftProvider

팁

PS C:\> Get-PackageProvider -Name *Docker*를 사용하여 Docker를 설치하는 데 사용한 패키지 공급자를 찾을 수 있습니다.

Docker 데이터 및 시스템 구성 요소 정리

Docker를 제거한 후 Docker의 기본 네트워크를 제거해야 Docker가 사라진 후에도 해당 구성이 시스템에 남아 있지 않습니다. 다음 cmdlet을 실행하면 이 작업을 수행할 수 있습니다.

Get-HNSNetwork | Remove-HNSNetwork

Windows Server 2016에서 Docker의 기본 네트워크를 제거하려면,

Get-ContainerNetwork | Remove-ContainerNetwork

다음 cmdlet을 실행하여 Docker의 프로그램 데이터를 시스템에서 제거:

Remove-Item "C:\ProgramData\Docker" -Recurse

Windows에서 Docker/컨테이너와 관련된 Windows 선택적 기능을 제거해야 하는 경우가 있을 수 있습니다.

여기에는 Docker를 설치할 때 모든 Windows 10 또는 Windows Server 2016에서 자동으로 활성화되는 "컨테이너" 기능이 포함됩니다. 또한 Docker가 설치될 때 Windows 10에서 자동으로 사용하도록 설정되지만 Windows Server 2016에서 명시적으로 사용하도록 설정해야 하는 "Hyper-V" 기능이 포함될 수도 있습니다.

Important

Hyper-V 기능은 단순히 컨테이너보다 더 많은 것을 활성화할 수 있는 일반적인 가상화 기능입니다. Hyper-V 기능을 비활성화하기 전에 Hyper-V가 필요한 다른 가상화 구성 요소는 없는지 확인합니다.

Windows 10에서 Windows 기능을 제거하려면:

제어판>프로그램>프로그램 및 기능>Windows 기능 설정 또는 해제로 이동합니다.
비활성화하려는 기능의 이름을 찾습니다. 이 경우 Containers 및 (선택 사항) Hyper-V입니다.
비활성화하려는 기능 이름 옆의 확인란 선택을 취소합니다.
"확인"을 선택합니다.

Windows Server 2016에서 Windows 기능을 제거하려면:

관리자 권한 PowerShell 세션에서 다음 명령을 실행하여 시스템에서 Containers 및 (선택 사항) Hyper-V 기능을 비활성화합니다.

Remove-WindowsFeature Containers
Remove-WindowsFeature Hyper-V

시스템 다시 부팅

제거 및 정리를 완료하려면 관리자 권한 PowerShell 세션에서 다음 cmdlet을 실행하여 시스템을 다시 부팅합니다.

Restart-Computer -Force

다음을 통해 공유

Windows의 Docker 엔진

Docker 설치

구성 파일을 사용하여 Docker 구성

Docker 서비스에서 Docker 구성

일반적인 구성

기본 네트워크 만들기

Docker 보안 그룹 설정

프록시 구성

Docker를 제거하는 방법

Docker의 제거를 위해 시스템 준비

Docker 제거

Docker 데이터 및 시스템 구성 요소 정리

시스템 다시 부팅

피드백

추가 리소스