Fehlermeldungen bei Containertools

In diesem Artikel werden die Fehlercodes aufgeführt, die von Visual Studio-Containertools verwendet werden, und ggf. Vorschläge zum Beheben der Probleme bereitgestellt.

Fehlercodes bei Containertools

Code BESCHREIBUNG Hinweise Fix
CTC1001 Die Freigabe von Docker-Volumes ist nicht aktiviert. Dieser Fehler tritt auf, wenn die Dateifreigabe nicht aktiviert ist. Die Dateifreigabe ermöglicht die Freigabe lokaler Verzeichnisse unter Windows für Linux-Container. Dies gilt nur für Linux-Container, die den Hyper-V-Modus verwenden. Weitere Einzelheiten finden Sie im Handbuch zu Docker Desktop für Windows oder in der Docker-Dokumentation. Aktivieren Sie die Docker-Dateifreigabe.
CTC1002 Docker Desktop ist nicht installiert. Installieren Sie Docker Desktop.
CTC1003 Docker Desktop wird nicht ausgeführt. Starten Sie Docker Desktop.
CTC1004 Fehler beim Abrufen des Docker-Serverbetriebssystems Geben Sie den Standardwert für targetOS in der Projektdatei an (z. B. <DockerDefaultTargetOS> Linux </DockerDefaultTargetOS>).
CTC1005 Der Betriebssystemmodus von Docker Desktop entspricht nicht dem Zielbetriebssystem des Projekts. Ändern Sie den Betriebssystemmodus von Docker Desktop, damit er dem Zielbetriebssystem des Projekts entspricht.
CTC1006 Docker Desktop wird ausgeführt, befindet sich aber in einem Fehlerzustand und sollte neu gestartet werden. Starten Sie Docker Desktop neu, und stellen Sie sicher, dass Docker Desktop ordnungsgemäß funktioniert.
CTC1007 Fehler beim Herunterladen von vsdbg, es wurde aber eine vorhandene Kopie auf dem Datenträger gefunden. Dies ist nur eine Warnung, und beim Debuggen tritt kein Fehler auf. Diese Warnung wird ausgegeben, wenn die neueste Version von vsdbg nicht heruntergeladen werden kann, aber eine vorhandene Kopie gefunden wurde, die verwendet werden kann. Die Benutzer*innen müssen keine Maßnahmen ergreifen.
CTC1008 Fehler beim Herunterladen von vsdbg, und es wurde keine vorhandene Kopie auf dem Datenträger gefunden. vsdbg.exe konnte nicht mit F5 heruntergeladen werden. Überprüfen Sie Ihre Internetverbindung.
CTC1009 Die Anmeldeinformationen für die Laufwerkfreigabe sind möglicherweise ungültig. Dies kann daran liegen, dass die von Docker Desktop verwendeten Anmeldeinformationen für freigegebene Laufwerke veraltet sind. Versuchen Sie, die Anmeldeinformationen auf der Seite Freigegebene Laufwerke der Docker Desktop-Einstellungen zurückzusetzen und dann Docker neu zu starten.
CTC1010 Der aktuelle Benutzer befindet sich nicht in der Gruppe docker-users. Der aktuelle Benutzer befindet sich nicht in der Gruppe docker-users. Fügen Sie sich selbst der Gruppe docker-users hinzu, und melden Sie sich dann bei Windows ab und wieder an.
CTC1011 Ports in Verwendung Ein Container versucht, einen bestimmten Hostport zu verwenden, der bereits verwendet wird. Beenden Sie den vorherigen Container oder die andere Anwendung, der oder die diesen Port verwendet, oder aktualisieren Sie die Anwendung, um einen anderen Port zu verwenden.
CTC1012 Nicht verwendet
CTC1013 Dieser aktuelle Typ oder die dotnet-core-Version wird nicht unterstützt.
CTC1014 Fehler beim Erstellen des Dockerfiles Das Dockerfile kann nicht erstellt werden. Korrigieren Sie den Fehler im Dockerfile, und versuchen Sie es erneut.
CTC1019 Nicht verwendet
CTC1020 UnauthorizedAccessException ausgelöst beim Versuch, den Container zu starten
CTC1021 SecurityException ausgelöst beim Versuch, den Container zu starten
CTC1022 Nicht verwendet
CTC1023 Datei oder Verzeichnis nicht gefunden. Dies könnte entweder ein Dockerfile, der Docker-Kontext oder eine Projektdatei sein.
CTC1024 IOException ausgelöst beim Versuch, den Container zu starten
CTC1025 Fehler beim Versuch, ein Docker-Image zu pullen. Im Ausgabefenster finden Sie detailliertere Informationen zum Fehler und zum Grund, warum docker pull den Fehler verursacht hat.
CTC1026 Analysefehler bei Starteinstellungen. Die IISExpress-Einstellungen konnten nicht in der Datei launchSettings.json gefunden oder analysiert werden. Stellen Sie sicher, dass die IISExpress-Einstellungen in der Datei launchSettings.json gültig sind.
CTC1027 Fehler beim Ausführen des Tools dev-certs. Beim Ausführen des Tools dev-certs, um das ASP.NET Core-Entwicklungszertifikat als vertrauenswürdig einzustufen, ist ein Fehler aufgetreten. Ausführlichere Fehlerinformationen finden Sie im Ausgabefenster.
CTC1028 Ungültige Start-URL Die Anwendungs-URL, die beim Beginn des Debuggens gestartet wird, ist ungültig. Stellen Sie sicher, dass die launchUrl in den Docker-Starteinstellungen in launchSettings.json angegeben ist.
CTC1029 Fehler bei der Docker-Ausführung Beim Versuch, einen Befehl auszuführen, um den Anwendungsprozess innerhalb des Containers zu starten, ist ein Fehler aufgetreten. Ausführlichere Fehlerinformationen finden Sie im Ausgabefenster.
CTC1030 Interner Fehler. Es ist ein unbekannter interner Fehler aufgetreten. Öffnen Sie einen Fehler in Visual Studio-Feedback.
CTC1031 Nicht unterstütztes Betriebssystem Wahrscheinlich wird das .NET Framework-Projekt in einem Linux-Container verwendet. Wechseln Sie zu einem Windows-Container, und versuchen Sie es erneut.
CTC1032 Nicht verwendet
CTC1033 Nicht verwendet
CTC1034 Nicht verwendet
CTC1035 Fehler beim Docker Desktop-Download Das Installationsprogramm für Docker Desktop (.msi) kann nicht heruntergeladen werden, um Docker Desktop zu installieren. Überprüfen Sie Ihre Internetverbindung, und ob eine Firewall den Dateidownload blockiert.
CTC1036 Fehler bei der Installation von Docker Desktop Korrigieren Sie den Fehler im Installationsprogramm, und installieren Sie Docker Desktop manuell. Sie können die Projektmappe auch erneut öffnen, damit Visual Studio noch einmal versuchen kann, Docker Desktop zu installieren.
CTC1037 Fehler beim Zugriff auf die Blazor-Manifestdatei Fehler beim erneuten Schreiben der statischen Blazor-Webressourcendatei beim Debuggen der Blazor-Anwendung Ausführlichere Fehlerinformationen finden Sie im Ausgabefenster.
CTC1038 Der Container ist nicht vorhanden oder wird zum Zeitpunkt des Debuggens nicht ausgeführt. Weitere Details dazu, warum der Container nicht gestartet wurde, finden Sie im Ausgabefenster.
CTC1039 Die Binärdateien des zu debuggenden Programms wurden nicht an der erwarteten Position im Container gefunden.
CTC1040 Das zu debuggende Programm wurde mit einem unerwarteten Exitcode beendet. Der Anwendungsprozess kann nicht gestartet werden. Weitere Informationen finden Sie im Ausgabefenster.
CTC1041 Unvollständige Docker Desktop-Installation. Die Installation von Docker Desktop wurde anscheinend nicht abgeschlossen. Versuchen Sie einen Neustart. Wenn das Problem weiterhin besteht, versuchen Sie, Ihre Docker Desktop-Installation zu reparieren.

Docker Compose-spezifische Fehlercodes

Code BESCHREIBUNG Hinweise Fix
DTP1001 Hostport nicht gefunden Im Docker Compose-Projekt gibt die Dienst-URL das Token {ServicePort} an, aber der Container verfügt über keinen entsprechenden Hostport. Stellen Sie sicher, dass der Container mit einem Hostport für das richtige URL-Schema (http oder https) gestartet wird.
DTP1002 Container wurde nicht gefunden. Beim Debuggen des Docker Compose-Projekts wurde der Container nicht gestartet oder beendet. Weitere Details dazu, warum der Container nicht gestartet wurde, finden Sie im Ausgabefenster.
DTP1003 Beim Debuggen des Docker Compose-Projekts wurde kein Dienst gefunden. Stellen Sie sicher, dass im Docker Compose-Dokument mindestens ein dotnet-Dienst definiert ist.
DTP1004 Fehler beim Gerüstbau für Docker Compose Versuchen Sie, die Docker Compose-Unterstützung erneut hinzuzufügen.
DT1001 Fehler beim Debuggen aufgrund eines Fehlers beim Ausführen eines Docker Compose-Befehls Ausführlichere Informationen zu diesem Fehler finden Sie im Ausgabefenster.
DT1002 Ungültiges Zielbetriebssystem Unbekanntes Zielbetriebssystem für Dockerfile in der DockerDefaultTargetOS-Eigenschaft Unterstützte Werte sind „Windows“ und „Linux“.
DT1003 Unerwarteter Fehler beim Ausführen eines Befehls Ausführlichere Informationen zu diesem Fehler finden Sie im Ausgabefenster.
DT1004 Fehler in Docker Compose-Datei Überprüfen Sie alle Docker Compose-Dokumente, und stellen Sie sicher, dass sie gültig sind.
DT1005 Fehler bei der Ausführung eines Docker Compose-Befehls Ausführlichere Informationen zu diesem Fehler finden Sie im Ausgabefenster.
DT1006 Der im aktiven Startprofil verwendete Compose-Profilname wurde im Docker Compose-Dokument nicht gefunden. Wenn das aktive Startprofil z. B. das Compose-Profil p2 verwendet, wie hier gezeigt:

"Docker Compose": {
  "commandName": "DockerCompose",
  "commandVersion": "1.0",
  "composeProfile": {
    "includes": [
        "p2"
    ]
  }
}

aber das Profil p2 in docker-compose.yml nicht definiert ist, wird dieser Fehler angezeigt.
Aktualisieren Sie das Startprofil, damit das richtige Compose-Profil verwendet wird, oder verwenden Sie das Dialogfeld Docker Compose-Starteinstellungen verwalten, um die Starteinstellungen zu aktualisieren.
DT1007 Ungültiger Dienstname im aktiven Startprofil, das das Compose-Profil verwendet. Wenn beispielsweise das aktive Startprofil das Compose-Profil p1 verwendet und die Dienstliste für das Compose-Profil p1 definiert, wie hier gezeigt:

"Docker Compose": {
  "commandName": "DockerCompose",
  "commandVersion": "1.0",
  "composeProfile": {
    "includes": [
      "p1"
    ],
    "serviceActions": {
      "webapp2": "StartWithoutDebugging"
    }
  }
}
aber der Dienst webapp2 in docker-compose.yml nicht definiert ist, wird dieser Fehler angezeigt.
Aktualisieren Sie das Startprofil, damit der richtige Dienstname verwendet wird, oder verwenden Sie das Dialogfeld Docker Compose-Starteinstellungen verwalten, um die Starteinstellungen zu aktualisieren.
DT1008 Ungültige Dienstaktion im aktiven Startprofil, das das Compose-Profil verwendet. Dies tritt beispielsweise auf, wenn das aktive Startprofil das Compose-Profil p1 verwendet, aber die falsche Aktion (wrongActionname) für einen Dienst (webapplication) definiert.
"Docker Compose": {  "commandName": "DockerCompose",
  "commandVersion": "1.0",
  "composeProfile": {
    "includes": [
      "p1"
    ],
    "serviceActions": {
      "webapp": "wrongActionname"
    }
  }
}
Korrigieren Sie die Dienstaktion in StartWithoutDebugging. Dies ist die einzige gültige Aktion für einen Dienst, der ein Compose-Profil verwendet.
DT1009 Das aktive Startprofil verwendet sowohl composeProfile als auch serviceActions. Ein Visual Studio-Startprofil kann entweder mithilfe von Compose-Profilen definiert werden oder durch Auswahl einer Dienstliste ohne Verwendung eines Compose-Profils. Es kann aber nicht mit beiden erstellt werden. Wenn ein aktives Startprofil also wie unten dargestellt beide verwendet, wird dieser Fehler angezeigt.
"Docker Compose": {
  "commandName": "DockerCompose",
  "commandVersion": "1.0",
  "composeProfile": {
    "includes": [
      "p1"
    ]
  },
  "serviceActions": {
    "webapp": "StartWithoutDebugging"
  }
}
Verwenden Sie entweder composeProfile oder serviceActions, oder aktualisieren Sie die Starteinstellungen im Dialogfeld Docker Compose-Starteinstellungen verwalten.
DT1010 Ungültiger Dienstname im aktiven Startprofil Wenn das aktive Startprofil z. B. die serviceActions definiert, wie hier dargestellt:
"Docker Compose": {
  "commandName": "DockerCompose",
  "commandVersion": "1.0",
  "serviceActions": {
    "redis1": "StartWithoutDebugging",
    "webapp8": "StartWithoutDebugging"
  }
}
Aber docker-compose.yml hat den redis1-Dienst nicht definiert, dann wird dieser Fehler angezeigt.
Aktualisieren Sie das Startprofil, damit der richtige Dienstname verwendet wird, oder verwenden Sie das Dialogfeld Docker Compose-Starteinstellungen verwalten, um die Starteinstellungen zu aktualisieren.
DT1011 Ungültige Dienstaktion im aktiven Startprofil Wenn beispielsweise das aktive Startprofil die falsche Dienstaktion (wrongAction) verwendet (wie unten dargestellt), wird dieser Fehler angezeigt.
"Docker Compose": {
  "commandName": "DockerCompose",
  "commandVersion": "1.0",
  "serviceActions": {
    "webapplication8": "wrongAction"
  }
}
Korrigieren Sie die Dienstaktion in DoNotStart, StartDebugging oder StartWithoutDebugging. Sie können auch die Starteinstellungen im Dialogfeld Docker Compose-Starteinstellungen verwalten aktualisieren.
DT1012 Ungültiges Startprofil. composeProfile und serviceActions fehlen. Ein Visual Studio-Startprofil kann entweder mithilfe von Compose-Profilen definiert werden oder durch Auswahl einer Dienstliste ohne Verwendung eines Compose-Profils. Das aktive Startprofil kann aber nicht ohne beide definiert werden. Aktualisieren Sie die Starteinstellungen im Dialogfeld Docker Compose-Starteinstellungen verwalten.
DT1013 Das aktive Startprofil wurde nicht gefunden. Stellen Sie sicher, dass das aktive Startprofil in launchSettings.json definiert ist.
DT1014 Ungültige Profilversion Dies tritt z. B. auf, wenn das aktive Startprofil eine unbekannte Befehlsversion (10.0) definiert:
"Docker Compose":
  "commandName": "DockerCompose",
  "commandVersion": "10.0",
  "serviceActions": {
      "webapp8": "StartDebugging",
    "redis": "StartWithoutDebugging"
  }
}
Lesen Sie die Fehlermeldung für die unterstützte commandVersion, oder verwenden Sie das Dialogfeld Docker Compose-Starteinstellungen verwalten, um die Starteinstellungen zu aktualisieren.
DT1015 Nicht unterstützte, alte Profilversion Die Profilversion wird von der aktuellen Visual Studio-Version nicht mehr unterstützt. Aktualisieren Sie das Profil auf die neueste unterstützte Version, indem Sie mithilfe des Dialogfelds Docker Compose-Starteinstellungen verwalten die Starteinstellungen aktualisieren.
DT1016 Es wird ein Profil aus einer neueren Version von Visual Studio verwendet. Die Profilversion ist höher als die aktuell unterstützte Version. Aktualisieren Sie Visual Studio auf die neueste Version.
DT1017 Es wird ein Profil aus einer neueren Version von Visual Studio verwendet, die jedoch weiterhin funktioniert. Dies ist eine Warnmeldung. Die Profilversion ist höher als die aktuelle unterstützte Version, die immer noch kompatibel mit der aktuellen Version von Visual Studio ist. Es fehlen aber möglicherweise einige Features.
DT1018 Es wird eine alte, kompatible Profilversion verwendet. Dies ist eine Warnmeldung. Die Profilversion ist niedriger als die neueste Version, aber immer noch kompatibel. Einige der neueren Features funktionieren möglicherweise nicht. Sie sollten ein Upgrade auf die neueste Version von Visual Studio in Betracht ziehen.
DT1019 Nicht unterstützte Compose-Version v2 Sie verwenden die ältere Version von Docker Compose v2, die das Compose-Profil nicht unterstützt. Aktualisieren Sie Docker Compose auf die aktuelle Version.

Einzelprojektspezifische Fehlercodes

Code BESCHREIBUNG Hinweise Fix
CTP1001 Nicht verwendet
CTP1002 Nicht verwendet
CTP1003 Der Container ist nicht vorhanden oder wird zum Zeitpunkt des Debuggens nicht ausgeführt. Weitere Details dazu, warum der Container nicht gestartet wurde, finden Sie im Ausgabefenster.
CTP1004 Docker-Gerüstbaufehler Versuchen Sie, die Docker-Unterstützung erneut hinzuzufügen.
CTP1005 Ungültiges Zielbetriebssystem Unbekanntes Zielbetriebssystem für Dockerfile in der DockerDefaultTargetOS-Eigenschaft Unterstützte Werte sind „Windows“ und „Linux“.
CTP1006 Fehler beim Beenden der Anwendung im Container Dies ist nur eine Warnung. Stellen Sie sicher, dass die Anwendung nicht verwendet wird.
CTP1007 Nicht verwendet
CTP1008 Nicht verwendet
CTP1009 Fehler beim Herunterladen der Azure Functions CLI Weitere Informationen finden Sie im Ausgabefenster.