2023最新版Saleor Platform配置教程：环境变量与数据库设置全攻略

2023最新版Saleor Platform配置教程：环境变量与数据库设置全攻略

【免费下载链接】saleor-platformAll Saleor services started from a single repository with docker-compose.项目地址: https://gitcode.com/gh_mirrors/sa/saleor-platform

Saleor Platform是一个功能强大的开源电商解决方案，通过Docker Compose实现所有服务的统一管理。本教程将帮助新手用户快速掌握环境变量配置与数据库设置的核心步骤，轻松搭建稳定高效的电商平台环境。

一、准备工作：获取项目代码

首先需要将项目代码克隆到本地环境，打开终端执行以下命令：

git clone https://gitcode.com/gh_mirrors/sa/saleor-platform cd saleor-platform

二、核心环境变量配置指南 🛠️

Saleor Platform使用.env文件管理环境变量，项目中包含两个关键配置文件：

1. backend.env：后端服务核心配置

该文件存储数据库连接、密钥等敏感信息，路径为backend.env。主要配置项说明：

• DATABASE_URL：数据库连接字符串，格式为postgres://用户名:密码@主机:端口/数据库名

  DATABASE_URL=postgres://saleor:saleor@db/saleor

• SECRET_KEY：应用加密密钥，生产环境必须修改为强随机字符串

  SECRET_KEY=changeme

• CELERY_BROKER_URL：Celery消息队列地址，默认使用Redis

  CELERY_BROKER_URL=redis://redis:6379/1

2. common.env：通用环境配置

该文件包含跨服务的通用设置，路径为common.env。重要配置项：

• HTTP_IP_FILTER_ENABLED：IP过滤开关，开发环境建议设为False

  HTTP_IP_FILTER_ENABLED=True

• DEFAULT_CHANNEL_SLUG：默认销售渠道标识

  DEFAULT_CHANNEL_SLUG=default-channel

⚠️ 注意：所有.env文件在修改后需要重启Docker服务才能生效

三、数据库设置全解析 🗄️

Saleor Platform默认使用PostgreSQL数据库，相关配置分散在多个文件中：

1. Docker Compose数据库配置

在docker-compose.yml文件中定义了PostgreSQL服务：

db: image: library/postgres:15-alpine ports: - 5432:5432 environment: - POSTGRES_USER=saleor - POSTGRES_PASSWORD=saleor volumes: - saleor-db:/var/lib/postgresql/data - ./replica_user.sql:/docker-entrypoint-initdb.d/replica_user.sql

主要参数说明：

• image：使用PostgreSQL 15 Alpine版本，体积小且性能优良
• ports：映射5432端口到宿主机，允许外部工具连接
• volumes：持久化存储数据库数据，并初始化副本用户

2. 数据库初始化脚本

replica_user.sql文件用于创建数据库副本用户，确保数据备份功能正常工作。

四、服务启动与验证步骤 🚀

完成上述配置后，通过以下步骤启动整个平台：

1. 启动所有服务

   docker-compose up -d

2. 检查服务状态

   docker-compose ps

3. 验证数据库连接可以使用数据库客户端连接localhost:5432，使用backend.env中配置的用户名和密码登录。

4. 访问API服务打开浏览器访问http://localhost:8000，看到API文档页面说明配置成功。

五、常见问题解决方法 ❓

1. 数据库连接失败

• 检查backend.env中的DATABASE_URL是否与docker-compose.yml中的数据库配置一致
• 确保PostgreSQL服务已正常启动：docker-compose logs db

2. 环境变量不生效

• 确认修改的是正确的.env文件
• 使用docker-compose down && docker-compose up -d完全重启服务

3. 端口冲突问题

• 修改docker-compose.yml中冲突服务的端口映射，例如将8000:8000改为8001:8000

六、最佳实践与注意事项 ⚡

1. 安全建议

   • 生产环境必须修改SECRET_KEY为随机字符串
   • 不要将.env文件提交到版本控制系统

2. 性能优化

   • 对于生产环境，考虑增加Redis和PostgreSQL的资源限制
   • 调整Celery worker的并发数以适应服务器配置

3. 维护提示

   • 定期备份saleor-db卷数据
   • 通过docker-compose logs -f监控服务运行状态

通过本教程，您已经掌握了Saleor Platform环境变量配置和数据库设置的全部要点。按照这些步骤操作，即使是新手也能快速搭建起功能完善的电商平台基础环境。如需深入了解更多配置选项，请参考项目官方文档。

【免费下载链接】saleor-platformAll Saleor services started from a single repository with docker-compose.项目地址: https://gitcode.com/gh_mirrors/sa/saleor-platform