使用“容器”窗口

  • 项目

可使用“容器”窗口查看托管应用的容器内发生的情况 。 如果习惯于通过使用命令提示符运行 Docker 命令来查看和诊断容器中进行的操作，则此窗口提供更方便的方法，在无需离开 Visual Studio IDE 的情况下即可监视容器。

还可以使用“容器”窗口查看有关容器映像的信息。

先决条件

查看容器的相关信息

启动容器化 .NET 项目时，自动打开“容器”窗口 。 若要随时在 Visual Studio 中查看容器，请使用 Ctrl+Q 激活 Visual Studio 搜索框，键入 Containers 并选择第一项 。 还可以从主菜单中打开“容器”窗口 。 使用菜单路径“查看”>“其他 Windows”>“容器”。

Visual Studio 中“容器”窗口的屏幕截图，其中在左窗格中选中了一个容器，在右窗格中选中了“环境”选项卡。

Visual Studio 中“容器”窗口的屏幕截图，其中在左窗格中选中了一个容器，在右窗格中选中了“环境”选项卡。

在左侧，可看到本地计算机上的容器列表。 与解决方案关联的容器显示在“解决方案容器”下 。 在右侧，可看到一个窗格，其中包含“环境”、“标签”、“端口”、“卷”、“日志”和“文件”选项卡 。

提示

可轻松自定义“容器”工具窗口在 Visual Studio 中的停靠位置 。 请参阅在 Visual Studio 中自定义窗口布局。 默认情况下，调试器正在运行时，“容器”窗口与“监视”窗口停靠在一起 。

如果使用 Docker Compose 和 Visual Studio 2022 版本 17.7 或更高版本，则会看到解决方案及其 Docker Compose 项目的节点树，其中包括解决方案的父节点和每个项目的子节点。

屏幕截图显示了“容器”窗口中的 Docker Compose 节点。

查看环境变量

“环境”选项卡显示容器中的环境变量 。 对于应用的容器，可以通过多种方式设置这些变量，例如，在 Dockerfile 中、在 .env 文件中，或在使用 Docker 命令启动容器时使用 -e 选项进行设置。

Visual Studio 中“容器”窗口的屏幕截图，其中显示容器的“环境”变量。

Visual Studio 中“容器”窗口的屏幕截图，其中显示容器的“环境”变量。

注意

对环境变量所做的任何更改都不会实时反映出来。 此外，此选项卡中的环境变量是容器上的系统环境变量，不反映应用程序的本地用户环境变量。

查看标签

“标签”选项卡显示容器的标签。 标签是在 Docker 对象上设置自定义元数据的一种方法。 某些标签由 Visual Studio 自动设置。

Visual Studio 中“容器”窗口的屏幕截图，其中显示“标签”选项卡。

Visual Studio 中“容器”窗口的屏幕截图，其中显示“标签”选项卡。

查看端口映射

在“端口”选项卡上，可以检查对容器有效的端口映射 。

“容器”窗口中“端口”选项卡的屏幕截图。

“容器”窗口中“端口”选项卡的屏幕截图。

已链接已知端口，因此，如果某个端口上有可用的内容，则可以单击该链接打开浏览器。

查看卷

“卷”选项卡显示容器上的卷（装载的文件系统节点）。

“容器”窗口中“卷”选项卡的屏幕截图。

“容器”窗口中“卷”选项卡的屏幕截图。

查看日志

“日志”选项卡显示 docker logs 命令的结果 。 该选项卡默认显示容器上的 stdout 和 stderr 流，但你可以配置输出。 有关详细信息，请参阅 Docker 日志记录。 默认情况下，“日志”选项卡会流式传输日志，但你可以通过选择选项卡上的“流式传输”按钮来暂停流式传输。如果再次选择“流式传输”，流式处理将从其离开的位置恢继续。

“容器”窗口中“日志”选项卡的屏幕截图。

“容器”窗口中“日志”选项卡的屏幕截图。

若要清除日志，请使用“日志”选项卡上的“清除”按钮。若要获取所有日志，请使用“刷新”按钮。

注意

当你直接运行而不使用 Windows 容器进行调试时，Visual studio 会将 stdout 和 stderr 自动重定向到“输出”窗口，因此使用 Ctrl+F5 从 Visual Studio 启动的 Windows 容器不会显示此选项卡中的日志；请改为使用“输出”窗口 。

如果将 Docker Compose 与 Visual Studio 2022 版本 17.7 或更高版本配合使用，则可以选择单独查看每个容器的日志，或者将日志交错导出到单个输出流中。 如果选择解决方案的父节点，则会看到所有 Compose 项目中的交叉日志。 每行的第一列会显示生成该输出行的容器。 如果只想查看一个容器本身的日志，请选择该特定项目的节点。

屏幕截图显示了“容器”窗口“日志”选项卡中的交叉日志。

查看 filesystem

在“文件”选项卡上，可以查看容器的文件系统，包括其中包含项目的应用文件夹 。

“容器”窗口中“文件”选项卡的屏幕截图。

“容器”窗口中“文件”选项卡的屏幕截图。

若要在 Visual Studio 中打开文件，请浏览到该文件并双击它，或右键单击并选择“打开” 。 Visual Studio 在只读模式下打开文件。

在 Visual Studio 中打开以供查看的文件的屏幕截图。

在 Visual Studio 中打开以供查看的文件的屏幕截图。

使用“文件”选项卡，可以查看容器的文件系统中的应用程序日志（例如 IIS 日志）、配置文件和其他内容文件 。

在 Visual Studio 2022 版本 17.7 或更高版本中，当面向 .NET 8 或更高版本时，Dockerfile 可能包含指定使用普通用户权限运行应用的 USER app 命令。 “文件”选项卡也使用这些权限，因此，如果这些文件夹设置为需要提升的权限才能查看，则可能无法查看某些文件夹。

启动、停止和删除容器

“容器”窗口默认显示 Docker 管理的计算机上的所有容器 。 可以使用工具栏按钮来启动、停止或移除（删除）不再需要的容器。 创建或删除容器时，会动态更新此列表。

若要选择多个容器，例如，要一次删除多个容器，请使用“Ctrl+单击”。 如果尝试启动 10 个以上的容器，系统将提示你确认此操作。 你可以根据需要禁用确认提示。

在正在运行的容器中打开终端窗口

可以使用“容器”窗口中的“打开终端窗口”按钮在容器中打开终端窗口（命令提示符或交互式 shell） 。

在“容器”窗口中打开终端窗口的屏幕截图。

在“容器”窗口中打开终端窗口的屏幕截图。

对于 Windows 容器，将打开 Windows 命令提示符。 对于 Linux 容器，将使用 Bash shell 打开窗口。

Bash 窗口的屏幕截图。

Bash 窗口的屏幕截图。

如果面向 .NET 8，则 Dockerfile 可以指定 USER app 命令，这意味着应用将使用普通用户权限（而不是提升的权限）运行。 如果面向 .NET 8 或更高版本，则 Visual Studio 生成的 Dockerfile 会在 Visual Studio 2022 版本 17.7 及更高版本中包括此项。 终端会以在 Dockerfile 中指定的用户身份打开（默认情况下，对于 .NET 8 项目，它是 app）；或如果未指定用户，则以 root 用户身份运行。

通常，终端窗口会在 Visual Studio 之外作为单独的窗口打开。 如果希望将命令行环境作为可停靠的工具窗口集成到 Visual Studio IDE 中，则可以安装 Whack Whack Terminal。

将调试器附加到进程

可以使用“容器”窗口工具栏上的“附加到进程” 按钮，将调试器附加到正在容器中运行的进程。 使用此按钮时，将出现“附加到进程” 对话框，并显示正在容器中运行的可用进程。

“附加到进程”对话框的屏幕截图。

“附加到进程”对话框的屏幕截图。

可以附加到容器中的托管进程。 若要查找另一个容器中的进程，请使用“查找”按钮，然后在“选择 Docker 容器”对话框中选择另一个容器 。

查看图像

还可以使用“容器”窗口中的“图像”选项卡来查看本地计算机上的图像 。 从外部存储库中提取的图像将在树视图中组合在一起。

显示“容器”窗口的屏幕截图，其中显示了容器映像。

显示“容器”窗口的屏幕截图，其中显示了容器映像。

此窗口只有适用于映像的选项卡：“标签”和“详细信息” 。 “详细信息”选项卡以 JSON 格式显示映像的配置详细信息。

屏幕截图显示“容器”窗口的“映像”>“详细信息”选项卡。

屏幕截图显示“容器”窗口的“映像”>“详细信息”选项卡。

若要删除某个图像，请在树视图中右键单击该图像，然后选择“删除” ，或选择该图像，然后使用工具栏上的“删除” 按钮。

删除容器和映像

可以通过使用“容器”窗口工具栏上的“删除”按钮轻松删除不再使用的容器和映像 。

显示删除按钮的屏幕截图。

显示删除按钮的屏幕截图。

系统会要求你确认是否要删除所有未使用的容器。

选择“映像”选项卡时，“删除”按钮会询问你是否要删除所有悬空映像 。 悬空映像是不再与标记的映像关联的层的映像。 偶尔删除它们有助于节省磁盘空间。

配置选项

可以配置各种任务的确认对话框，例如删除容器和映像或一次启动 10 个以上的容器等任务。 可以使用对话框上的复选框来禁用每个提示。 还可以使用“工具”>“选项”>“容器工具”>“容器工具窗口”中的设置来启用或禁用这些选项 。 请参阅配置容器工具。

相关内容