prefecthq/prefect-client-dev

Prefect客户端（开发版）优化镜像

概述

本镜像为Prefect工作流管理工具的客户端提供优化的Docker运行环境，专为开发场景设计。包含Prefect客户端的最新开发版本，集成未发布的功能特性，旨在为开发者提供高效的工作流开发、测试和调试环境。

核心功能与特性

• 开发环境优化：针对本地开发和CI/CD流程优化，启动速度快，资源占用低
• 最新开发特性：基于Prefect客户端开发分支构建，包含最新未发布功能，支持提前验证新特性
• 完整工具链：内置prefect命令行工具及所有依赖组件，支持工作流定义、部署、执行与监控
• 轻量级设计：基于Alpine Linux构建，镜像体积小，适合本地开发和测试环境快速部署

使用场景

• 本地工作流开发：开发者在本地环境构建、调试和测试Prefect工作流定义
• 新功能验证：测试Prefect客户端的最新开发特性，验证工作流兼容性
• 集成测试环境：作为CI/CD管道的测试步骤，确保工作流与最新客户端版本兼容
• 多版本测试：快速切换客户端开发版本，测试不同版本间的功能差异

使用方法

基本使用

拉取并启动镜像，验证客户端版本：

bash
# 拉取最新开发版镜像
docker pull docker.xuanyuan.run/prefecthq/prefect:dev-client

# 启动容器并查看客户端版本
docker run -it --rm docker.xuanyuan.run/prefecthq/prefect:dev-client prefect --version

连接Prefect服务器

连接到本地或远程Prefect服务器（需提前部署Prefect Server或使用Prefect Cloud）：

bash
docker run -it --rm \
  -e PREFECT_API_URL="http://your-prefect-server:4200/api" \  # 服务器API地址
  -e PREFECT_API_KEY="your-api-key" \                       # 若使用认证（如Prefect Cloud）
  prefecthq/prefect:dev-client \
  prefect work-queue inspect "default"  # 示例：查看默认工作队列信息

挂载本地工作流代码

将本地开发的工作流代码挂载到容器中进行测试：

bash
docker run -it --rm \
  -v $(pwd)/my_workflows:/app/workflows \  # 挂载本地工作流目录
  -w /app/workflows \                      # 设置工作目录
  -e PREFECT_API_URL="http://host.docker.internal:4200/api" \  # 连接本地主机的Prefect服务器
  prefecthq/prefect:dev-client \
  prefect deployment build ./my_flow.py:main_flow -n dev-test  # 构建工作流部署配置

持久化配置

挂载本地Prefect配置目录，实现配置持久化：

bash
docker run -it --rm \
  -v ~/.prefect:/root/.prefect \  # 挂载本地配置目录
  prefecthq/prefect:dev-client \
  prefect config set api_url="http://your-server:4200/api"  # 持久化设置API地址

环境变量配置

注意事项

• 非生产环境使用：开发版镜像可能包含不稳定特性，严禁用于生产环境
• 定期更新：开发分支迭代频繁，建议定期执行docker pull获取最新版本
• 配置持久化：本地开发建议挂载~/.prefect目录，避免重复配置
• 网络配置：连接本地主机服务时，使用host.docker.internal（Docker Desktop）或宿主机IP地址