将你的 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 http://localhost:8080/
curl: (7) Failed to connect to localhost port 8080: Connection refused

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

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

要为你的容器发布端口，请在 docker run 命令上使用 --publish 标志（简写为 -p）。--publish 命令的格式为 [主机端口]:[容器端口]。因此，如果你想将容器内的 8080 端口暴露给容器外的 3000 端口，你需要向 --publish 标志传递 3000:8080。

启动容器并将容器内的 8080 端口暴露给主机的 8080 端口。

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

现在，重新运行 curl 命令。

$ curl http://localhost: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 http://localhost:8080/
Hello, Docker! <3

列出容器

既然你在后台运行了容器，你怎么知道你的容器是否正在运行，或者你的机器上还有哪些其他容器正在运行？要查看你的机器上正在运行的容器列表，请运行 docker ps 命令。这类似于在 Linux 机器上使用 ps 命令查看进程列表的方式。

$ 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 命令，验证所有容器是否已移除。

现在，解决恼人的随机命名问题。标准做法是为你的容器命名，原因很简单：更容易识别容器中运行的是什么，以及它与哪个应用或服务相关联。就像代码中良好的变量命名规范使其更易于阅读一样，为容器命名也是如此。

要为容器命名，你必须向 run 命令传递 --name 标志。

$ 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

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

下一步

在本模块中，你学习了如何运行容器和发布端口。你还学习了如何管理容器的生命周期。然后，你学习了为容器命名的重要性，以便它们更容易被识别。在下一个模块中，你将学习如何在容器中运行数据库并将其连接到你的应用。