WSL에서의 원격 개발

Name: Visual Studio Code
Author: Microsoft

이 튜토리얼에서는 Linux용 Windows 하위 시스템(WSL)을 활성화하고 WSL 확장을 사용하여 WSL에서 Visual Studio Code를 실행하는 방법을 안내합니다.

전제 조건

Visual Studio Code가 설치되어 있어야 합니다.

확장 설치

WSL 확장을 사용하면 Linux용 Windows 하위 시스템(WSL) 내에서 Visual Studio Code를 실행할 수 있습니다.

WSL 확장 설치

WSL extension

필수 구성 요소 확인

WSL 확장이 설치되면 맨 왼쪽에 새로운 상태 표시줄 항목이 표시됩니다.

Remote Status bar item

원격 상태 표시줄 항목을 통해 VS Code가 어떤 컨텍스트(로컬 또는 원격)에서 실행되고 있는지 빠르게 확인할 수 있으며, 이 항목을 클릭하면 WSL 확장 명령이 표시됩니다.

WSL extension commands

WSL 활성화

Linux용 Windows 하위 시스템(WSL)은 Windows 10의 선택적 기능입니다. Windows 기능 대화 상자 또는 PowerShell을 통해 활성화할 수 있습니다.

Windows 기능 대화 상자

Windows 검색창에 '기능'을 입력하여 **Windows 기능 켜기/끄기** 대화 상자를 엽니다. 아래로 스크롤하여 **Linux용 Windows 하위 시스템**을 선택합니다.

Turn Windows features on and off dialog

**확인**을 선택하면 Windows를 다시 시작하라는 메시지가 표시됩니다.

PowerShell

선택적으로 관리자 권한으로 PowerShell을 열고 다음을 입력할 수 있습니다.

Enable-WindowsOptionalFeature -Online -FeatureName Microsoft-Windows-Subsystem-Linux

명령이 실행된 후 Windows를 다시 시작하라는 메시지가 표시됩니다.

PowerShell prompt to restart

WSL 확인

Windows를 다시 시작한 후 명령 프롬프트를 열고 'wsl'을 입력하여 WSL이 활성화되었는지 확인할 수 있습니다.

WSL check

WSL이 활성화되었지만 아직 Linux 배포판을 설치하지 않았습니다.

Linux 배포판 설치

Microsoft Store에서 WSL용 Linux 배포판을 설치합니다. 스토어 앱을 사용하거나 Windows 검색창에서 Linux 배포판을 검색할 수 있습니다. 설치하려는 Linux 배포판(예: Ubuntu)을 선택하고 지침을 따릅니다.

select Ubuntu distro

**설치**를 선택합니다.

install Ubuntu

완료되면 **시작**을 선택하여 시작합니다. 그러면 Linux 터미널이 열리고 설치가 완료됩니다. 전체 Linux 인스턴스를 설정하는 것이므로 사용자 ID와 비밀번호를 만들어야 합니다. 이제 Windows에서 Linux를 실행하고 있습니다.

Linux terminal

Python 개발

Python이 아직 설치되어 있지 않은 경우 다음 명령을 실행하여 Linux 설치에 Python3와 Python 패키지 관리자인 pip를 설치합니다.

sudo apt update
sudo apt install python3 python3-pip

확인하려면 다음을 실행합니다.

python3 --version

표준 "Hello World" 앱으로 시작합니다. "helloWorld"라는 새 폴더를 만든 다음 실행 시 메시지를 출력할 Python 파일을 추가합니다.

mkdir helloWorld && cd helloWorld
echo 'print("hello from python on ubuntu on windows!")' >> hello.py
python3 hello.py

원격 Linux 환경(이 WSL 배포판은 기술적으로 UI가 없는 별도의 머신으로, 컴퓨터에서 로컬로 실행됨)에서는 개발 도구 및 환경이 상당히 제한적입니다. 파일 편집을 위해 터미널에서 Vim을 실행하거나 \\wsl$ 마운트를 통해 Windows 측의 소스를 편집할 수 있습니다.

$\wsl$ mount$

이 모델의 문제는 Python 런타임, pip 또는 conda 패키지가 Windows에 설치되어 있지 않다는 것입니다.

no Python on Windows

Python은 Linux 배포판에 설치되어 있다는 점을 기억하세요. 즉, Windows 측에서 Python 파일을 편집하는 경우 Windows에 동일한 Python 개발 스택을 설치하지 않으면 실행하거나 디버그할 수 없습니다. 이는 모든 Python 도구와 런타임이 설치된 격리된 Linux 인스턴스를 설정하는 목적에 어긋납니다!

WSL에서 실행

WSL 터미널에서 helloWorld 폴더에 있는지 확인하고 'code .'를 입력하여 Visual Studio Code를 실행합니다. '.' 인수는 VS Code에 현재 폴더를 열도록 지시합니다. VS Code의 Insiders 버전을 사용하는 경우 대신 'code-insiders .'를 실행해야 합니다.

참고: 이 명령이 작동하지 않으면 터미널을 다시 시작하거나 설치 시 VS Code를 경로에 추가하지 않았을 수 있습니다.

launch VS Code

가장 먼저 "VS Code Server 설치 중"이라는 메시지가 표시됩니다(c7d83e57… 숫자는 방금 설치한 클라이언트 측 도구와 일치하는 VS Code Server 버전입니다). VS Code는 Linux 측에 작은 서버를 설치하며, 데스크톱 VS Code는 이 서버와 통신하게 됩니다. 이 서버는 WSL에 확장을 설치하고 호스트하므로, WSL에 설치된 도구 및 프레임워크의 컨텍스트에서 실행됩니다. 즉, 언어 확장은 올바른 개발 환경을 위해 Windows 측에 설치된 것이 아니라 WSL에 설치된 도구 및 프레임워크를 대상으로 실행됩니다.

다음으로 VS Code가 시작되고 helloWorld 폴더가 열립니다. VS Code가 WSL에 연결 중임을 알리는 빠른 알림이 표시될 수 있으며, Node.js 기반 서버에 대한 액세스를 허용하라는 메시지가 표시될 수 있습니다.

installing vscode server