Step 2: Update the shared configuration

Generate the shared configuration file, app/etc/config.php, in your development system and transfer it using source control to your build system as discussed in this section.

To update the configuration:

  1. Log in to your development system as, or switch to, the file system owner.

  2. Change to the application root and run the dump command.

    cd <Magento root dir>
    php bin/magento app:config:dump
    

    For example, if Commerce is installed in /var/www/html/magento2, enter:

    cd /var/www/html/magento2
    php bin/magento app:config:dump
    
  3. Confirm that app/etc/config.php was updated.

    git status
    

    Sample response:

    On branch m2.2_deploy
    Changed but not updated:
      (use "git add <file>..." to update what will be committed)
      (use "git checkout -- <file>..." to discard changes in working directory)
           modified:   app/etc/config.php
    
    WARNING
    Do not submit changes to the generated, pub/media, or pub/static directories to source control. You generate those files on your build system. The development system likely has code, themes, and so on, that are not ready for use on the production system.
  4. Check in your changes to app/etc/config.php only to source control.

    git add app/etc/config.php && git commit -m "Updated shared configuration" && git push mconfig m2.2_deploy
    

Step 3: Update your build system and generate files

Now that you have committed your changes to the shared configuration to source control, you can pull those changes in your build system, compile code, and generate static files. The last step is to pull those changes to your production system. As a result, your production system’s configuration will match your development system.

To update the build system:

  1. Log in to the build system as the file system owner.

  2. Change to the application root directory.

    cd <Magento root dir>
    
  3. Pull the changes to app/etc/config.php from source control.

    git pull mconfig m2.2_deploy
    
  4. Compile code.

    bin/magento setup:di:compile
    
  5. After code has been compiled, generate static view files.

    bin/magento setup:static-content:deploy -f
    
  6. Check the changes into source control.

    git add -A && git commit -m "Updated files on build system" && git push mconfig m2.2_deploy
    

Step 4: Update the production system

The last step in the process is to update your production system from source control. This pulls all the changes you made on your development and build systems, which means your production system is completely up-to-date.

To update the production system:

  1. Log in to the production system as the file system owner.

  2. Change to the application root and enable maintenance mode.

    cd <Magento root dir>
    
    bin/magento maintenance:enable
    

    For additional options, such as the ability to set an IP address whitelist, see magento maintenance:enable.

  3. Stop any running queue workers by setting cron_run to false in app/etc/env.php as follows:

    'cron_consumers_runner' => [
            'cron_run' => false
        ]
    
  4. Update the configuration.

    bin/magento app:config:import
    
  5. Finally, kill any active consumer processes.

    kill <PID>
    

    Where PID is the process ID to be killed, for example:

    kill 1234
    
  6. Pull code from source control.

    git pull mconfig m2.2_deploy
    
  7. Update the configuration.

    bin/magento app:config:import
    
  8. Clean the cache.

    bin/magento cache:clean
    
  9. End maintenance mode.

    bin/magento maintenance:disable
    

Verify the changes in the Admin

To verify these settings are not editable in the Admin:

  1. Log in to the Admin.

  2. Click Stores > Settings > Configuration > General > General.

  3. In the right pane, expand Locale Options.

    The options you just set are displayed as follows:

    Configuration options not editable in the Admin

INFO
To change a setting that is locked in the Admin, use the magento config:set --lock command.
Previous pageFile systems access permissions
Next pageUsing CLI commands

Commerce