Production system setup
You can have one production system. All of the following must be true:
-
All Commerce code is in source control in the same repository as the development and build systems
-
Make sure all of the following are included in source control:
app/etc/config.phpgenerateddirectory (and subdirectories)pub/mediadirectorypub/media/wysiwygdirectory (and subdirectories)pub/staticdirectory (and subdirectories)
-
Commerce 2.2 or later must be installed and set for production mode
-
It has file system ownership and permissions set as discussed in Prerequisite for your development, build, and production systems.
Set up a production machine
To set up a production machine:
-
After installing Commerce or pulling it from source control, log in to the production server as, or switch to, the file system owner.
-
Create
~/.ssh/.composer/auth.jsonif you have not already done so.Create the directory:
code language-bash mkdir -p ~/.ssh/.composerCreate
auth.jsonin that directory.auth.jsonmust contain your authentication keys.A sample follows:
code language-json { "http-basic": { "repo.magento.com": { "username": "<your public key>", "password": "<your private key>" } } } -
Save your changes to
auth.json. -
Copy
<Commerce root dir>/app/etc/env.phpfrom your development system to your production system. -
Open
env.phpin a text editor and change any values necessary (for example, database connection information). -
Run the
magento config:setormagento config:set-sensitivecommand to set the values of any system-specific or sensitive configuration values, respectively.The following section shows an example.
Set configuration values on your production system
This section discusses how to set sensitive values on your production system using the magento config:sensitive:set command.
To set sensitive values:
-
Find a value to set using the sensitive value reference.
-
Note the configuration path for the setting.
-
Log in to the production system as, or switch to, the file system owner.
-
Change to the Commerce installation directory.
-
Enter the following command:
code language-bash bin/magento config:sensitive:set {configuration path} {value}For example, to set the value of the YouTube API key to
1234, entercode language-bash bin/magento config:sensitive:set catalog/product_video/youtube_api_key 1234You can also set one or more values interactively as follows:
code language-bash bin/magento config:sensitive:set -iWhen prompted, enter a value for each sensitive setting or press Enter to skip a value and move to the next one.
-
To verify that the value was set, log in to the Admin.
-
Locate the setting in the Admin.
For example, the YouTube API key setting is located in Stores > Settings > Configuration > Catalog > Catalog > Product Video.
The setting is displayed in the Admin and cannot be edited. The following figure shows an example.