Skip to content

Latest commit

 

History

History
109 lines (76 loc) · 3.55 KB

02-installing-in-development-mode-on-macos-and-linux.md

File metadata and controls

109 lines (76 loc) · 3.55 KB

Installing in Development mode on MacOS and Linux

This document describes how to install Spryker in Development Mode on MacOS and Linux.

Installing Docker prerequisites on MacOS and Linux

To install Docker prerequisites, follow one of the guides:

Installing Spryker in Development mode on MacOS and Linux

Follow the steps to install Spryker in Development mode:

  1. Open a terminal.

  2. Create a new folder and navigate into it.

  3. Depending on the desired Demo Shop:

    a. Clone the B2C repository:

    git clone https://github.com/spryker-shop/b2c-demo-shop.git -b 202009.0-p1 --single-branch ./b2c-demo-shop

    b. Clone the B2B repository:

    git clone https://github.com/spryker-shop/b2b-demo-shop.git -b 202009.0-p1 --single-branch ./b2b-demo-shop

  4. Depending on the repository you've cloned, navigate into the cloned folder:

    • B2C repository:
    cd b2c-demo-shop
    • B2B repository:
    cd b2b-demo-shop

:::(Warning) (Verification) Make sure that you are in the correct folder by running the pwd command. :::

  1. In deploy.dev.yml, define image: with the PHP image compatible with the current release of the Demo Shop:
image: spryker/php:7.4-alpine3.16
  1. Clone the Docker SDK repository:
git clone https://github.com/spryker/docker-sdk.git --single-branch docker

:::(Warning) (Verification) Make sure docker 18.09.1+ and docker compose 2+ are installed:

$ docker version
$ docker compose version

:::

  1. Bootstrap local docker setup:
docker/sdk bootstrap deploy.dev.yml

:::(Warning) (Bootstrap) Once you finish the setup, you don't need to run bootstrap to start the instance. You only need to run it after you update the Docker SDK or the deploy file. :::

  1. If the bootstrap command returned instructions for preparing your environment, follow them.

:::(Info) () To double-check if there are any instructions, run docker/sdk install. :::

  1. Build and start the instance:
docker/sdk up

@(Warning)()(Depending on the hardware performance, the first project launch can take up to 20 minutes.)

Endpoints

To ensure that the installation is successful, make sure you can access the configured endpoints from the Deploy file. See Deploy file reference - 1.0 to learn about the Deploy file.

:::(Info) (RabbitMQ UI credentials) To access RabbitMQ UI, use spryker as a username and secret as a password. You can adjust the credentials in deploy.yml. :::

Getting the list of useful commands

To get the full and up-to-date list of commands, run docker/sdk help.

Next steps