DevOps 지식 허브
DevOps 지식 허브

단계별 가이드: Windows 및 macOS에 Docker Desktop 설치하기

Windows 및 macOS에 Docker Desktop을 설치하여 Docker를 시작하세요. 이 단계별 가이드는 두 운영 체제 모두에 대한 필수 구성 요소, 다운로드 지침, 설치 절차 및 초기 확인 단계를 다룹니다. 효율적인 컨테이너화를 위한 개발 환경 설정 방법을 알아보세요.

30 조회수

단계별 가이드: Windows 및 macOS에 Docker Desktop 설치

Docker는 개발자가 애플리케이션을 구축하고, 배포하고, 실행하는 방식을 혁신했습니다. 애플리케이션을 컨테이너화함으로써 Docker는 개발자의 랩톱에서부터 프로덕션 서버에 이르기까지 다양한 환경에서 일관성을 보장합니다. 많은 이들에게 컨테이너 세계로의 여정은 개인 장치에서 Docker를 실행하는 가장 쉬운 방법인 Docker Desktop을 설치하는 것으로 시작됩니다.

이 가이드는 Windows 및 macOS 모두에 Docker Desktop을 설치하기 위한 포괄적인 단계별 설명을 제공합니다. 필요한 선행 조건을 다루고, 처음부터 원활하고 성공적인 Docker 경험을 보장하기 위한 초기 설정 과정을 안내할 것입니다. Docker를 처음 사용하거나 다시 복습하려는 경우에도 이 가이드는 컨테이너화된 애플리케이션을 위한 개발 환경을 준비하는 데 필요한 지식을 제공할 것입니다.

Docker Desktop 이해하기

Docker Desktop은 Mac 및 Windows용 애플리케이션으로, 컨테이너화된 애플리케이션을 쉽게 구축하고 공유할 수 있도록 합니다. Docker Engine, Docker CLI 클라이언트, Docker Compose, Kubernetes 및 Docker Content Trust를 번들로 제공하여 단일 패키지로 완전한 개발 환경을 제공합니다.

Docker Desktop에 포함된 주요 구성 요소:

  • Docker Engine: 컨테이너를 실행하고 관리하는 기본 데몬입니다.
  • Docker CLI: Docker Engine과 상호 작용하는 데 사용되는 명령줄 인터페이스입니다.
  • Docker Compose: 다중 컨테이너 Docker 애플리케이션을 정의하고 실행하기 위한 도구입니다.
  • Kubernetes: 컨테이너화된 애플리케이션의 배포, 확장 및 관리를 자동화하는 오픈 소스 시스템입니다.

설치 전 준비사항

설치 프로세스를 시작하기 전에 시스템이 다음 요구 사항을 충족하는지 확인하십시오. 이러한 선행 조건을 충족하면 설치 중 및 설치 후 발생할 수 있는 잠재적인 문제를 방지할 수 있습니다.

Windows의 경우:

  • 운영 체제: Windows 10 64비트: Pro, Enterprise 또는 Education (빌드 19041 이상). Windows 11 64비트: Pro, Enterprise 또는 Education (빌드 22000 이상).
  • 하드웨어 가상화: BIOS에서 활성화되어야 합니다. 대부분의 최신 컴퓨터에서는 기본적으로 활성화되어 있습니다. 작업 관리자를 열고 '성능' 탭으로 이동한 다음 CPU 섹션에서 '가상화'를 찾아 '사용'으로 표시되는지 확인하여 확인할 수 있습니다.
  • WSL 2 설치 (권장): 최적의 성능을 위해 Windows용 Docker Desktop은 Windows Subsystem for Linux 2 (WSL 2)를 사용합니다. 설치되어 있지 않다면 Docker Desktop이 설치 과정을 안내할 것입니다. 관리자 권한으로 실행된 PowerShell 또는 명령 프롬프트에서 wsl --install을 실행하여 WSL 2가 설치되었는지 확인하십시오. 더 자세한 지침은 Microsoft의 공식 WSL 문서를 참조하십시오.
  • 최소 시스템 리소스:
    • 4GB RAM
    • SLAT(Second Level Address Translation)를 지원하는 64비트 프로세서
  • 참고: Docker Desktop은 Windows Server 버전을 지원하지 않습니다.

macOS의 경우:

  • 운영 체제: macOS 11 (Big Sur) 이상.
  • 하드웨어:
    • Apple 칩(M1 이상) 또는 64비트 프로세서를 탑재한 Intel 칩 Mac.
    • 최소 4GB RAM (8GB 이상 권장).
  • 브라우저: 애플리케이션 다운로드를 위한 브라우저.

Windows에 Docker Desktop 설치

Windows 컴퓨터에 Docker Desktop을 설치하려면 다음 단계를 따르십시오.

  1. Docker Desktop 다운로드:
    Docker 공식 웹사이트로 이동하여 Windows용 Docker Desktop 설치 프로그램을 다운로드하십시오. 일반적으로 '제품' > 'Docker Desktop' 섹션에서 찾을 수 있습니다.

  2. 설치 프로그램 실행:
    다운로드가 완료되면 .exe 파일을 찾아 두 번 클릭하여 설치 마법사를 시작하십시오.

  3. 구성 옵션:
    설치 중 구성 옵션이 표시됩니다. 다음 사항을 확인하십시오:

    • "WSL 2에 필요한 Windows 구성 요소 설치"가 선택되어 있는지 확인하십시오 (아직 설치되지 않은 경우).
    • "Hyper-V 대신 WSL 2 사용 (권장)"이 선택되어 있는지 확인하십시오.

    Docker Desktop Installation Options Windows 설치 옵션 예시 이미지

  4. 설치 완료:
    '확인' 또는 '다음'을 클릭하여 진행하십시오. 설치 프로그램이 필요한 구성 요소를 다운로드하고 설치합니다. 이 과정은 몇 분 정도 소요될 수 있습니다.

  5. 컴퓨터 재시작:
    설치가 완료되면 설정을 마무리하기 위해 컴퓨터를 닫고 다시 시작하라는 메시지가 표시됩니다.

  6. Docker Desktop 실행:
    컴퓨터가 다시 시작되면 Docker Desktop이 자동으로 실행되어야 합니다. 그렇지 않은 경우 시작 메뉴에서 찾아 실행하십시오. 처음 실행 시 이용 약관에 동의해야 할 수 있습니다.

macOS에 Docker Desktop 설치

macOS에 Docker Desktop을 설치하는 것은 간단합니다. 다음 단계를 따르십시오:

  1. Docker Desktop 다운로드:
    Docker 공식 웹사이트로 이동하여 Mac용 Docker Desktop 설치 프로그램을 다운로드하십시오. 일반적으로 Apple 칩(M1, M2 등)용과 Intel 칩용 두 가지 버전을 찾을 수 있습니다.

  2. 다운로드한 파일 열기:
    다운로드가 완료되면 .dmg 파일을 여십시오.

  3. 응용 프로그램 폴더로 드래그:
    나타나는 대화 상자에서 Docker 아이콘을 응용 프로그램(Applications) 폴더로 드래그하십시오. 이렇게 하면 Docker Desktop이 시스템에 복사됩니다.

  4. Docker Desktop 실행:
    응용 프로그램(Applications) 폴더로 이동하여 Docker 아이콘을 두 번 클릭하여 애플리케이션을 실행하십시오. Docker에 권한을 부여하라는 메시지가 표시될 수 있습니다.

  5. 이용 약관 동의:
    처음 실행 시 Docker의 이용 약관에 동의해야 할 것입니다.

  6. 권한 부여 (요청 시):
    Docker Desktop은 네트워킹 및 기타 시스템 수준 기능을 관리하기 위해 더 높은 권한을 요구할 수 있습니다. macOS 사용자 암호를 입력하라는 메시지가 표시될 것입니다.

초기 설정 및 확인

Docker Desktop이 설치되고 실행되면 설치를 확인하고 몇 가지 기본 설정을 수행하는 것이 좋습니다.

설치 확인

설치를 확인하는 가장 쉬운 방법은 터미널 또는 명령 프롬프트에서 간단한 Docker 명령을 실행하는 것입니다.

  1. 터미널 열기:

    • Windows: PowerShell 또는 명령 프롬프트를 엽니다.
    • macOS: 터미널 애플리케이션을 엽니다 (응용 프로그램 > 유틸리티 > 터미널).

  2. docker version 명령 실행:
    다음 명령을 입력하고 Enter 키를 누르십시오:
    bash docker version

    Docker가 올바르게 설치되었다면, Docker 클라이언트와 서버에 대한 정보를 표시하는 다음과 유사한 출력을 볼 수 있습니다:

    ```
    Client: Docker Engine - Community
    Version: 24.0.5
    API version: 1.43
    Go version: go1.19.12
    Git commit: ced0996
    Built: Fri Jul 21 20:35:45 2023
    OS/Arch: linux/amd64
    Context: default
    Experimental: true

    Server: Docker Engine - Community
    Engine:
    Version: 24.0.5
    API version: 1.43 (minimum version 1.12)
    Go version: go1.19.12
    Git commit: a61e2b4
    Built: Fri Jul 21 20:35:45 2023
    OS/Arch: linux/amd64
    Experimental: false
    ...
    ```

  3. 테스트 컨테이너 실행:
    더 자세히 확인하려면 간단한 "hello-world" 컨테이너를 실행해 보십시오:
    bash docker run hello-world

    이 명령은 작은 테스트 이미지를 다운로드하고 실행합니다. 성공하면 Docker 설치가 올바르게 작동하는 것으로 보이는 메시지가 표시될 것입니다.

Docker Desktop 설정

Docker Desktop은 Docker 환경을 관리하기 위한 그래픽 인터페이스를 제공합니다. 시스템 트레이(Windows) 또는 메뉴 바(macOS)에 있는 Docker 고래 아이콘을 클릭하고 '설정' 또는 '환경설정'을 선택하여 설정에 접근할 수 있습니다.

탐색할 주요 설정:

  • 일반: 로그인 시 Docker 시작 및 WSL 2 백엔드 사용 옵션.
  • 리소스: Docker에 할당되는 CPU, 메모리, 디스크 이미지 크기를 구성합니다.
  • Docker Engine: Docker 데몬 구성을 수정합니다.
  • Kubernetes: 로컬 개발을 위한 단일 노드 Kubernetes 클러스터를 활성화하고 관리합니다.

일반적인 문제 해결

  • 가상화 비활성화: Docker가 시작되지 않으면 BIOS/UEFI 설정에서 하드웨어 가상화가 활성화되어 있는지 확인하십시오. 정확한 단계는 메인보드 제조업체에 따라 다릅니다.
  • WSL 2 문제 (Windows): WSL 2에 문제가 발생하면 관리자 권한으로 PowerShell에서 wsl --update를 실행해 보십시오. Windows가 최신 상태인지 확인하십시오.
  • 방화벽/백신 소프트웨어 간섭: 때때로 강력한 방화벽 또는 백신 소프트웨어가 Docker의 네트워크 작업을 차단할 수 있습니다. 일시적으로 비활성화(주의 필요)하여 원인인지 진단하는 데 도움이 될 수 있습니다.
  • 오래된 Docker 버전: 항상 Docker Desktop의 최신 안정 버전을 실행하고 있는지 확인하십시오. 애플리케이션 내에서 업데이트를 확인하십시오.

결론

Windows 및 macOS에 Docker Desktop을 설치하는 것은 개발 워크플로우를 위해 컨테이너화의 힘을 활용하는 첫 번째 중요 단계입니다. 이 가이드를 따르면 이제 컨테이너화된 애플리케이션을 구축, 실행 및 관리할 준비가 된 작동하는 Docker 환경을 갖게 될 것입니다. 생산성을 극대화하려면 Docker Desktop 설정을 탐색하고 기본적인 Docker 명령에 익숙해지는 것을 잊지 마십시오.

이제 Docker가 설치되었으므로 Docker Hub에서 이미지를 가져오고, 자신만의 이미지를 구축하며, 컨테이너에서 애플리케이션을 실행할 수 있습니다!