Kitematic用户指南

旧版桌面解决方案。Kitematic是一个遗留解决方案，与Docker Toolbox捆绑在一起。如果您的系统满足其中一个应用程序的要求，我们建议更新到Mac的Docker Desktop或Windows的Docker Desktop。

预计阅读时间：7分钟

概述

Kitematic是一个开源项目，旨在在Mac或Windows PC上使用Docker进行简化和精简。Kitematic自动执行Docker安装和设置过程，并为运行Docker容器提供直观的图形用户界面（GUI）。Kitematic与Docker Machine集成 以配置VirtualBox VM，并在您的计算机上本地安装Docker Engine。

安装后，将启动Kitematic GUI，并在主屏幕上为您显示可立即运行的精选图像。您只需在搜索栏中输入即可从Kitematic搜索Docker Hub上的任何公共映像。您只需单击按钮即可使用GUI创建，运行和管理容器。Kitematic允许您在Docker CLI和GUI之间来回切换。Kitematic还可以自动执行高级功能，例如管理端口和配置卷。您可以使用Kitematic从GUI将环境变量，流日志和单击终端更改为Docker容器。

首先，如果您尚未这样做，请通过以下一种方式下载并安装Kitematic：

• 从Mac的Docker桌面或Windows的Docker桌面菜单中选择Kitematic，以开始进行Kitematic安装。

• 直接从Kitematic版本页面下载Kitematic 。

启动Kitematic。（在桌面系统上，单击该应用程序。）

使用您的Docker ID登录

提供您的Docker ID和用户名，然后单击“登录”或单击“立即跳过”以访客身份浏览Docker Hub。

货柜清单

Kitematic在左侧的“新容器”链接下方列出了所有正在运行和已停止的容器。

容器列表包括所有容器，即使不是由Kitematic启动的容器，也可以让您快速概览Docker守护程序的状态。

您可以单击任何容器以查看其日志（主容器进程的输出），sh在该容器中重新启动，停止或执行。有关更多详细信息，请参见 使用容器。

创建一个新的容器

“新容器”页面可让您搜索Docker Hub上的图像并从中进行选择。找到要运行的映像后，可以单击“创建”以拉出，创建和运行容器。

使用容器

如果选择一个非运行的容器（已停止或已暂停），则可以使用图标“重新启动”或“停止”该容器。您还可以查看整个主容器进程的输出日志，并且在“设置”部分中可以进行更改，这些更改将在“重新启动”此容器时使用。

通过从左侧列表中选择一个正在运行的容器，您可以看到容器的一些状态信息-具有Web服务器的容器的HTML输出的预览，主容器进程的日志以及已经存在的任何容器卷。配置。

摘要页面根据图像元数据显示不同的内容。如果已知的“ Web”端口（参见下文）为EXPOSED，则Kitematic假定其为网页，并在上显示该站点的预览/。如果暴露了其他端口，则会显示这些端口的列表以及它们映射到的Docker守护程序IP和端口。如果有VOLUMES，则显示这些。汇总屏幕至少会显示主容器进程的日志输出。

当前检测到的“网络”端口，80，8000，8080，3000，5000， 2368，9200，和8983。

查看容器日志

您可以通过单击“日志”预览图像或单击“日志”选项卡来查看整个主容器过程的日志输出。

然后，您可以滚动浏览当前运行容器中的日志。请注意，如果您对容器设置进行了更改，则容器将重新启动，因此这将重置此日志视图。

在容器中启动终端

容器摘要顶部的“终端”图标运行docker container exec -i -t <your container> sh。这使您可以进行快速更改或调试问题。

注意：您执行的sh进程与主容器进程及其子进程的环境设置不同。获取您的shell的环境命令：docker-machine env default。

管理卷

您可以通过单击容器摘要屏幕的“编辑文件”部分中的文件夹，选择将所有容器的卷映射到Mac上的目录。

这使您可以通过Finder管理卷中的文件。Kitematic在下显示容器的体积数据~/Documents/Kitematic/<container's name>/。可通过以下应用程序快速访问此文件夹（或目录）：

注意：当“使所有卷能够在Finder中编辑文件”时，Docker容器将被停止，删除并使用新volumes 标志重新创建。

更改音量目录

假设您有一个通过Kitematic运行的Nginx Web服务器（使用 kitematic/hello-world-nginxDockerHub上的映像）。但是，您不想使用为website_files卷创建的默认目录。相反，您已经在下找到了网站的HTML，Javascript和CSS ~/workspace/website。

导航到容器的“设置”标签，然后转到“卷”。该屏幕允许您单独设置映射。

注意：当您“更改文件夹”时，Docker容器将被停止，移除并使用新volumes 标志重新创建。

设置容器名称

默认情况下，Kitematic将容器名称设置为与映像名称相同（-<number>如果有多个，则使用。）为简化管理，或者在使用容器链接或卷时，您可能需要重命名。

注意：重命名容器时，它将停止，删除并使用新名称重新创建（由于默认的卷映射）。

添加环境变量

许多图像使用环境变量来自定义它们。“常规”“设置”选项卡允许您添加和修改用于启动容器的环境变量。

环境变量列表显示了已在图像元数据上设置的任何变量，例如，使用ENVDockerfile中的指令。

当“保存”更改后的环境变量时，将停止，删除并重新创建容器。

删除容器

在“常规”“设置”选项卡上，您可以删除容器。如果需要，单击“删除容器”也会停止该容器。

您也可以通过单击X容器列表中的图标来删除容器。

Kitematic会提示您确认要删除。

列出暴露的端口以及如何访问它们

要查看裸露端口的完整列表，请依次转到“设置”和“端口”。此页面列出了所有公开的容器端口，以及您可以访问的IP地址和仅主机网络端口，用于从macOS系统访问该容器。

Docker命令行访问

您可以与Kitematic中的现有容器进行交互，也可以通过Docker命令行界面（CLI）创建新容器。您在CLI上所做的任何更改都直接反映在Kitematic中。

要通过Kitematic打开终端，只需按下左下方的鲸鱼按钮，如下所示：

示例：创建一个新的Redis容器

如上所述，首先通过单击鲸鱼按钮打开Docker-CLI就绪终端。终端打开后，输入docker run -d -P redis。这将通过Docker CLI拉出，创建并运行一个新的Redis容器。

注意：如果要从命令行创建容器，请使用，docker run -d 以便在通过Kitematic用户界面更改设置时Kitematic可以重新创建容器。已启动的容器没有-d重新启动失败。

现在，回到Kitematic。Redis容器现在可见。

下一步

有关使用Kitematic运行Minecraft服务器的示例，请查看Minecraft服务器页面。