윈도우 11에서 Docker 환경으로 개발하기: Cursor 및 Visual Studio 설정 매뉴얼

Docker

dma-ai 2025. 6. 23. 21:53

728x90

윈도우 11에서 Docker를 활용한 개발환경을 구축하고, Cursor(혹은 VS Code)와 Visual Studio에서 효율적으로 개발을 진행할 수 있도록 단계별로 자세히 설명합니다.

1. Docker Desktop 설치 및 환경 준비

WSL2 활성화
- Windows PowerShell(관리자 권한)에서 다음 명령어를 실행합니다.
- text
  
  wsl --install wsl --set-default-version 2
- 설치 및 활성화가 완료되면 PC를 재부팅합니다1 23.
Docker Desktop 설치
- 공식 홈페이지에서 Docker Desktop for Windows를 다운로드하여 설치합니다.
- 설치 중 "WSL2 기반 설치" 옵션을 선택합니다(권장)4 25.
- 설치 완료 후 Docker Desktop을 실행하고, 약관 동의 및 기본 설정을 마칩니다.
가상화(Virtualization) 활성화
- BIOS 설정에서 CPU 가상화(SVM, VT-x 등)를 활성화해야 합니다5.
- 설정 방법은 메인보드 및 CPU 제조사에 따라 다르니, 공식 문서를 참고하세요.

Docker Extension 설치
- Cursor 또는 VS Code의 Extensions(확장 프로그램)에서 "Docker"를 검색하여 설치합니다.
WSL2 연동
- "Remote - WSL" 확장도 함께 설치하면, WSL2 환경에서 직접 개발이 가능합니다.
Docker Compose, 컨테이너 관리
- 좌측 Activity Bar에서 Docker 아이콘을 클릭하면 컨테이너, 이미지, 볼륨 등을 GUI로 관리할 수 있습니다.
- .devcontainer 폴더와 devcontainer.json 파일을 프로젝트 루트에 생성하여 개발환경을 코드로 정의할 수 있습니다.
예시: devcontainer.json
json

{ "name": "My Dev Container", "image": "python:3.10", "extensions": [ "ms-python.python" ], "settings": { "terminal.integrated.shell.linux": "/bin/bash" } }

Docker 지원 추가
- 솔루션 탐색기에서 프로젝트를 우클릭 → [추가] → [Docker 지원] 선택6.
- 대상 OS(Linux/Windows) 선택(대부분 Linux 권장) 후 확인을 누릅니다.
- 자동으로 Dockerfile이 생성되고, 필요 이미지가 다운로드됩니다.
컨테이너 실행 및 디버깅
- 실행 환경을 "Docker"로 지정하고(F5 또는 Docker 실행 버튼), 컨테이너 내에서 앱을 빌드/실행/디버깅할 수 있습니다.
- Docker Desktop 대시보드에서 컨테이너 상태를 실시간으로 확인할 수 있습니다6.

728x90