License: MIT
In order to install the application boilerplate on your machine, you can follow the instructions described in the link below:
For DevVM based installation instructions, see About the Installation Guides.
If you encounter any issues during or after the installation, see Troubleshooting article.
For detailed installation instructions of Spryker in Docker, see Getting Started with Docker.
For troubleshooting of Docker based instances, see Troubleshooting.
For the installation prerequisites, see Docker Installation Prerequisites.
Recommended system requirements for MacOS:
Macbook type | vCPU | RAM |
---|---|---|
15' | 4 | 6GB |
13' | 2 | 4GB |
Run the commands:
mkdir project-boilerplate && cd project-boilerplate
git clone git@github.com:spryker/project-boilerplate.git .
git clone git@github.com:spryker/docker-sdk.git docker
- Run the following commands right after cloning the repository:
docker/sdk boot -s
docker/sdk up
- Git checkout with assets and importing data:
git checkout your_branch
git submodule update --init --force docker && docker/sdk boot -s
docker/sdk up --assets --data
Optional
up
command arguments:
--assets
- build assets--data
- get new demo data
- Light git checkout:
git checkout your_branch
git submodule update --init --force docker && docker/sdk boot -s
docker/sdk up
- Reload all the data:
docker/sdk clean-data && docker/sdk up && docker/sdk console q:w:s -v -s
- Run the commands right after cloning the repository:
docker/sdk boot deploy.dev.yml
docker/sdk up
- Git checkout:
git checkout your_branch
git submodule update --init --force docker && docker/sdk boot -s deploy.dev.yml
docker/sdk up --build --assets --data
Optional
up
command arguments:
--build
- update composer, generate transfer objects, etc.--assets
- build assets--data
- get new demo data
-
If you get unexpected application behavior or unexpected errors:
- Run the command:
git status
-
If there are unnecessary untracked files (red ones), remove them.
-
Restrart file sync and re-build the codebase:
docker/sdk trouble rm -rf ./docker && git submodule update --init --force docker && docker/sdk boot deploy.dev.yml docker/sdk up --build --assets
-
If you do not see the expected demo data on the Storefront:
-
Check the queue broker and wait until all queues are empty.
-
If the queue is empty but the issue persists, reload the demo data:
docker/sdk trouble rm -rf ./docker && git submodule update --init --force docker && docker/sdk boot deploy.dev.yml docker/sdk up --build --assets --data
-
No data on Storefront
Use the following services to check the status of queues and jobs:
- queue.spryker.local
- scheduler.spryker.local
Fail whale
- Run the command:
docker/sdk logs
- Add several returns to mark the line you started from.
- Open the page with the error.
- Check the logs.
MacOS and Windows - files synchronization issues in Development mode
- Follow sync logs:
docker/sdk sync logs
- Hard reset:
docker/sdk trouble && rm -rf vendor && rm -rf src/Generated && docker/sdk sync && docker/sdk up
Errors
ERROR: remove spryker_logs: volume is in use - [{container_hash}]
- Run the command:
docker rm -f {container_hash}
- Repeat the failed command.
Error response from daemon: OCI runtime create failed: .... \\\"no such file or directory\\\"\"": unknown.
Repeat the failed command.