Manage Configuration

In step four of the Build Tools guide, learn how to manage your site configuration.

Contributors: Steve Zipfel.

Tweet

In this lesson, we'll use the Configuration Management system within the Drupal Admin interface to set block placements for our example site. Continuing from the previous step, we'll be working in the feature branch environment, not Dev.

  1. As a site administrator, navigate to Extend and search for "Config Direct Save". Enable the module and save.

    Install Module Config Direct Save

    This module is required for the following steps.

  2. As a site administrator, navigate to Structure > Block layout. Disable the Tools block and move the Search block to the header. Save your changes with the Save blocks button at the bottom of the page.

    Block placements

  3. Go to Configuration > Development > Configuration Synchronization:

    Configuration synchronization

    Note the warning displayed on this page about modified configuration. This means that your recent configuration changes would be erased if you synchronized your configuration at this time.

  4. Click Update and select the sync source, then click Update configuration to export configuration changes from the database to yaml files in your site's codebase:

    Update configuration

  5. Return to your open Pull Request in GitHub and use the link provided in the comment to open the associated Multidev environment on the Pantheon Site Dashboard:

    Visit multidev environment

  6. The sync operation made changes to a number of configuration files that we now need to commit to version control. Enter a message describing the configuration change and click Commit:

    Commit exported config

  7. Return to your open Pull Request in GitHub. Note that your commit has been added to this Pull Request, and the CircleCI status indicates that your tests are running:

    Commit exported config

Whenever you commit changes from the Pantheon dashboard, the commit will be reduced to contain only those files that belong in the source repository, and this commit will be pushed back to the canonical repository on GitHub:

Sync commit from Pantheon to GitHub

GitHub will then start a new CircleCI build, and the build results will once again be pushed to the existing Multidev environment that was created for this branch:

Sync commit from GitHub to Pantheon Multidev

You may continue working in this environment, making multiple changes, and committing updates whenever you would like your tests to run again.