将您的 Go 镜像作为容器运行

先决条件

完成步骤以在 构建您的 Go 镜像 中容器化 Go 应用程序。

概述

在上一模块中,您为示例应用程序创建了一个 Dockerfile,然后使用命令 docker build 创建了 Docker 镜像。现在您有了镜像,可以运行该镜像并查看您的应用程序是否正常运行。

容器是一个普通的操作系统进程,只是该进程是隔离的,并拥有自己的文件系统、网络和与主机分离的独立进程树。

要在容器内运行镜像,请使用 docker run 命令。它需要一个参数,即镜像名称。启动您的镜像并确保它正常运行。在您的终端中运行以下命令。

$ docker run docker-gs-ping
   ____    __
  / __/___/ /  ___
 / _// __/ _ \/ _ \
/___/\__/_//_/\___/ v4.10.2
High performance, minimalist Go web framework
https://echo.labstack.com
____________________________________O/_______
                                    O\
⇨ http server started on [::]:8080

运行此命令时,您会注意到您没有返回到命令提示符。这是因为您的应用程序是一个 REST 服务器,将在循环中运行,等待传入请求,直到您停止容器,否则不会将控制权返回给操作系统。

使用 curl 命令向服务器发出 GET 请求。

$ curl https://127.0.0.1:8080/
curl: (7) Failed to connect to localhost port 8080: Connection refused

您的 curl 命令失败,因为连接到服务器被拒绝。这意味着您无法连接到端口 8080 上的 localhost。这是预期的,因为您的容器在隔离中运行,包括网络。停止容器并使用发布到本地网络的端口 8080 重新启动。

要停止容器,请按 ctrl-c。这会将您返回到终端提示符。

要发布容器的端口,您将在 docker run 命令中使用 --publish 标志(简称 -p)。--publish 命令的格式为 [host_port]:[container_port]。因此,如果您想将容器内的端口 8080 暴露到容器外的端口 3000,则需要将 3000:8080 传递给 --publish 标志。

启动容器并将端口 8080 暴露到主机上的端口 8080

$ docker run --publish 8080:8080 docker-gs-ping

现在,重新运行 curl 命令。

$ curl https://127.0.0.1:8080/
Hello, Docker! <3

成功!您能够连接到端口 8080 上运行在容器内的应用程序。切换回运行容器的终端,您应该看到 GET 请求记录到控制台中。

ctrl-c 停止容器。

在分离模式下运行

到目前为止,一切都很好,但您的示例应用程序是一个 Web 服务器,您不应该必须让您的终端连接到容器。Docker 可以将您的容器在后台分离模式下运行。为此,您可以使用 --detach 或简称 -d。Docker 将与之前一样启动您的容器,但这次将与容器分离并返回到终端提示符。

$ docker run -d -p 8080:8080 docker-gs-ping
d75e61fcad1e0c0eca69a3f767be6ba28a66625ce4dc42201a8a323e8313c14e

Docker 在后台启动了您的容器并在终端上打印了容器 ID。

同样,确保您的容器正在运行。运行相同的 curl 命令

$ curl https://127.0.0.1:8080/
Hello, Docker! <3

列出容器

由于您在后台运行了容器,您如何知道您的容器是否正在运行,或者您的机器上正在运行哪些其他容器?嗯,要查看机器上运行的容器列表,请运行 docker ps。这类似于使用 ps 命令查看 Linux 机器上的进程列表。

$ docker ps

CONTAINER ID   IMAGE            COMMAND             CREATED          STATUS          PORTS                    NAMES
d75e61fcad1e   docker-gs-ping   "/docker-gs-ping"   41 seconds ago   Up 40 seconds   0.0.0.0:8080->8080/tcp   inspiring_ishizaka

ps 命令会告诉您有关运行容器的大量信息。您可以看到容器 ID、容器内运行的镜像、用于启动容器的命令、创建时间、状态、暴露的端口以及容器的名称。

您可能想知道您的容器名称从何而来。由于您在启动容器时没有提供名称,Docker 生成了一个随机名称。您将在稍后解决此问题,但首先,您需要停止容器。要停止容器,请运行 docker stop 命令,并传递容器的名称或 ID。

$ docker stop inspiring_ishizaka
inspiring_ishizaka

现在重新运行 docker ps 命令以查看正在运行的容器列表。

$ docker ps

CONTAINER ID   IMAGE     COMMAND   CREATED   STATUS    PORTS     NAMES

停止、启动和命名容器

Docker 容器可以启动、停止和重新启动。停止容器后,不会将其删除,而是将其状态更改为已停止,并且容器内的进程也会停止。运行 docker ps 命令时,默认输出仅显示正在运行的容器。如果您传递 --all 或简称 -a,您将看到系统上的所有容器,包括已停止的容器和正在运行的容器。

$ docker ps --all

CONTAINER ID   IMAGE            COMMAND                  CREATED              STATUS                      PORTS     NAMES
d75e61fcad1e   docker-gs-ping   "/docker-gs-ping"        About a minute ago   Exited (2) 23 seconds ago             inspiring_ishizaka
f65dbbb9a548   docker-gs-ping   "/docker-gs-ping"        3 minutes ago        Exited (2) 2 minutes ago              wizardly_joliot
aade1bf3d330   docker-gs-ping   "/docker-gs-ping"        3 minutes ago        Exited (2) 3 minutes ago              magical_carson
52d5ce3c15f0   docker-gs-ping   "/docker-gs-ping"        9 minutes ago        Exited (2) 3 minutes ago              gifted_mestorf

如果您一直跟着做,您应该会看到列出的几个容器。这些是您启动和停止但尚未删除的容器。

重新启动刚刚停止的容器。找到容器的名称,并将以下 restart 命令中的容器名称替换为您系统上的容器名称

$ docker restart inspiring_ishizaka

现在,再次使用 ps 命令列出所有容器

$ docker ps -a

CONTAINER ID   IMAGE            COMMAND                  CREATED          STATUS                     PORTS                    NAMES
d75e61fcad1e   docker-gs-ping   "/docker-gs-ping"        2 minutes ago    Up 5 seconds               0.0.0.0:8080->8080/tcp   inspiring_ishizaka
f65dbbb9a548   docker-gs-ping   "/docker-gs-ping"        4 minutes ago    Exited (2) 2 minutes ago                            wizardly_joliot
aade1bf3d330   docker-gs-ping   "/docker-gs-ping"        4 minutes ago    Exited (2) 4 minutes ago                            magical_carson
52d5ce3c15f0   docker-gs-ping   "/docker-gs-ping"        10 minutes ago   Exited (2) 4 minutes ago                            gifted_mestorf

请注意,您刚刚重新启动的容器已在分离模式下启动,并暴露了端口 8080。此外,请注意容器的状态是 Up X seconds。重新启动容器时,它将使用最初启动它的相同标志或命令启动。

停止并删除所有容器,并看看如何解决随机命名问题。

停止刚刚启动的容器。找到正在运行的容器的名称,并将以下命令中的名称替换为系统上容器的名称

$ docker stop inspiring_ishizaka
inspiring_ishizaka

现在所有容器都已停止,请删除它们。删除容器后,它不再运行,也不处于已停止状态。相反,容器内的进程将终止,并且容器的元数据将被删除。

要删除容器,请运行 docker rm 命令并传递容器名称。您可以在一条命令中将多个容器名称传递给该命令。

同样,请确保您将以下命令中的容器名称替换为系统中的容器名称

$ docker rm inspiring_ishizaka wizardly_joliot magical_carson gifted_mestorf

inspiring_ishizaka
wizardly_joliot
magical_carson
gifted_mestorf

再次运行 docker ps --all 命令以验证所有容器是否都已消失。

现在,解决讨厌的随机命名问题。标准做法是命名您的容器,原因很简单,因为这样可以更轻松地识别容器中运行的内容以及它与哪个应用程序或服务相关联。就像代码中变量的良好命名约定使代码更容易阅读一样。所以命名您的容器也是如此。

要命名容器,您必须将 --name 标志传递给 run 命令

$ docker run -d -p 8080:8080 --name rest-server docker-gs-ping
3bbc6a3102ea368c8b966e1878a5ea9b1fc61187afaac1276c41db22e4b7f48f
$ docker ps

CONTAINER ID   IMAGE            COMMAND             CREATED          STATUS          PORTS                    NAMES
3bbc6a3102ea   docker-gs-ping   "/docker-gs-ping"   25 seconds ago   Up 24 seconds   0.0.0.0:8080->8080/tcp   rest-server

现在,您可以根据名称轻松识别您的容器。

下一步

在本模块中,您学习了如何运行容器和发布端口。您还学习了如何管理容器的生命周期。然后,您了解了命名容器的重要性,以便更轻松地识别它们。在下一模块中,您将学习如何在容器中运行数据库并将其连接到您的应用程序。