saleor安装历程

windows系统基于docker安装

✍首先安装docker：

参考docker安装 Windows 容器化-安装 docker - 知乎 (zhihu.com)
1.windows 的docker安装完毕后，会报错

原因：window自带的Linux的 WSL版本过低
解决：win+r ，打开命令提示符，输入 wsl –update

2.重启，正常。

1.克隆项目

1. 进入想建立项目的文件夹，在地址栏中输入cmd
   
   显示这个界面：
   

2. 在终端内输入以下命令：

git clone https://github.com/saleor/saleor-platform.git
cd saleor-platform
docker compose build #此命令需要提前将docker启动

2.开启代码实时代码重加载

在 Windows 中使用 Docker 时，你可以通过目录映射来共享主机上的文件夹到 Docker 容器内。这样，你就可以在容器内操作主机上的文件，也可以将容器内的文件保存到主机上。

1.共享文件夹

进入docker desktop，进入setting->general 去掉勾选 “use the wsl2 base engine”选项，点击应用后会自动重启。

开启文件共享

2.配置专用内存

配置docker的专用内存，确保大于5GB，之后在右下角点击重启docker。

3.迁移数据库

docker compose run --rm api python3 manage.py migrate
//（可选）使用示例数据填充数据库：
docker compose run --rm api python3 manage.py populatedb

迁移数据过程中，docker弹出共享文件的请求，点击确认共享即可。

后面会加载一长串的runing migrations

4.创建管理员账户

//cmd中运行
docker compose run --rm api python3 manage.py createsuperuser

5.运行服务

使用以下命令运行所有 Saleor 容器（从目录中）：saleor-platform

docker compose up

后面是服务启动过程

可以看到，能够访问网站后台 http://localhost:9000/ , 并需要登录管理员账号

访问一下前台商店：http://localhost:8000/

恭喜您成功设置好 Saleor 实例！以下是一些有用的链接，帮助您开始搭建电子商务平台：

1. Saleor 文档: 这是 Saleor 的官方文档，提供了关于 Saleor 各个方面的详细信息，包括安装、配置、定制和使用等。您可以参考文档中的逐步指南和详细解释。这是链接：Saleor 文档

2. Saleor 商店后台: Saleor 商店后台是您管理电子商务店铺的管理界面。您可以在后台管理产品、订单、客户和其他重要方面。通过访问 Saleor 实例的管理 URL，您可以进入 Saleor 商店后台。例如，如果您的 Saleor 实例在本地运行，URL 可能是 http://localhost:8000/dashboard。

3. Saleor 商店前台: Saleor 商店前台是您电子商务店铺的公共界面，客户可以在此浏览和购买产品。通过访问 Saleor 实例的 URL，您可以进入 Saleor 商店前台。例如，如果您的 Saleor 实例在本地运行，URL 可能是 http://localhost:8000。

4. GraphQL API: Saleor 提供了一个 GraphQL API，用于以编程方式与电子商务数据进行交互。您可以使用 GraphQL API 检索产品、创建订单、管理客户等。API 文档提供了有关可用查询、变异和订阅的详细信息。您可以通过访问 Saleor 实例的 GraphQL 端点来探索 GraphQL API。例如，如果您的 Saleor 实例在本地运行，GraphQL 端点可能是 http://localhost:8000/graphql。

Linux安装

本文基于腾讯云安装，使用cent os系统。

安装docker

1.使用root权限

要先将旧版本docker卸载，再安装新版本docker，卸载时需要获取root，输入两次密码

sudo passwd root

输入以下命令切换到root用户

su

2.卸载旧版docker

在安装 docker-ce 之前，要先卸载旧版本：

# Ubuntu
apt-get remove docker docker-engine docker.io
# CentOS
yum remove docker docker-common docker-selinux docker-engine 

3.安装新版docker

现在要安装最新版的 Docker 软件包，就是使用 docker-ce 这个名称了，如果是商业版的就是 docker-ee。

# Ubuntu
apt-get install docker-ce
# CentOS
yum install docker-ce

4.安装新版docker compose

$ sudo yum update
$ sudo yum install docker-compose-plugin

验证是否安装最新版

$ docker compose version

5.查找安装的位置（非必要步骤）

使用 rpm 命令：

rpm -qa --last
这将列出按安装时间排序的所有软件包，最近安装的软件包将显示在列表的顶部

（非必要步骤）使用 rpm -qi 命令加上软件包名称来查看软件信息

rpm -qi example-package

查看docker-ce软件包所在的文件位置

rpm -ql docker-ce

6.启动docker

启动docker

systemctl start docker 

查看docker状态

systemctl status docker

7.cent os 安装git

卸载老版本git

yum remove git -y

查看新版本git，得到新版本的版本号

yum provides git

安装新版本git，使用新的版本号

yum install git-1.8.3.1-25.el7_9.x86_64  -y

或者直接用以下命令安装最新版git

sudo yum install -y git

验证git是否安装完成

git --version

7.使用docker安装saleor（根据官方教程）

1. 克隆github仓库和构建docker镜像

git clone https://github.com/saleor/saleor-platform.git
cd saleor-platform
docker compose build

1. 拉取saleor的迁移数据库
   因为不是windows和Macos，所以不需要去docker上配置共享文件夹和docker内存

docker compose run --rm api python3 manage.py migrate

7.查看docker镜像

docker images

安装saleor core

saleor 官方总安装指导：使用 Docker 安装 |销售商贸文档 (saleor.io)

官方直达链接 Package saleor (github.com)

使用docker拉取镜像文件

安装命令：

docker pull ghcr.io/saleor/saleor:unstable-main

docker容器默认拉取文件的位置在 /var/lib/docker下

使用官方的saleor core 图片

官方直达链接 Package saleor (github.com)
安装命令：

docker pull ghcr.io/saleor/saleor:3.16.1  # 根据官方提供的最新的换，数字前面不能有空格

从零开始构建

如果要自己构建映像，请在目录中使用：docker build``saleor

cd saleor
docker build -t <yourimagename> .

2.修改docker拉取下载后的文件夹权限（需要在root权限下修改）

将文件夹设置为所有用户可读、写和执行

chmod 777 /var/lib/docker

将文件夹设置为所有用户只读和执行，但不可写：

chmod 755 /var/lib/docker

将文件夹设置为仅对所有者可读、写和执行，其他用户没有权限：

chmod 700 /var/lib/docker

修改文件夹及其子文件夹权限的示例：

chmod -R permissions folder
chmod -R 777 /var/lib/docker

安装 saleor-dashboard （控制面板）

官方直达链接Package saleor-dashboard (github.com)
安装命令：

docker pull ghcr.io/saleor/saleor-dashboard:3.16.1

从零构建

需要在docker中进入saleor-dashboard目录去创建你自己的文件夹，命令入下：

cd saleor-dashboard
docker build -t <yourimagename> .

创建容器docker

基础知识：入门时应完全掌握的 6 个 Docker 基础知识 ·vsupalov.com

1.执行创建容器命令

// 创建saleor:unstable-main  即saleor core
docker run --name my-saleor-container -d ghcr.io/saleor/saleor:unstable-main

// 创建 ghcr.io/saleor/saleor:3.16.1 即saleor-core-image
docker run --name my-saleor-core-image -d ghcr.io/saleor/saleor:3.16.1

//创建 saleor-dashboard:3.16.1
docker run --name my-saleor-dashboard -d ghcr.io/saleor/saleor-dashboard:3.16.1

2.查看正在运行的容器

docker ps

3.创建容器的docker-compose.yml

创建容器后，不会直接生成 docker compose.yml ——配置文件

• 这里是docker-compose.yml的简介：docker compose 配置文件 .yml 全面指南 - 知乎 (zhihu.com)

1.确认自己的docker version与安装的 dockers-compose version相匹配

1. 运行以下命令来查看已安装的Docker版本：

docker version

1. 运行以下命令来查看已安装的Docker Compose版本：

docker-compose version

出现docker-compose问题

如果在运行 docker-compose version 命令时出现 “bash: docker-compose: command not found” 错误，这意味着您的系统上没有安装 Docker Compose 或者它没有正确配置。
本文根据cent os系统进行安装

1. 运行以下命令来下载 Docker Compose 的最新版本：

sudo curl -L "https://github.com/docker/compose/releases/latest/download/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose

1. 授予执行权限：

sudo chmod +x /usr/local/bin/docker-compose

1. 验证安装：

docker-compose version

3.查找容器的项目所在位置

docker exec -it <container_id_or_name> /bin/bash

在Ubuntu 20.04 系统上部署 saleor

1.使用root权限

要先将旧版本docker卸载，再安装新版本docker，卸载时需要获取root，输入两次密码

sudo passwd root

输入以下命令切换到root用户

su

2.Ubuntu 20.04安装git

卸载老版本git

apt remove git -y

查看新版本git，得到新版本的版本号

apt provides git

安装新版本git，使用新的版本号

apt install git-1.8.3.1-25.el7_9.x86_64  -y

或者直接用以下命令安装最新版git

sudo apt install -y git

验证git是否安装完成

git --version

安装Ubuntu 20.04中saleor一键部署（deploy-saleor.sh）所需的各种环境

安装Nginx

sudo apt update                #升级系统软件包
sudo apt install nginx         #安装Nginx

安装PHP7.4

sudo apt -y install php-fpm
sudo php -v # 查看PHP版本。

安装cerbot

apt install python3-certbot-nginx

deploy-saleor.sh 安装

1. 以 sudoer 身份登录，并将此存储库克隆到将安装 Saleor 和 Saleor Desktop 的 sudo 用户的主目录中。

git clone https://github.com/thewhiterabbit/Deploy_Saleor.git

1. 使用 sudo，从主目录运行 deploy.sh 脚本。

sudo bash Deploy_Saleor/deploy.sh
sudo bash Deploy_Saleor/deploy-dashboard.sh

1. 运行 certbot 以设置 SSL。

sudo certbot --nginx -d your.domain #按提示选择，重定向选择2以更改为https

证书到期后再次运行cerbot，并选择“certonly”选项，如果要非交互式的更新所有证书，运行“certbot renew”

恭喜您成功启用了 <your.domain> 的 HTTPS！

为了测试您的配置并确保 SSL/TLS 设置的安全性，您可以访问以下链接：
https://www.ssllabs.com/ssltest/analyze.html?d=<your.domain>

以下是一些关于您的证书的重要说明：

• 您的证书和证书链已保存在 /etc/letsencrypt/live/<your.domain>/fullchain.pem 文件中。
• 您的密钥文件已保存在 /etc/letsencrypt/live/<your.domain>/privkey.pem 文件中。
• 您的证书将在2023年12月29日过期。要在将来获取新的或修改过的证书版本，只需再次运行 Certbot，并选择 “certonly” 选项。若要非交互式地更新所有证书，请运行 “certbot renew” 命令。
• 您的帐户凭据已保存在 Certbot 的配置目录中，路径为 /etc/letsencrypt。建议创建一个安全备份该文件夹，因为它包含了 Certbot 获取的证书和私钥等重要信息。
• 如果您喜欢 Certbot，请考虑通过以下方式支持他们的工作：
  • 向 ISRG / Let’s Encrypt 捐赠：https://letsencrypt.org/donate
  • 向 EFF（电子前沿基金会）捐赠：https://eff.org/donate-le。
  • 您的支持将有助于持续发展和维护安全证书服务。

如果有任何其他问题，我将乐意为您提供帮助！

1. 在以下文件中将 http 替换为 https：

/var/www/your.domain/dashboard/index.html
/var/www/your.domain/dashboard/dashboard.randomstring.js

注意：将 /dashboard/ 替换为您在安装脚本期间输入的 URI。
find /path/to/search -name “index.html”
find / -type d -name “dashboard.randomstring.js”
Ainidewei$&$548926ainidewei
sudo ln -s /etc/nginx/sites-available/saleor /etc/nginx/sites-enabled/saleor
sudo systemctl reload nginx
sudo systemctl restart nginx

saleor developer（win11）

官方安装步骤The Enterprise Open Source Commerce – Saleor Commerce

saleor开发环境搭建

克隆saleor

进入想克隆saleor项目的文件夹，在搜索栏上输入cmd，执行以下命令，如果没有git和docker，先下载安装

git clone https://github.com/saleor/saleor-platform.git --recursive --jobs 3
cd saleor-platform 
docker-compose build

获取saleor数据库

docker-compose run --rm api python3 manage.py migrate
docker-compose run --rm api python3 manage.py collectstatic --noinput

可选部署

创建管理员账号

docker-compose run --rm api python3 manage.py createsuperuser

使用示例数据填充数据库

docker-compose run --rm api python3 manage.py populatedb --createsuperuser

提示

以上要使用这个账号密码登录管理账号： admin@example.com / admin

安装saleor的python 开发框架（也可用别的框架）

官网直达：mirumee/saleor-app-framework-python: Python Saleor App/Extension boilerplate. Batteries included. (github.com)

基于pip安装（可选pip或poetry）

pip install git+https://github.com/saleor/saleor-app-framework-python.git@main

使用

官方文档直达 Saleor App Framework (mirumee.github.io)