prefecthq/prefect-client

镜像概述

本镜像为Prefect客户端的优化版本，旨在提供轻量级、高性能的客户端环境，用于与Prefect工作流编排平台（包括Prefect Server和Prefect Cloud）进行交互。通过该镜像，用户可便捷地完成工作流的创建、提交、运行及监控等核心操作，适用于开发、测试及生产环境中的工作流管理需求。

核心功能与特性

• 轻量级设计：基于精简基础镜像构建，减少资源占用，适合资源受限环境部署
• 性能优化：针对客户端关键操作（如工作流提交、状态查询、日志获取）进行性能调优，提升响应速度
• 版本兼容：与最新稳定版Prefect服务保持兼容，支持Prefect API的完整功能集
• 灵活配置：支持通过环境变量、配置文件或命令行参数自定义客户端连接信息及运行参数
• 多平台适配：兼容Docker、Kubernetes等主流容器化部署环境，支持x86_64及ARM架构

使用场景

• 开发环境：本地开发工作流时，作为客户端与Prefect Server交互，验证工作流逻辑及运行效果
• 生产环境：在容器化生产环境中提交工作流至Prefect服务，监控任务执行状态并处理异常
• 自动化流水线：集成至CI/CD流程，实现工作流的自动化测试、打包与部署
• 边缘计算：在边缘节点部署轻量级客户端，提交分布式工作流任务并收集执行结果

使用方法与配置说明

基本使用（docker run）

通过以下命令启动Prefect客户端容器，连接至Prefect服务并执行基础操作：

bash
docker run --rm docker.xuanyuan.run/prefecthq/prefect:latest prefect --help

连接Prefect服务

通过环境变量配置Prefect API连接信息，示例如下：

bash
docker run -e PREFECT_API_URL="https://api.prefect.cloud/api/accounts/<account_id>/workspaces/<workspace_id>" \
           -e PREFECT_API_KEY="<your-api-key>" \
           docker.xuanyuan.run/prefecthq/prefect:latest \
           prefect flow run /path/to/flow.py

环境变量配置

挂载工作流文件

将本地工作流文件挂载至容器，运行自定义工作流：

bash
docker run -v $(pwd)/workflows:/workflows \
           -e PREFECT_API_URL="https://api.prefect.cloud/..." \
           docker.xuanyuan.run/prefecthq/prefect:latest \
           prefect flow run /workflows/my_workflow.py

持久化配置

挂载Prefect配置目录以持久化客户端配置（如API地址、认证信息等）：

bash
docker run -v ~/.prefect:/root/.prefect \
           docker.xuanyuan.run/prefecthq/prefect:latest \
           prefect config set api_url="https://api.prefect.cloud/..."

交互式使用

启动交互式终端，手动管理工作流：

bash
docker run -it --rm \
           -e PREFECT_API_URL="https://api.prefect.cloud/..." \
           -v $(pwd)/workflows:/workflows \
           docker.xuanyuan.run/prefecthq/prefect:latest \
           /bin/bash

注意事项

• 确保PREFECT_API_URL指向正确的Prefect服务地址，Prefect Server默认地址为http://<server-ip>:4200/api
• 使用Prefect Cloud时，需通过PREFECT_API_KEY配置有效的API密钥（可在Prefect Cloud控制台创建）
• 生产环境建议挂载持久卷存储工作流文件及客户端配置，避免容器重启后配置丢失