从 Docker 到本地主机：一帆风顺

David Cannan David Cannan 于 Docker 2023 年 12 月 8 日

想象一下，你在笔记本电脑上开发，使用 Docker 将应用程序容器化，以实现一致性和轻松部署。你的当前项目涉及使用 MinIO 进行对象存储，并且你已经漂亮地在 Docker 中设置了它。但这里有一个转折：你的工作流程需要 MinIO 与在你的本地主机上运行的 Flask 应用程序进行交互，以处理事件和执行函数（在 MinIO 的上下文中称为事件通知和对象 Lambdas）。

在这个设置中，你可能会遇到的一个常见障碍是网络相关的错误，通常表现为“error (flask-notification:webhook): dial tcp 127.0.0.1:5000”...

此错误表明 MinIO 运行的 Docker 容器和本地主机上托管的 Flask 应用程序之间存在基本的网络不匹配。本质上，当 Docker 内部的 MinIO 尝试将事件通知发送到 Flask 应用程序时，它会尝试连接到 localhost:5000。但是，在 Docker 上下文中，localhost 指的是 Docker 容器本身，而不是你的 Flask 应用程序运行的主机。这会导致 MinIO 尝试在其容器内的 localhost:5000 上建立与服务的连接，但该服务不存在，从而导致连接被拒绝。

这种情况强调需要清楚地了解 Docker 网络，特别是 localhost 在 Docker 容器内的不同解释方式。

本指南将随后深入探讨有效策略来重新调整这种通信，确保 Docker 内部的 MinIO 能够成功地将事件通知发送到你的主机上运行的 Flask 应用程序。通过解决此挑战，我们创建了一个开发环境，它与生产设置非常相似，从而提高工作流程的可靠性和有效性。

本演练将指导你完成设置此环境的过程。我们将从在 Docker 内设置 MinIO 开始，确保它正确配置为发出事件。然后，我们将继续进行 Flask 应用程序，该应用程序旨在响应这些事件。本指南的关键部分将重点关注启用 MinIO 容器与你的本地主机上运行的 Flask 应用程序之间的通信。我们将解决常见的障碍，如 Docker 网络、地址解析和数据一致性。

在本指南结束时，你将拥有一个功能齐全的本地开发设置，其中MinIO 事件会触发你的 Flask 应用程序中的操作，在你的笔记本电脑上模拟类似生产的环境。这种情况不仅是关于使事情正常工作；它还旨在创建一个尽可能接近生产环境的开发环境，从而提高开发和测试过程的可靠性。

了解本地开发策略中的 Docker 网络

在我们整合 Flask 应用程序的过程中，必须首先了解 Docker 网络的一个关键方面——Docker 容器与主机之间的通信动态。对于编排本地开发环境的开发人员来说，这种知识尤其不可或缺，例如笔记本电脑上的开发环境，其中需要 Docker 容器和主机服务（如我们的 Flask 应用程序）进行交互，而不会出现问题。

在 Docker 容器的上下文中，'localhost' 具有独特的含义。与它通常指代主机不同，在 Docker 容器内部，'localhost' 指的是容器本身。这种区别非常重要，尤其是在 Docker 化服务（如 MinIO）尝试访问主机上的服务时。

为了说明这一点，让我们考虑以下图像中显示的错误情况。

*MinIO 事件通知错误演示：“error (flask-notification:webhook): dial tcp 127.0.0.1:5000: connect: connection refused”*

当在 Docker 容器中运行的 MinIO 无法连接到 localhost 时——在本例中，是主机上的 Flask 应用程序。

我们在 Docker-MinIO 截图中遇到的连接错误，其特征是消息(flask-notification:webhook): dial tcp 127.0.0.1:5000: connect: connection refused，最初看起来很复杂。但是，更仔细的分析揭示了它的根本原因。段flask-notification:webhook 识别问题的来源——它是 MinIO 与我们的 Flask 应用程序交互的机制。短语dial tcp 127.0.0.1:5000 表示 MinIO 尝试与 Flask 应用程序建立 TCP 连接，该应用程序可能位于localhost:5000。关键部分，connection refused，表明 MinIO 无法在指定地址访问 Flask 应用程序，这突出了容器化网络中的一个基本挑战。

为了纠正这一点，MinIO 和 Flask 之间需要一个清晰直接的通信路径。对于 Flask 托管在同一台机器上但位于 Docker 外部的场景，解决方案涉及配置 MinIO 连接到host.docker.internal:5000。这个特殊的 DNS 地址就像一条直线，使 Docker 内部的 MinIO 能够访问主机上的 Flask 应用程序。

这为 Mac 和 Windows 用户提供了通过host.docker.internal 的解决方案，这是一个 DNS 名称，允许容器正确地引用主机，从而促进容器化服务与基于主机的应用程序之间的所需交互。了解和利用此 Docker 功能对于确保本地开发设置尽可能地镜像生产环境至关重要，从而提高开发可靠性和效率。

资产概述

本指南的基础在于可从 GitHub minio/blog-assets 存储库中的 docker_to_localhost 目录获得的准备好的资产。在这里，我已经提供了本指南中讨论的所有内容的源代码，在该存储库的核心，你会发现

README 文件：此 README.md 包含执行本文中执行的操作的相应命令。
Flask 应用程序文件：此 main.py 文件构成了 Flask 应用程序，是我们设置中的一个关键组件。它专门设计为与 MinIO 服务进行有效交互。
Flask 应用程序的 Docker 文件：此 dockerfile 是创建 Docker 容器的蓝图。它定义了构建和运行 Flask 应用程序的环境，确保不同设置之间的一致性。
Docker Compose 文件：充当协调器，此 docker-compose.yaml 定义了多个容器（如 MinIO 和 Flask）如何在你的 Docker 环境中共存和通信。

部署用于 MinIO 事件处理的 Flask 应用程序

在将 Flask 应用程序与 Docker 化的 MinIO 服务集成的上下文中，让我们深入研究 Flask 应用程序的配置。具体来说，我已经设置了一个 Flask 端点，其标识符为“flask-minio-event”，旨在通过http://host.docker.internal:5000/minio_event 充当 MinIO webhook 事件的接收器，如以下截图所示。

以下是我们在本地机器上运行的演示 Flask 应用程序的代码，它在端口 5000 上提供/minio_event 的路由。

from flask import Flask, request, jsonify
import logging
import os
from dotenv import load_dotenv

app = Flask(__name__)

load_dotenv()
logging.basicConfig(level=logging.INFO)
I
@app.route('/minio_event', methods=['POST'])
def log_bucket_event():
    """
    Logs events received from MinIO to the Python logger.
    """
    event_data = request.json
    logging.info(f"Event received: {event_data}")
    return jsonify({'message': 'Event logged successfully'})

if __name__ == '__main__':
    port = int(os.getenv('FLASK_PORT', 5000))
    debug_mode = os.getenv('FLASK_DEBUG', 'False') == 'True'
    app.run(host='0.0.0.0', port=port, debug=debug_mode)

在上一节中，我们探讨了 Docker 容器如何解释 'localhost'，这是确保 Flask 应用程序正确接收来自 Docker 化的 MinIO 实例的通知的一个重要考虑因素。

更具体地说，此 Flask 应用程序被配置为接收和记录来自 MinIO 的事件。端点 /minio_event 被设置为侦听 POST 请求，这些请求预计是来自 MinIO 的事件通知。请注意，该应用程序在端口 5000 上运行，并被配置为可从所有网络接口 (0.0.0.0) 访问，这对于接收来自 Docker 容器中运行的 MinIO 的请求至关重要。

使用 Docker 网络部署 MinIO 容器

为了部署 MinIO 容器以与本地主机服务（如 Flask API）进行交互，需要特定的 Docker 网络配置。此设置对于启用容器与你的本地机器之间的无缝通信至关重要，特别是在本地开发或测试场景中。

为了实现这一点，必须将 MinIO 容器配置为使用主机的网络。这种方法允许容器直接与运行在主机上的服务（如 Flask 应用程序）进行交互。它在开发环境中特别有用，在开发环境中，Flask 应用程序需要访问或存储 MinIO 中的数据。

此配置的命令简单而强大。

docker run --name minio --network="host" minio/minio server /data

使用--network="host"选项消除了 Docker 默认网络桥接和端口转发的复杂性。它是一种更简单、更直接的方式，可确保 MinIO 容器可以访问在 localhost 上运行的任何服务，而不仅仅限于 Flask 应用程序。这使得 MinIO 容器可以灵活地用于各种本地服务，从而简化了开发和测试过程。

使用 Docker-Compose 部署 MinIO 和 Flask 应用程序容器

您可以使用 Docker 网络功能（例如自定义网络或 Docker Compose）来促进容器之间的通信。通过将两个容器都放置在同一个网络上，它们可以使用容器名称作为主机名进行通信。

使用 Docker Compose 示例来促进名为 minio 的 MinIO 容器与名为 flaskapp 的 Flask 应用程序容器之间的通信，如下面的服务中指定。

version: '3.8'
services:
  minio:
    image: minio/minio
    command: server /data
    ports:
      - "9000:9000"
    extra_hosts:
      - "host.docker.internal:host-gateway"
    networks:
      - mynetwork

  flaskapp:
    image: python:3.9 # Use an official Python image
    command: >
      sh -c "pip install Flask
      && FLASK_APP=main.py FLASK_RUN_HOST=0.0.0.0 flask run" # Install Flask and run the app
    volumes:
      - ./app:/app # Mount your Flask app directory
    working_dir: /app # Set working directory to your app directory
    ports:
      - "5000:5000"
    depends_on:
      - minio
    networks:
      - mynetwork

networks:
  mynetwork:
    driver: bridge

此设置将 host.docker.internal 映射到主机机的 IP 地址，允许容器通过添加 extra_hosts 参数来访问主机上的服务。此设置允许 MinIO 将 host.docker.internal 识别为主机机，从而弥合容器到主机的通信差距。这是一种针对常见 Docker 挑战的巧妙解决方法，确保 MinIO 可以连接到主机上的服务，例如我们的 Flask 应用程序。

此外，通过在 docker-compose 文件中包含 Flask 安装，我们将使应用程序监听 0.0.0.0。此更改对于来自其他容器和主机的可访问性至关重要，扩展了 Flask 应用程序的通信范围。对于 Flask 也可能被容器化的设置，这是一个必不可少的步骤。

Flask 服务中的 depends_on 指令确保了有序的启动顺序。通过仅在 MinIO 运行后才启动 Flask 应用程序，我们避免了潜在的计时问题。此安排模拟了生产环境，在生产环境中，服务依赖关系得到了仔细管理，从而增强了本地开发设置的健壮性。

💡

这些示例是针对 Docker 化 MinIO 设置量身定制的，确保与在主机上运行的服务有效通信。请注意安全隐患，尤其是在调整网络设置或公开端口时，并选择符合您的安全和架构需求的解决方案。

两种方法都将允许 MinIO 服务与您的 Flask 应用程序进行通信，具体取决于 Flask 应用程序是在主机上运行还是在另一个 Docker 容器内运行。

Docker 化世界中的无缝集成

我们已经深入了解了 Docker 网络的细微差别，揭示了如何有效地将 Docker 容器与 localhost 环境桥接，以便 Docker 化的 MinIO 服务可以有效地与在您的主机机上运行的 Flask 应用程序进行通信。这些见解对于希望利用 Docker 的强大功能而不影响本地开发的灵活性和便利性的开发人员至关重要。

理解 Docker 网络不仅仅是技术上的必要性，它还是掌握容器化环境的一步。能够设置和管理这些交互是当今云原生开发环境中的一个要求。无论您是在笔记本电脑上开发还是在全球范围内部署，这些技能都能确保您的应用程序保持健壮、可扩展和安全。

在开发云原生软件时，了解和实施最佳实践非常重要。Docker 生态系统不断发展。您可以使用基于容器和对象存储的架构快速利用最新和最优秀的云原生技术。保持好奇，继续探索。

MinIO 使这种探索成为可能。MinIO 是容器化的、Kubernetes 原生的并且与 S3 API 兼容，它让您可以编写在任何地方运行的代码，始终如一地可靠地运行。

祝您在 Docker 和 MinIO 的旅程中一切顺利。愿您的开发健壮、您的解决方案安全，您的学习持续不断。如果您有任何疑问，我们随时为您提供帮助，请访问 hello@min.io 或加入 Slack 社区。