컨테이너화된 앱 디버깅

Container Tools 확장은 컨테이너 내에서 실행되는 애플리케이션에 디버거를 연결하기 위한 launch.json 구성을 스캐폴딩하는 등 컨테이너 내 애플리케이션 디버깅에 대한 추가 지원을 제공합니다.

Container Tools 확장은 VS Code가 애플리케이션을 시작하거나 실행 중인 컨테이너의 애플리케이션에 디버거를 연결하는 방법을 관리하는 docker 디버그 구성 공급자를 제공합니다. 이 공급자는 launch.json 내의 항목을 통해 구성되며, 구성은 공급자가 지원하는 각 애플리케이션 플랫폼에 특화됩니다.

Container Tools 확장은 현재 컨테이너 내에서 Node.js, Python 및 .NET 애플리케이션 디버깅을 지원합니다.

요구 사항

launch.json에 launch 구성을 스캐폴딩하거나 붙여넣는 것만으로는 컨테이너를 빌드하고 디버깅하기에 **충분하지 않습니다**. 컨테이너 launch 구성을 성공적으로 실행하려면 다음이 필요합니다.

• Dockerfile.
• tasks.json에 docker-build 및 docker-run 작업.
• 이러한 작업을 호출하는 launch 구성.

이러한 자산이 아직 존재하지 않는 경우 **Containers: Add Docker Files to Workspace...** 명령을 사용하여 이러한 항목을 만드는 것이 좋습니다. 이미 작동하는 Dockerfile이 있는 경우 **Containers: Initialize for container debugging** 명령을 사용하여 launch 구성 및 컨테이너 관련 작업을 스캐폴딩하는 것이 좋습니다.

Node.js

컨테이너 내 Node.js 애플리케이션 디버깅에 대한 자세한 내용은 컨테이너 내 Node.js 디버깅에서 확인할 수 있습니다.

Node.js 애플리케이션 디버깅을 위한 예제 launch.json 구성

{
  "configurations": [
    {
      "name": "Containers: Node.js Launch",
      "type": "docker",
      "request": "launch",
      "preLaunchTask": "docker-run: debug",
      "platform": "node"
    }
  ]
}

Python

컨테이너 내 Python 애플리케이션 디버깅에 대한 자세한 내용은 컨테이너 내 Python 디버깅에서 확인할 수 있습니다.

Python 애플리케이션 디버깅을 위한 예제 launch.json 구성

{
  "configurations": [
    {
      "name": "Containers: Python - Django",
      "type": "docker",
      "request": "launch",
      "preLaunchTask": "docker-run: debug",
      "python": {
        "pathMappings": [
          {
            "localRoot": "${workspaceFolder}",
            "remoteRoot": "/app"
          }
        ],
        "projectType": "django"
      }
    }
  ]
}

.NET

컨테이너 내에서 프로젝트를 빌드하고 디버깅하는 두 가지 방법 중에서 선택할 수 있습니다.

• .NET SDK 사용: MSBuild에 익숙하거나 Dockerfile 없이 프로젝트를 컨테이너화하려는 경우 이 옵션을 권장합니다.

  참고: 이 옵션은 .NET SDK 7 이상에서만 사용할 수 있으며 이미지를 빌드하기 위해 dotnet publish 명령을 사용합니다.

• Dockerfile 사용: Dockerfile을 사용하여 프로젝트를 사용자 정의하려는 경우 이 옵션을 선택합니다.

이 두 가지 옵션에 대한 자세한 내용은 컨테이너 내 .NET 디버깅을 참조하십시오.

Dockerfile을 사용하여 .NET 애플리케이션을 디버깅하기 위한 예제 launch.json 구성

{
  "version": "0.2.0",
  "configurations": [
    {
      "name": "Containers: .NET Launch",
      "type": "docker",
      "request": "launch",
      "preLaunchTask": "Run Container",
      "netCore": {
        "appProject": "${workspaceFolder}/project.csproj"
      }
    }
  ]
}

구성 참조

dockerServerReadyAction 객체 속성

node 객체 속성

이 속성은 Node.js 애플리케이션에 디버거를 연결하기 위한 VS Code 설명서의 속성과 동일합니다. node 객체에서 전달된 모든 속성은 명시적으로 나열되지 않더라도 Node.js 디버그 어댑터로 전달됩니다.

python 객체 속성

netCore 객체 속성

netCore 객체에서 전달된 속성은 명시적으로 나열되지 않더라도 일반적으로 .NET 디버그 어댑터로 전달됩니다. 디버거 속성의 전체 목록은 OmniSharp VS Code 확장 설명서에 있습니다.

다음 단계

더 자세히 알아보려면 다음을 읽어보십시오.

• 컨테이너 내 Node.js 디버깅
• 컨테이너 내 Python 디버깅
• 컨테이너 내 .NET 디버깅
• Docker Compose로 디버깅
• 문제 해결