Pezzo多环境部署实战开发、测试和生产环境配置指南【免费下载链接】pezzo️ Open-source, developer-first LLMOps platform designed to streamline prompt design, version management, instant delivery, collaboration, troubleshooting, observability and more.项目地址: https://gitcode.com/gh_mirrors/pe/pezzoPezzo是一个开源、面向开发者的LLMOps平台旨在简化提示设计、版本管理、即时交付、协作、故障排除和可观测性。本指南将详细介绍如何在Pezzo中配置和管理多环境部署帮助您在不同阶段开发、测试、生产中高效管理AI提示。为什么需要多环境管理在AI应用开发中多环境管理至关重要。开发环境用于原型设计和实验测试环境用于验证提示效果生产环境则确保稳定可靠的AI服务。Pezzo的环境管理系统让您能够在不同环境中隔离和管理提示版本避免开发中的变更影响线上服务。环境管理基础配置Pezzo的环境管理功能位于apps/server/src/app/identity/environments.service.ts提供了完整的环境CRUD操作。您可以通过API或控制台界面创建、查看和删除环境。在环境列表界面您可以轻松创建新的环境例如Development、Staging和Production。每个环境都有独立的配置和权限设置确保数据隔离和安全。开发环境配置指南1. 本地开发环境搭建使用Docker Compose快速搭建本地开发环境git clone https://gitcode.com/gh_mirrors/pe/pezzo cd pezzo docker-compose up -d查看docker-compose.yaml文件了解Pezzo的完整服务架构。本地环境包含pezzo-server: 主服务器端口3000pezzo-console: 管理控制台端口4200pezzo-proxy: API代理端口3001PostgreSQL: 数据库Redis: 缓存服务ClickHouse: 分析数据库2. 环境变量配置Pezzo支持多级环境变量文件优先级从高到低./.env.local(本地覆盖)./.env.docker(Docker配置)./.env(基础配置)开发环境建议配置NODE_ENVdevelopment DATABASE_URLpostgresql://postgres:passwordlocalhost:5432/pezzo_dev REDIS_URLredis://localhost:6379测试环境配置实战1. 创建测试环境在Pezzo控制台中点击Environments页面上的 New Environment按钮创建名为Staging的测试环境。测试环境应该模拟生产环境的配置但使用测试API密钥和沙箱数据。2. 提示版本管理测试环境是验证提示变更的理想场所。在apps/server/src/app/prompt-environments/prompt-environments.resolver.ts中Pezzo提供了提示发布到特定环境的功能Mutation(() PromptEnvironment) async publishPrompt( Args(data) data: PublishPromptInput ) { const environment await this.environmentsService.getById(data.environmentId); // 发布逻辑 }在提示编辑器中您可以编写和测试提示内容配置AI模型参数如Temperature、Max Tokens管理动态变量预览提示效果3. 自动化测试集成将Pezzo测试环境集成到CI/CD流水线中# GitHub Actions示例 - name: 测试Pezzo提示 run: | curl -X POST http://staging.pezzo.example.com/api/prompts/test \ -H Authorization: Bearer ${{ secrets.PEZZO_API_KEY }} \ -H Content-Type: application/json \ -d {promptId: test-prompt, variables: {}}生产环境部署最佳实践1. 生产环境配置生产环境需要更高的安全性和可靠性配置NODE_ENVproduction SUPERTOKENS_CONNECTION_URIhttp://supertokens:3567 CLICKHOUSE_HOSTclickhouse REDIS_URLredis://redis-stack-server:6379 KMS_LOCAL_ENDPOINThttp://local-kms:99812. 高可用性部署参考docker-compose.yaml中的健康检查配置healthcheck: test: [CMD-SHELL, curl http://pezzo-server:3000/api/healthz] interval: 10s timeout: 5s retries: 5建议的生产部署架构负载均衡: 使用Nginx或Traefik作为反向代理数据库集群: PostgreSQL主从复制缓存集群: Redis Sentinel或Cluster监控: 集成Prometheus和Grafana3. 提示发布流程生产环境发布应采用严格的审批流程在开发环境中创建和测试提示发布到测试环境进行验证通过代码审查和QA测试使用蓝绿部署或金丝雀发布到生产环境环境间数据隔离策略1. 数据库隔离Pezzo支持为不同环境配置独立的数据库连接开发环境:pezzo_dev测试环境:pezzo_staging生产环境:pezzo_prod2. API密钥管理不同环境应使用不同的API密钥开发环境: OpenAI沙箱密钥测试环境: 测试专用密钥生产环境: 正式环境密钥通过apps/server/src/app/credentials/provider-api-keys.service.ts管理各环境的API密钥配置。监控与可观测性1. 环境指标监控Pezzo提供详细的提示执行指标监控关键监控指标包括Total Cost: 成本监控和优化Total Tokens: Token使用量分析Total Executions: 执行频率统计Avg. Execution Duration: 性能监控2. 日志与追踪配置环境特定的日志级别开发环境: DEBUG级别详细日志测试环境: INFO级别关键信息生产环境: WARN/ERROR级别仅记录异常环境切换与回滚1. 快速环境切换使用Pezzo客户端库轻松切换环境import { Pezzo } from pezzo/client; const pezzo new Pezzo({ apiKey: process.env.PEZZO_API_KEY, environment: process.env.NODE_ENV production ? production : development });2. 版本回滚机制当生产环境出现问题时Pezzo支持快速回滚到之前的提示版本。通过apps/server/src/app/prompts/prompts.service.ts中的版本管理功能您可以轻松恢复稳定版本。安全最佳实践1. 环境隔离使用独立的网络隔离各环境配置不同的防火墙规则实施最小权限原则2. 敏感数据保护环境变量加密存储API密钥定期轮换访问日志审计总结Pezzo的多环境部署功能为AI应用开发提供了完整的解决方案。通过合理的环境配置和管理您可以提高开发效率在隔离的环境中安全地实验和迭代确保质量在测试环境中充分验证提示效果保障稳定生产环境的严格控制和监控优化成本不同环境使用不同的资源配置无论是小型团队还是大型企业Pezzo的环境管理系统都能帮助您构建可靠、可扩展的AI应用架构。立即开始配置您的多环境部署体验高效的LLMOps工作流【免费下载链接】pezzo️ Open-source, developer-first LLMOps platform designed to streamline prompt design, version management, instant delivery, collaboration, troubleshooting, observability and more.项目地址: https://gitcode.com/gh_mirrors/pe/pezzo创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考