컨테이너 도구 오류 메시지
이 문서에서는 Visual Studio 컨테이너 도구에서 사용하는 오류 코드를 나열하고 가능한 경우 문제 해결 방법을 제안합니다.
컨테이너 도구 오류 코드
| 코드 | 설명 | 참고 | 해결 |
|---|---|---|---|
| CTC1001 | Docker 볼륨 공유 사용 안 함 | 이 오류는 파일 공유를 사용하도록 설정하지 않은 경우에 발생합니다. 파일 공유는 Windows의 로컬 디렉터리를 Linux 컨테이너와 공유할 수 있도록 합니다. 이는 Hyper-V 모드를 사용하는 Linux 컨테이너에만 적용됩니다. 자세한 내용은 Windows용 Docker Desktop 사용자 설명서 또는 Docker 설명서를 참조하세요. | Docker 파일 공유를 사용하도록 설정합니다. |
| CTC1002 | Docker Desktop이 설치되어 있지 않음 | Docker Desktop을 설치합니다. | |
| CTC1003 | Docker Desktop이 실행 중이 아님 | Docker Desktop을 시작합니다. | |
| CTC1004 | Docker 서버 OS를 가져올 수 없음 | 프로젝트 파일에서 기본 targetOS를 지정합니다(예: <DockerDefaultTargetOS> Linux </DockerDefaultTargetOS>). |
|
| CTC1005 | Docker Desktop의 운영 체제 모드가 프로젝트의 대상 운영 체제와 일치하지 않음 | Docker Desktop 운영 체제 모드를 프로젝트의 대상 운영 체제와 일치하도록 전환합니다. | |
| CTC1006 | Docker Desktop이 실행 중이지만 오류 상태이며 다시 시작해야 합니다. | Docker Desktop을 다시 시작하고 Docker Desktop이 제대로 작동하는지 확인합니다. | |
| CTC1007 | vsdbg 다운로드에 실패했지만 디스크에 기존 복사본이 있음 |
단지 경고 메시지일 뿐이며 디버깅은 실패하지 않습니다. 이 경고는 최신 버전의 vsdbg 다운로드에 실패했지만 기존 복사본이 발견되어 사용 중일 때 발생합니다. |
사용자가 작업을 수행할 필요가 없습니다. |
| CTC1008 | vsdbg 다운로드에 실패했으며 디스크에 기존 복사본이 없음 |
F5 vsdbg.exe 다운로드에 실패했습니다. |
인터넷 연결을 확인하세요. |
| CTC1009 | 드라이브 공유 자격 증명이 잘못되었을 수 있음 | 이 문제는 Docker Desktop에서 사용되는 공유 드라이브 자격 증명이 만료된 경우에 발생할 수 있습니다. Docker Desktop 설정의 공유 드라이브 페이지에서 자격 증명을 다시 설정한 후 Docker를 다시 시작 하세요. | |
| CTC1010 | 현재 사용자가 docker-users 그룹에 없음 |
현재 사용자가 docker-users 그룹에 없습니다. 자신을 docker-users 그룹에 추가한 다음, 로그아웃한 후 Windows에 다시 로그인합니다. |
|
| CTC1011 | 포트가 사용되고 있음 | 컨테이너에서 이미 사용 중인 특정 호스트 포트를 사용하려고 합니다. | 이 포트를 사용하는 이전 컨테이너 또는 다른 애플리케이션을 중지하거나 다른 포트를 사용하도록 애플리케이션을 업데이트합니다. |
| CTC1012 | 사용되지 않음 | ||
| CTC1013 | 이 현재 형식이 지원되지 않음 또는 dotnet core 버전이 지원되지 않음 | ||
| CTC1014 | dockerFile을 빌드하는 중 오류 발생 | Dockerfile을 빌드할 수 없습니다. Dockerfile에서 오류를 수정하고 다시 시도하세요. | |
| CTC1019 | 사용 안 함 | ||
| CTC1020 | 컨테이너를 시작하는 동안 UnauthorizedAccessException이 throw됨 | ||
| CTC1021 | 컨테이너를 시작하는 동안 SecurityException이 throw됨 | ||
| CTC1022 | 사용 안 함 | ||
| CTC1023 | 파일 또는 디렉터리가 없습니다. | Dockerfile, docker 컨텍스트 또는 프로젝트 파일을 찾을 수 없습니다. | |
| CTC1024 | 컨테이너를 시작하는 동안 IOException이 throw됨 | ||
| CTC1025 | Docker 이미지를 풀하는 동안 오류가 발생했습니다. | docker pull 명령 실패 이유에 대한 자세한 오류는 출력 창을 참조하세요. |
|
| CTC1026 | 시작 설정 구문 분석 오류입니다. | launchSettings.json 파일에서 IISExpress 설정을 구문 분석하는 동안 IISExpress 설정 또는 구문 분석 오류를 찾을 수 없습니다. | launchSettings.json의 IISExpress 설정이 올바른지 확인합니다. |
| CTC1027 | dev-certs 도구를 실행하는 동안 오류가 발생했습니다. |
ASP.NET Core 개발 인증서를 신뢰하는 dev-certs 도구를 실행하는 동안 오류가 발생했습니다. |
자세한 오류는 출력 창을 참조하세요. |
| CTC1028 | 잘못된 시작 URL | 디버깅이 시작될 때 시작할 애플리케이션 URL이 잘못되었음 | launchSettings.json의 Docker 시작 설정에 지정된 launchUrl을 확인합니다. |
| CTC1029 | Docker 실행 실패 | 컨테이너 내에서 애플리케이션 프로세스를 시작하는 명령을 실행하는 동안 오류가 발생했습니다. | 자세한 오류는 출력 창을 참조하세요. |
| CTC1030 | 내부 오류 | 알 수 없는 내부 오류가 발생했습니다. | Visual Studio 피드백에서 버그를 여세요. |
| CTC1031 | 지원되지 않는 OS | Linux 컨테이너에서 .NET Framework 프로젝트를 사용할 가능성이 큽니다. Windows 컨테이너로 전환하고 다시 시도하세요. | |
| CTC1032 | 사용 안 함 | ||
| CTC1033 | 사용 안 함 | ||
| CTC1034 | 사용 안 함 | ||
| CTC1035 | Docker Desktop 다운로드 실패 | Docker Desktop을 설치하는 동안 Docker Desktop 설치 프로그램(.msi)을 다운로드할 수 없습니다. |
인터넷 연결을 확인하고 방화벽이 파일 다운로드를 차단하지 않는지 확인합니다. |
| CTC1036 | Docker Desktop 설치 실패 | 설치 프로그램에서 오류를 수정하고 Docker Desktop을 수동으로 설치합니다. 또는 솔루션을 다시 열면 Visual Studio에서 Docker Desktop을 다시 설치하려고 시도합니다. | |
| CTC1037 | Blazor 매니페스트 파일 액세스 오류 | Blazor 애플리케이션을 디버그할 때 Blazor 정적 웹 자산 파일을 다시 작성하지 못했습니다. | 자세한 오류는 출력 창을 참조하세요. |
| CTC1038 | 디버깅하는 동안 컨테이너가 없거나 실행되고 있지 않음 | 컨테이너를 시작하지 못한 이유에 대한 자세한 내용은 출력 창을 참조하세요. | |
| CTC1039 | 디버그할 프로그램의 이진을 컨테이너의 예상 위치에서 찾을 수 없습니다. | ||
| CTC1040 | 예기치 않은 종료 코드로 디버깅된 프로그램이 종료됨 | 애플리케이션 프로세스를 시작할 수 없습니다. 자세한 내용은 출력 창을 참조하세요. | |
| CTC1041 | Docker Desktop 설치가 완료되지 않았습니다. | Docker Desktop 설치가 완료되지 않은 것 같습니다. 다시 부팅해 보세요. 문제가 지속되면 Docker Desktop 설치를 복구해 보세요. |
Docker-compose 관련 오류 코드
| 코드 | 설명 | 참고 | 해결 |
|---|---|---|---|
| DTP1001 | 호스트 포트를 찾을 수 없음 | Docker Compose 프로젝트에서 서비스 URL은 토큰 {ServicePort}를 지정하지만 컨테이너에는 해당하는 호스트 포트가 없습니다. |
컨테이너가 올바른 URL 구성표(http 또는 https)에 대한 호스트 포트로 시작되었는지 확인합니다. |
| DTP1002 | 컨테이너 찾을 수 없음 | Docker Compose 프로젝트를 디버깅할 때 컨테이너가 시작되지 않았거나 컨테이너가 종료되었습니다. | 컨테이너를 시작하지 못한 이유에 대한 자세한 내용은 출력 창을 참조하세요. |
| DTP1003 | Docker Compose 프로젝트를 디버깅하는 동안 서비스를 찾을 수 없습니다. | Docker Compose 문서에 하나 이상의 dotnet 서비스가 정의되어 있는지 확인합니다. | |
| DTP1004 | Docker Compose 스캐폴딩 오류 | Docker Compose 지원을 다시 추가해 보세요. | |
| DT1001 | Docker Compose 명령을 실행하는 동안 오류가 발생하여 디버깅에 실패했습니다. | 이 오류에 대한 자세한 내용은 출력 창을 참조하세요. | |
| DT1002 | 대상 OS가 잘못되었음 | 알 수 없는 Dockerfile 대상 OS가 DockerDefaultTargetOS 속성에 지정되었습니다. |
지원되는 값은 ‘Windows’ 및 ‘Linux’입니다. |
| DT1003 | 명령을 실행하는 동안 예기치 않은 오류가 발생했습니다. | 이 오류에 대한 자세한 내용은 출력 창을 참조하세요. | |
| DT1004 | Docker Compose 파일 오류 | 모든 Docker Compose 문서를 확인하고 유효한지 확인합니다. | |
| DT1005 | Docker Compose 명령 실행 실패 | 이 오류에 대한 자세한 내용은 출력 창을 참조하세요. | |
| DT1006 | 활성 시작 프로필에 사용되는 작성 프로필 이름은 Docker Compose 문서에서 찾을 수 없습니다. | 예를 들어 활성 시작 프로필에서 다음과 같이 p2라는 구성 프로필을 사용하는 경우입니다."Docker Compose": {"commandName": "DockerCompose","commandVersion": "1.0","composeProfile": {"includes": [ "p2"]}}그러나 docker-compose.yml이 p2 프로필을 정의하지 않은 경우 이 오류가 표시됩니다. |
시작 프로필을 업데이트하여 올바른 작성 프로필을 사용하거나 Docker Compose 시작 설정 관리 대화 상자를 사용하여 시작 설정을 업데이트합니다. |
| DT1007 | 작성 프로필을 사용하는 활성 시작 프로필의 서비스 이름이 잘못되었습니다. | 예를 들어 활성 시작 프로필이 p1 작성 프로필을 사용하고 다음과 같이 p1 작성 프로필에 대한 서비스 목록을 정의하는 경우입니다."Docker Compose": {"commandName": "DockerCompose","commandVersion": "1.0","composeProfile": {"includes": ["p1"],"serviceActions": {"webapp2": "StartWithoutDebugging"}}}하지만 docker-compose.yml이 webapp2 서비스를 정의하지 않으면 이 오류가 표시됩니다. |
올바른 서비스 이름을 사용하도록 시작 프로필을 업데이트하거나 Docker Compose 시작 설정 관리 대화 상자를 사용하여 시작 설정을 업데이트합니다. |
| DT1008 | 작성 프로필을 사용하는 활성 시작 프로필의 서비스 작업이 잘못되었습니다. | 예를 들어 활성 시작 프로필이 p1 작성 프로필을 사용하고 서비스(webapplication)에 대해 잘못된 작업(wrongActionname)을 정의하는 경우입니다."Docker Compose": { "commandName": "DockerCompose","commandVersion": "1.0","composeProfile": {"includes": ["p1"],"serviceActions": {"webapp": "wrongActionname"}}} |
작성 프로필을 사용하는 서비스에 대한 유일한 유효 작업인 StartWithoutDebugging으로 서비스 작업을 수정합니다. |
| DT1009 | 활성 실행 프로필은 composeProfile 및 serviceActions를 모두 사용하고 있습니다. |
작성 프로필을 사용하거나 작성 프로필을 사용하지 않고 서비스 목록을 선택하여 Visual Studio 시작 프로필을 정의할 수 있습니다. 둘 다 사용하여 만들 수 없습니다. 따라서 활성 시작 프로필이 아래와 같이 둘 다 사용하는 경우 이 오류가 표시됩니다."Docker Compose": {"commandName": "DockerCompose","commandVersion": "1.0","composeProfile": {"includes": ["p1"]},"serviceActions": {"webapp": "StartWithoutDebugging"}} |
composeProfile 또는 serviceActions를 사용하거나 Docker Compose 시작 설정 관리 대화 상자를 사용하여 시작 설정을 업데이트합니다. |
| DT1010 | 활성 시작 프로필의 서비스 이름이 잘못되었음 | 예를 들어 활성 시작 프로필이 다음과 같이 serviceActions를 정의하는 경우입니다."Docker Compose": {"commandName": "DockerCompose","commandVersion": "1.0","serviceActions": {"redis1": "StartWithoutDebugging","webapp8": "StartWithoutDebugging"}}그러나 docker-compose.yml이 redis1 서비스를 정의하지 않은 경우 이 오류가 표시됩니다. |
올바른 서비스 이름을 사용하도록 시작 프로필을 업데이트하거나 Docker Compose 시작 설정 관리 대화 상자를 사용하여 시작 설정을 업데이트합니다. |
| DT1011 | 활성 시작 프로필의 서비스 작업이 잘못되었습니다. | 예를 들어 활성 시작 프로필이 아래와 같이 잘못된 서비스 작업(wrongAction)을 사용하는 경우 이 오류가 표시됩니다."Docker Compose": {"commandName": "DockerCompose","commandVersion": "1.0","serviceActions": {"webapplication8": "wrongAction"}} |
DoNotStart, StartDebugging 또는 StartWithoutDebugging 중 하나에 대해 서비스 작업을 수정합니다. 또는 Docker Compose 시작 설정 관리 대화 상자를 사용하여 시작 설정을 업데이트합니다. |
| DT1012 | 시작 프로필이 잘못되었습니다. composeProfile과 serviceActions가 모두 없습니다. |
작성 프로필을 사용하는 방식 또는 작성 프로필을 사용하지 않고 서비스 목록을 선택하는 방식으로 Visual Studio 시작 프로필을 정의할 수 있습니다. 그러나 활성 시작 프로필은 두 방식 중 어느 것으로도 정의되지 않습니다. | Docker Compose 시작 설정 관리 대화 상자를 사용하여 시작 설정을 업데이트합니다. |
| DT1013 | 활성 시작 프로필을 찾을 수 없음 | 활성 시작 프로필이 launchSettings.json에 정의되어 있는지 확인합니다. | |
| DT1014 | 프로필 버전이 잘못되었습니다. | 예를 들어 활성 시작 프로필이 알 수 없는 명령 버전(10.0)을 정의하는 경우입니다."Docker Compose":"commandName": "DockerCompose","commandVersion": "10.0","serviceActions": {"webapp8": "StartDebugging","redis": "StartWithoutDebugging"}} |
지원되는 commandVersion에 대한 오류 메시지를 참조하거나 Docker Compose 시작 설정 관리 대화 상자를 사용하여 시작 설정을 업데이트합니다. |
| DT1015 | 지원되지 않는 이전 프로필 버전입니다. | 프로필 버전은 현재 Visual Studio에서 더 이상 지원되지 않습니다. 시작 설정을 업데이트하려면 Docker Compose 시작 설정 관리 대화 상자를 사용하여 프로필을 지원되는 최신 버전으로 업그레이드하세요. | |
| DT1016 | 새 버전의 Visual Studio에서 프로필 사용 | 프로필 버전이 현재 지원되는 버전보다 높습니다. Visual Studio를 최신 버전으로 업그레이드하세요. | |
| DT1017 | 최신 버전의 Visual Studio에서 프로필을 사용하지만 계속 작동함 | 이것은 경고 메시지입니다. | 프로필 버전은 현재 지원되는 버전보다 높지만, 현재 버전의 Visual Studio와 호환되지만 일부 기능이 누락되었을 수 있습니다. |
| DT1018 | 이전 프로필 버전을 사용하지만 호환됩니다. | 이것은 경고 메시지입니다. | 프로필 버전이 최신 버전보다 낮지만 여전히 호환됩니다. 최신 기능 중 일부는 작동하지 않을 수 있습니다. 최신 버전의 Visual Studio로 업그레이드하는 것이 좋습니다. |
| DT1019 | 지원되지 않는 작성 v2 | 작성 프로필을 지원하지 않는 이전 버전의 Docker Compose v2를 사용하고 있습니다. | Docker Compose를 최신 버전으로 업그레이드합니다. |
단일 프로젝트 관련 오류 코드
| 코드 | 설명 | 참고 | 해결 |
|---|---|---|---|
| CTP1001 | 사용 안 함 | ||
| CTP1002 | 사용 안 함 | ||
| CTP1003 | 디버깅하는 동안 컨테이너가 없거나 실행되고 있지 않음 | 컨테이너를 시작하지 못한 이유에 대한 자세한 내용은 출력 창을 참조하세요. | |
| CTP1004 | Docker 스캐폴딩 오류 | Docker 지원을 다시 추가해 보세요. | |
| CTP1005 | 대상 OS가 잘못되었음 | 알 수 없는 Dockerfile 대상 OS가 DockerDefaultTargetOS 속성에 지정되었습니다. 지원되는 값은 ‘Windows’ 및 ‘Linux’입니다. |
|
| CTP1006 | 컨테이너 내에서 애플리케이션을 중지하지 못했습니다. | 단지 경고 메시지일 뿐입니다. | 애플리케이션이 사용되고 있지 않은지 확인합니다. |
| CTP1007 | 사용 안 함 | ||
| CTP1008 | 사용 안 함 | ||
| CTP1009 | Azure Functions CLI 다운로드 실패 | 자세한 내용은 출력 창을 참조하세요. |