如何在远程主机上运行 docker-compose？

Question

我在本地撰写文件。如何在docker-compose up -d 和DOCKER_HOST=<some ip> 等远程主机上运行容器包？

Answer 1

在Docker 18.09.0 发布和（截至目前）即将发布的docker-compose v1.23.1 发布之后，这将变得容易得多。上面提到的 Docker 版本分别为DOCKER_HOST 环境变量和-H 命令添加了对ssh 协议的支持和docker ... 命令的-H 参数。下一个docker-compose 发布will incorporate this feature as well。

首先，您需要SSH access to the target machine（任何方法都可能需要它）。

然后，要么：

# Re-direct to remote environment.
export DOCKER_HOST="ssh://my-user@remote-host"

# Run your docker-compose commands.
docker-compose pull
docker-compose down
docker-compose up

# All docker-compose commands here will be run on remote-host.

# Switch back to your local environment.
unset DOCKER_HOST

或者，如果您愿意，只需一个命令即可完成所有操作：

docker-compose -H "ssh://my-user@remote-host" up

这样做的好处是，您可以在 docker-compose.yml 文件中用于配置的所有本地环境变量都可用，而无需以某种方式将它们转移到 remote-host。

Answer 2

如果您不需要在本地机器上运行 docker 容器，但仍然在同一台远程机器上，您可以在 docker 设置中更改此设置。

在本地机器上： 可以通过-H参数控制远程主机

docker -H tcp://remote:2375 pull ubuntu

要将它与 docker-compose 一起使用，您应该在 /etc/default/docker 中添加此参数

在远程机器上

您应该从外部地址更改监听，而不仅仅是 unix 套接字。

更多详情请见Bind Docker to another host/port or a Unix socket。

如果你需要在多个远程主机上运行容器，你应该配置 Docker Swarm

Answer 3

您现在可以为此使用 docker 上下文：

docker context create dev ‐‐docker “host=ssh://user@remotemachine”

docker-compose ‐‐context dev up -d

更多信息在这里：https://www.docker.com/blog/how-to-deploy-on-remote-docker-hosts-with-docker-compose/

Answer 4

来自撰写文档

Compose CLI environment variables

DOCKER_HOST

设置 docker 守护进程的 URL。与 Docker 客户端一样，默认为 unix:///var/run/docker.sock。

这样我们就可以做

export DOCKER_HOST=tcp://192.168.1.2:2375
docker-compose up

Answer 5

我最近发现的另一种可能性是通过 SSH 隧道控制远程 Docker Unix 套接字（感谢 https://medium.com/@dperny/forwarding-the-docker-socket-over-ssh-e6567cfab160 我了解这种方法的地方）。

先决条件

您可以通过 SSH 连接到目标机器。出于安全性和便利性考虑，首选无密码、基于密钥的访问，您可以学习如何设置它，例如这里：https://askubuntu.com/questions/46930/how-can-i-set-up-password-less-ssh-login

此外，一些消息来源提到通过 SSH 隧道转发 Unix 套接字只能从 OpenSSH v6.7 开始（运行 ssh -V 进行检查），不过我没有在旧版本上尝试过。

SSH 隧道

现在，在本地位置和远程机器上的 Docker Unix 套接字之间创建一个新的 SSH 隧道： ssh -nNT -L $(pwd)/docker.sock:/var/run/docker.sock user@someremote

或者，也可以绑定到本地端口而不是文件位置。确保端口已为连接打开并且尚未使用。 ssh -nNT -L localhost:2377:/var/run/docker.sock user@someremote

重定向 Docker 客户端

让终端保持打开状态并打开第二个终端。在那里，让您的 Docker 客户端与新创建的隧道套接字而不是本地 Unix Docker 套接字通信。

如果您绑定到文件位置：

export DOCKER_HOST=unix://$(pwd)/docker.sock

如果您绑定到本地端口（上面使用的示例端口）：

export DOCKER_HOST=localhost:2377

现在，运行一些 Docker 命令，例如 docker ps 或启动容器、拉取映像等。只要 SSH 隧道处于活动状态，一切都会在远程机器上发生。为了再次运行本地 Docker 命令：

• 在第一个终端点击Ctrl+C 关闭隧道。
• 如果您绑定到文件位置：再次删除临时隧道套接字。否则您以后将无法再次打开同一个：rm -f "$(pwd)"/docker.sock
• 让您的 Docker 客户端再次与您的本地 Unix 套接字通信（如果未设置，这是默认值）：unset DOCKER_HOST

这样做的好处是您省去了复制docker-compose.yml 文件和其他资源或在远程机器上设置环境变量的麻烦（这很困难）。

非交互式 SSH 隧道

如果您想在无法使用交互式终端的脚本上下文中使用它，可以使用SSH ControlMaster and ControlPath options 来open and close the SSH tunnel in the background：

# constants
TEMP_DIR="$(mktemp -d -t someprefix_XXXXXX)"
REMOTE_USER=some_user
REMOTE_HOST=some.host
control_socket="${TEMP_DIR}"/control.sock
local_temp_docker_socket="${TEMP_DIR}"/docker.sock
remote_docker_socket="/var/run/docker.sock"

# open the SSH tunnel in the background - this will not fork
# into the background before the tunnel is established and fail otherwise
ssh -f -n -M -N -T \
    -o ExitOnForwardFailure=yes \
    -S "${control_socket}" \
    -L "${local_temp_docker_socket}":"${remote_docker_socket}" \
    "${REMOTE_USER}"@"${REMOTE_HOST}"

# re-direct local Docker engine to the remote socket
export DOCKER_HOST="unix://${local_temp_docker_socket}"

# do some business on remote host
docker ps -a

# close the tunnel and clean up
ssh -S "${control_socket}" -O exit "${REMOTE_HOST}"
rm -f "${local_temp_docker_socket}" "${control_socket}"
unset DOCKER_HOST

# do business on localhost again   

Answer 6

鉴于您能够在远程机器上登录，在该机器上运行docker-compose 命令的另一种方法是使用SSH。

通过scp 将docker-compose.yml 文件复制到远程主机，在SSH 上运行docker-compose 命令，最后通过再次删除文件进行清理。 这可能如下所示：

scp ./docker-compose.yml SomeUser@RemoteHost:/tmp/docker-compose.yml
ssh SomeUser@RemoteHost "docker-compose -f /tmp/docker-compose.yml up"
ssh SomeUser@RemoteHost "rm -f /tmp/docker-compose.yml"

您甚至可以缩短它并省略docker-compose.yml 文件的发送和删除，方法是使用docker-compose 的-f - 选项，这将期望docker-compose.yml 文件从stdin 传输。只需将其内容通过管道传递给SSH 命令：

cat docker-compose.yml | ssh SomeUser@RemoteHost "docker-compose -f - up"

如果您在 docker-compose.yml 文件中使用环境变量替换，上述命令不会将它们替换为远程主机上的本地值，并且您的命令可能会由于未设置变量而失败。为了克服这个问题，可以使用envsubst utility 将变量替换为内存中的本地值，然后再将内容传递给SSH 命令：

envsubst < docker-compose.yml | ssh SomeUser@RemoteHost "docker-compose up"