Configure the build machine
The following sections discuss how to configure the build machine.
Install Composer
First, check if Composer is already installed:
In a command prompt, enter any of the following commands:
composer --help
composer list --help
If command help displays, Composer is already installed.
If an error displays, use the following steps to install Composer.
To install Composer:
-
Change to or create an empty directory on your Commerce server.
-
Enter the following commands:
curl -sS https://getcomposer.org/installer | php
mv composer.phar /usr/local/bin/composer
For additional installation options, see the Composer installation documentation.
Install PHP
Install PHP on CentOS or Ubuntu.
Set up the build system
To set up the build system:
-
Log in to the build system as, or switch to, the file system owner.
-
Retrieve the Commerce code from source control.
If you use Git, use the following command:
git clone [-b <branch name>] <repository URL>
-
Change to the Commerce root directory and enter:
composer install
-
Wait for dependencies to update.
-
Set ownership:
chown -R <Commerce file system owner name>:<web server username> .
For example,
chown -R commerce-username:apache .
-
If you use Git, open
.gitignore
in a text editor. -
Start each of the following lines with a
#
character to comment them out:# app/etc/config.php # pub/media/* # generated/* # pub/media/*.* # pub/media/wysiwyg/* # pub/static/*
-
Save your changes to
.gitignore
and exit the text editor. -
If you use Git, use the following commands to commit the change:
git add .gitignore && git commit -m "Modify .gitignore for build and production"
See the
.gitignore
reference for more information. -
The build system should use default mode or developer mode:
bin/magento deploy:mode:set <mode>
<mode>
is required. It can be eitherdefault
ordeveloper
.