We provide two kinds of virtualization, a vagrant and a docker based solution. Our developers use the docker containers mainly. These containers are also used in our continuous integration process. The supported functions are for both systems equal if the host systems is based on Linux. Instead of testing windows in combination with docker we evaluated the vagrant setup.
If you want to install the B2B-Suite for production environment your system must fit with the defined requirements from the Shopware core.
The B2B Suite is based on the minimum requirements of the Shopware core.
These requirements apply from B2B Suite 3.1.0 and above.
Like in the Shopware 5 core PHP 7.2.20, 7.3.7, 7.4.14 and MySQL 8.0.20 - 8.0.21 are not supported.
As minimum requirement, we need a docker runtime with version 1.12.* or higher. psh.phar provides the following available docker commands:
./psh.phar docker:start # start & build containers ./psh.phar docker:ssh # ssh access web server ./psh.phar docker:ssh-mysql # ssh access mysql ./psh.phar docker:status # show running containers and network bridges ./psh.phar docker:stop # stop the containers ./psh.phar docker:destroy # clear the whole docker cache
To start the docker environment just type
on your command line. The several containers are booted and afterwards you can login into your web container with
After that, you can start the initialization process by typing
After a few minutes, our test environment should be available under the address 10.100.200.46.
To get a full list of available commands, you can use
The following commands are available to create a mac setup. Apache, MySQL and ant are required. You can use brew package manager to install them.
./psh.phar mac:init # build installation ./psh.phar mac:start # start apache, mysql ./psh.phar mac:stop # stop apache, mysql ./psh.phar mac:restart # restart apache, mysql
You can change the database configuration in your own .psh.yaml file.
mac: paths: - "dev-ops/mac/actions" const: DB_USER: "USERNAME" DB_PASSWORD: "PASSWORD" DB_HOST: "DB_HOST" SW_HOST: "SWHost"
For a better explanation, use the provided .psh.yaml.dist file as an example.
Once the environment has booted successfully, you can use the common scripts to setup shopware
./psh.phar clear # remove vendor components and previously set state ./psh.phar init # init composer, install plugins ./psh.phar unit # execute test suite
A quick start guide for the B2B-Suite is in the component-guide.