Skip to content

Latest commit

 

History

History
62 lines (35 loc) · 2.68 KB

updating-blt.md

File metadata and controls

62 lines (35 loc) · 2.68 KB
Raw

Updating BLT

Updating a composer-managed version

If you are already using BLT via Composer, you can update to the latest version of BLT using composer.

  1. To update to the latest version of BLT that is compatible with your existing dependencies, run the following commands:

     composer update acquia/blt --with-all-dependencies

    This will cause Composer to update all of your dependencies (in accordance with your version constraints) and permit the latest version of BLT to be installed.

  2. Check the release information to see if there are special update instructions for the new version.

  3. Review and commit changes to your project files.

  4. Rarely, you may need to refresh your local environment via blt setup. This will drop your local database and re-install Drupal.

Updating from a non-Composer-managed (very old) version

If you are using an older version of BLT that was not installed using Composer, you may update to the Composer-managed version by running the following commands:

  1. Remove any dependencies that may conflict with upstream acquia/blt. You may add these back later after the upgrade, if necessary.

     composer remove drush/drush drupal/console phing/phing phpunit/phpunit squizlabs/php_codesniffer symfony/yaml drupal/coder symfony/console --no-interaction --no-update
 composer remove drush/drush drupal/console phing/phing phpunit/phpunit squizlabs/php_codesniffer symfony/yaml drupal/coder symfony/console --no-interaction --no-update --dev
 composer config minimum-stability dev

  2. (conditional) If you are using Lightning, verify that your version constraint allows it to be updated to the latest stable version:

     composer require drupal/lightning:~8 --no-update

  3. Require acquia/blt version 9.0.5 as a dependency:

     composer require acquia/blt:9.0.5 --no-update

  4. Update all dependencies:

     composer update

  5. Execute update script:

     ./vendor/acquia/blt/scripts/blt/convert-to-composer.sh

  6. Upgrade to the latest version of BLT:

     composer require acquia/blt:^9.0.5 --no-update
 composer update

  7. If using Travis CI, re-initialize .travis.yml and re-apply customizations:

     rm .travis.yml && blt recipes:ci:travis:init

  8. Cleanup deprecated files

     rm -rf .git/hooks && mkdir .git/hooks
 blt blt:source:cleanup

  9. If using Drupal VM, re-create VM:

     blt recipes:drupalvm:destroy
 blt vm

Review and commit changes to your project files. For customized files like .travis.yml or docroot/sites/default/settings.php, it is recommended that you use git add -p to select which specific line changes you'd like to stage and commit.