Saleor 01: 入门 - 在 macOS 上安装


准备工作

在正式运行 Saleor 之前,需要在电脑上安装一些额外软件。

Node.js

建议是 Version 8 或更高版本。

Node.js downloads page

PostgreSQL

运行 Saleor 需要 PostgreSQL version 9.4 或更高版本。

PostgreSQL download page

你一定要记住在安装的时候所设定的管理员密码。

Command Line Tools for Xcode

下载并安装最新版本的 “Command Line Tools (macOS 10.x) for Xcode 9.x”.

Downloads for Apple Developers page

然后运行:

$ xcode-select --install

Homebrew

运行下面的命令安装 Homebrew:

$ /usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"

Python 3

使用 Homebrew 安装最新版本的 Python 3:

$ brew install python3

Git

使用 Homebrew 安装 Git:

$ brew install git

Gtk+

使用 Homebrew 安装 the graphical libraries necessary for PDF creation:

$ brew install cairo pango gdk-pixbuf libffi

安装

  1. 克隆这个仓库 (或是使用你自己的副本):

    $ git clone https://github.com/mirumee/saleor.git
    
  2. 进入目录:

    $ cd saleor/
    
  3. 安装依赖库:

    在安装任何 Python 包之前,我们强烈推荐先创建一个虚拟环境。

    creating a virtual environment

    $ pip install -r requirements.txt
    
  4. 设置一个环境变量 SECRET_KEY :

    我们有想过设一个默认值,但是我们最终决定不设默认值,因为怕有人直接用这个默认值上了生产环境,所以还是由你自己来设一个。

    $ export SECRET_KEY='<mysecretkey>'
    

    Warning

    秘钥(Secret key)应该是一个只有你们团队自己知道的独一无二的字符串,使用一个别人可能知道的 SECRET_KEY 会破坏 Django 的许多安全性保护,并可能导致特权升级和远程代码执行漏洞。

    参考:Django’s documentation

  5. 创建一个 PostgreSQL 用户:

    除非你已经设置过,否则商店的用户名和密码都默认是 saleor ,请记得给你的用户设置 SUPERUSER 权限,这样它才可以创建数据库和数据库扩展。

    $ createuser --superuser --pwprompt saleor
    

    当提示需要密码的时候输入 saleor

  6. 准备数据库:

    $ python manage.py migrate
    

    Warning

    这个命令需要有创建数据库扩展的权限,如果你收到与 CREATE EXTENSION 相关的错误信息请参考用户创建步骤的说明。

  7. 安装前端依赖库:

    $ npm install
    

    Note

    如果这一步安装失败请回到上面去确认下使用的 Node.js 版本是不是足够新。

  8. 准备前端资源文件:

    $ npm run build-assets
    
  9. 编译电子邮件:

    $ npm run build-emails
    
  10. 启动开发服务器:

    $ python manage.py runserver