一、引言：为何选择Docker部署Flink单机版？

Apache Flink作为流批一体的计算框架，在实时数据处理领域占据重要地位。单机部署是其最基础的运行模式，适合开发测试、小型数据处理或学习场景。而Docker的轻量化、隔离性和可移植性，使得Flink的部署摆脱了复杂的依赖管理和环境配置问题，尤其适合以下场景：

快速验证：开发者可快速拉起Flink环境，验证作业逻辑。
资源隔离：避免与其他服务冲突，保证运行稳定性。
跨平台一致：无论本地开发机（Mac/Linux/Windows）还是服务器，环境保持一致。

二、环境准备：前置条件与工具安装

1. 硬件与系统要求

CPU：至少2核（推荐4核以上）。
内存：4GB以上（生产级作业建议8GB+）。
磁盘：10GB以上可用空间（日志和检查点存储）。
操作系统：Linux（推荐Ubuntu/CentOS）、MacOS或Windows（需WSL2或Docker Desktop）。

2. Docker安装与配置

Linux：通过包管理器安装（如apt install docker.io或yum install docker），启动服务并添加用户到docker组。
MacOS/Windows：下载并安装Docker Desktop，启用Kubernetes（可选）。
验证安装：运行docker --version和docker run hello-world确认正常。

3. 网络与端口配置

Flink默认使用以下端口：

8081：Web UI（任务管理和监控）。
6123：内部通信（JobManager与TaskManager）。
9000：数据端口（如使用HDFS或S3时）。
确保防火墙放行这些端口，或通过-p参数映射到主机。

三、Docker镜像选择与拉取

1. 官方镜像来源

Flink官方提供Docker镜像，可通过以下方式获取：

Docker Hub：apache/flink（最新稳定版）。
自定义构建：从Flink GitHub克隆代码，通过docker build构建。

2. 常用镜像标签

latest：最新稳定版（如1.17.0）。
1.17.0-scala_2.12-java11：指定Scala和Java版本。
hadoopXX-scala_2.12：集成Hadoop的镜像（用于HDFS读写）。

示例命令：

docker pull apache/flink:1.17.0-scala_2.12-java11

四、单机部署模式详解

Flink单机部署支持两种模式：独立集群（Standalone）和会话模式（Session Cluster）。

1. 独立集群模式（推荐）

启动一个包含JobManager和TaskManager的容器，适合长期运行的任务。

步骤：

启动JobManager：

docker run --name flink-jobmanager -d -p 8081:8081 \
  -t apache/flink:1.17.0-scala_2.12-java11 jobmanager

启动TaskManager（需链接到JobManager）：

docker run --name flink-taskmanager -d \
  --link flink-jobmanager:jobmanager \
  -t apache/flink:1.17.0-scala_2.12-java11 taskmanager

验证：访问http://localhost:8081，查看Web UI是否显示1个TaskManager。

2. 会话模式（Session Cluster）

适用于临时提交多个作业的场景，通过一个容器管理所有组件。

命令：

docker run --name flink-session -d -p 8081:8081 \
  -t apache/flink:1.17.0-scala_2.12-java11 standalone-job

提交作业时，通过docker exec进入容器或使用REST API。

五、数据卷与持久化配置

1. 挂载本地目录

将本地目录挂载到容器，实现作业文件和检查点的持久化。

示例：

docker run --name flink-persistent -d -p 8081:8081 \
  -v /path/to/local/jobs:/opt/flink/usrlib \
  -v /path/to/checkpoints:/tmp/flink/checkpoints \
  apache/flink:1.17.0-scala_2.12-java11 jobmanager

2. 配置文件覆盖

通过-e或挂载flink-conf.yaml自定义配置：

docker run --name flink-custom-config -d -p 8081:8081 \
  -v /path/to/flink-conf.yaml:/opt/flink/conf/flink-conf.yaml \
  apache/flink:1.17.0-scala_2.12-java11 jobmanager

关键配置项：

jobmanager.rpc.address：JobManager主机名（默认jobmanager）。
taskmanager.numberOfTaskSlots：每个TaskManager的槽位数（默认1）。

六、提交作业与监控

1. 提交Flink作业

方法1：通过Web UI上传JAR文件。

方法2：使用docker exec进入容器提交：

docker exec -it flink-jobmanager /opt/flink/bin/flink run \
  -c com.example.MainClass /opt/flink/usrlib/your-job.jar

方法3：通过REST API（需配置认证）：

curl -X POST -F "jarfile=@/path/to/job.jar" http://localhost:8081/jars/upload

2. 监控与日志

Web UI：实时查看作业状态、指标和日志。
容器日志：
```
docker logs -f flink-jobmanager
```
Prometheus集成：通过metrics.reporter.prom.class配置Prometheus端点。

七、常见问题与解决方案

1. 端口冲突

问题：8081端口被占用。
解决：修改主机端口映射：

docker run --name flink-custom-port -d -p 8082:8081 \
  apache/flink:1.17.0-scala_2.12-java11 jobmanager

2. TaskManager无法连接JobManager

问题：容器间网络不通。
解决：

使用--network host（仅Linux）或自定义Docker网络：

docker network create flink-net
docker run --name flink-jobmanager --network flink-net ...
docker run --name flink-taskmanager --network flink-net ...

在flink-conf.yaml中显式设置jobmanager.rpc.address为容器名或IP。

3. 内存不足

问题：作业因OOM失败。
解决：通过环境变量调整内存：

docker run --name flink-high-mem -d -p 8081:8081 \
  -e JOB_MANAGER_HEAP_SIZE=2048m \
  -e TASK_MANAGER_HEAP_SIZE=4096m \
  apache/flink:1.17.0-scala_2.12-java11 jobmanager

八、进阶优化建议

资源限制：通过--cpus和--memory限制容器资源。
多TaskManager：启动多个TaskManager容器实现并行。
日志收集：集成ELK或Fluentd集中管理日志。
自动重启：使用--restart unless-stopped策略。

九、总结与展望

通过Docker部署Flink单机版，开发者可以快速搭建一个轻量级、可复用的实时计算环境。本文从环境准备、镜像选择、部署模式到监控优化，提供了完整的实践指南。未来，随着Flink与Kubernetes的深度集成，容器化部署将成为主流，建议读者进一步探索Flink on Kubernetes的自动化运维方案。

Flink单机Docker部署全攻略：从零到跑的完整指南