-
Notifications
You must be signed in to change notification settings - Fork 900
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Merge pull request #158 from saleor/3.5
Upgrade to Saleor 3.5.x and introduce Make commands
- Loading branch information
Showing
6 changed files
with
66 additions
and
35 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1 @@ | ||
.idea |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,11 @@ | ||
bootstrap: | ||
docker-compose build | ||
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 populatedb --createsuperuser | ||
run: | ||
docker-compose up | ||
run-backend: | ||
docker-compose up api worker | ||
upgrade: | ||
git submodule update --remote |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
|
@@ -10,10 +10,32 @@ All Saleor services started from a single repository | |
|
||
## How to run it? | ||
|
||
### With Makefile | ||
You can run few make commands | ||
|
||
#### Bootstrap app | ||
```shell | ||
make | ||
``` | ||
|
||
#### Run all services | ||
```shell | ||
make run | ||
``` | ||
|
||
#### Run only backend services | ||
```shell | ||
make run-backend | ||
``` | ||
|
||
See [Makefile](Makefile) for all commands | ||
|
||
### With Docker steps | ||
|
||
1. Clone the repository: | ||
|
||
``` | ||
$ git clone https://github.com/saleor/saleor-platform.git --recursive --jobs 3 | ||
git clone https://github.com/saleor/saleor-platform.git --recursive --jobs 3 | ||
``` | ||
|
||
2. We are using shared folders to enable live code reloading. Without this, Docker Compose will not start: | ||
|
@@ -22,44 +44,50 @@ $ git clone https://github.com/saleor/saleor-platform.git --recursive --jobs 3 | |
- Linux: No action required, sharing already enabled and memory for Docker engine is not limited. | ||
|
||
3. Go to the cloned directory: | ||
``` | ||
$ cd saleor-platform | ||
```shell | ||
cd saleor-platform | ||
``` | ||
|
||
4. Build the application: | ||
``` | ||
$ docker-compose build | ||
```shell | ||
docker-compose build | ||
``` | ||
|
||
5. Apply Django migrations: | ||
``` | ||
$ docker-compose run --rm api python3 manage.py migrate | ||
```shell | ||
docker-compose run --rm api python3 manage.py migrate | ||
``` | ||
|
||
6. Collect static files: | ||
``` | ||
$ docker-compose run --rm api python3 manage.py collectstatic --noinput | ||
```shell | ||
docker-compose run --rm api python3 manage.py collectstatic --noinput | ||
``` | ||
|
||
7. Populate the database with example data and create the admin user: | ||
``` | ||
$ docker-compose run --rm api python3 manage.py populatedb --createsuperuser | ||
```shell | ||
docker-compose run --rm api python3 manage.py populatedb --createsuperuser | ||
``` | ||
*Note that `--createsuperuser` argument creates an admin account for `[email protected]` with the password set to `admin`.* | ||
|
||
8. Run the application: | ||
``` | ||
$ docker-compose up | ||
```shell | ||
docker-compose up | ||
``` | ||
*Both storefront and dashboard are quite big frontend projects and it might take up to few minutes for them to compile depending on your CPU. If nothing shows up on port 3001 or 9000 wait until `Compiled successfully` shows in the console output.* | ||
|
||
## Where is the application running? | ||
- Saleor Core (API) - http://localhost:8000 | ||
- Saleor React Storefront - http://localhost:3001 | ||
- Saleor Dashboard - http://localhost:9000 | ||
- Jaeger UI (APM) - http://localhost:16686 | ||
- Mailhog (Test email interface) - http://localhost:8025 | ||
|
||
## How to update the subprojects to the newest versions? | ||
This repository contains newest stable versions. | ||
When new release appear, pull new version of this repository. | ||
In order to update all of them to their newest versions, run: | ||
``` | ||
$ git submodule update --remote | ||
```shell | ||
git submodule update --remote | ||
``` | ||
|
||
You can find the latest version of Saleor, storefront and dashboard in their individual repositories: | ||
|
@@ -74,19 +102,19 @@ Most of the time both issues can be solved by cleaning up space taken by old con | |
|
||
|
||
1. Make sure docker stack is not running | ||
``` | ||
$ docker-compose stop | ||
```shell | ||
docker-compose stop | ||
``` | ||
|
||
2. Remove existing volumes | ||
|
||
**Warning!** Proceeding will remove also your database container! If you need existing data, please remove only services which cause problems! https://docs.docker.com/compose/reference/rm/ | ||
``` | ||
```shell | ||
docker-compose rm | ||
``` | ||
|
||
3. Build fresh containers | ||
``` | ||
```shell | ||
docker-compose build | ||
``` | ||
|
||
|
@@ -107,8 +135,8 @@ If you are getting issues with lack of available space, consider prunning your d | |
<details><summary>I've been warned</summary> | ||
<p> | ||
|
||
``` | ||
$ docker system prune | ||
```shell | ||
docker system prune | ||
``` | ||
|
||
</p> | ||
|
@@ -125,7 +153,7 @@ When testing developer releases or making local changes, you might end up in a s | |
<details><summary>I've been warned</summary> | ||
<p> | ||
|
||
``` | ||
```shell | ||
docker-compose down --volumes db | ||
``` | ||
|
||
|
@@ -136,20 +164,11 @@ docker-compose down --volumes db | |
- `docker-compose up api worker` for backend services only | ||
- `docker-compose up` for backend and frontend services | ||
|
||
|
||
## Where is the application running? | ||
- Saleor Core (API) - http://localhost:8000 | ||
- Saleor React Storefront - http://localhost:3001 | ||
- Saleor Dashboard - http://localhost:9000 | ||
- Jaeger UI (APM) - http://localhost:16686 | ||
- Mailhog (Test email interface) - http://localhost:8025 | ||
|
||
## Feedback | ||
|
||
If you have any questions or feedback, do not hesitate to contact us via GitHub or Gitter: | ||
|
||
- https://github.com/saleor/saleor/discussions | ||
- https://gitter.im/mirumee/saleor | ||
|
||
|
||
## License | ||
|
||
|
Submodule react-storefront
updated
from f5c699 to 7abe16
Submodule saleor-dashboard
updated
1830 files