Pezzo项目Docker部署环境变量配置指南

前言

Pezzo作为一个开源项目，在本地开发环境搭建过程中可能会遇到环境变量配置相关的问题。本文将详细介绍如何正确配置Pezzo项目所需的各类环境变量文件，确保Docker容器能够顺利启动。

环境变量文件缺失问题分析

在Pezzo项目使用Docker Compose部署时，系统会提示多个环境变量文件缺失的错误。这主要是因为项目依赖多个环境配置文件来初始化各个服务组件。常见的缺失文件包括：

1. 根目录下的.env文件
2. 根目录下的.env.docker文件
3. 各子应用目录下的.env文件
4. 本地开发专用的.env.local文件

解决方案详解

基础环境变量配置

首先需要在项目根目录创建.env.docker文件，内容至少包含：

SUPERTOKENS_DATABASE_URL=
DATABASE_URL=postgresql://postgres:postgres@postgres:5432/pezzo

核心服务配置

在项目根目录创建.env文件，内容建议如下：

PINO_PRETTIFY="true"
SUPERTOKENS_CONNECTION_URI="http://supertokens:3567"
CONSOLE_HOST="http://pezzo-console:4200"
KAFKA_BROKERS="kafka:9092"
OPENSEARCH_URL="http://opensearch:9200"
REDIS_URL="redis://redis-stack-server:6379"

前端控制台配置

在apps/console目录下，需要从.env.example复制创建.env文件：

NX_BASE_API_URL="http://localhost:3000"
NX_SUPERTOKENS_API_DOMAIN="http://localhost:3000"
NX_SUPERTOKENS_WEBSITE_DOMAIN="http://localhost:4200"
NX_DEBUG_MODE="true"

本地开发配置

对于本地开发环境，还需要在适当位置创建.env.local文件，内容可根据实际开发需求调整。

Docker Compose文件调整建议

1. 移除过时的version声明
2. 确保SuperTokens数据库连接配置正确
3. 检查各服务的环境变量引用路径

部署验证

完成上述配置后，执行docker compose up命令应该能够顺利启动所有服务容器。如果仍有问题，建议：

1. 检查各环境文件路径是否正确
2. 确认文件权限设置
3. 查看容器日志定位具体问题

总结

Pezzo项目的Docker部署需要多个环境配置文件的协同工作。通过系统地创建和配置这些文件，开发者可以避免常见的环境变量缺失问题，顺利搭建本地开发环境。建议开发者根据实际部署环境和需求，灵活调整各环境变量的具体值。