![]() ![]() The steps here ensure that any modules and themes from are in the composer.json require list. The only things that should be migrated from the existing site are custom code, custom themes, and custom modules that are specific to the existing site. The goal of this process is to have Composer manage all the site's contrib modules, contrib themes, core upgrades, and libraries (we'll call this contributed code). These customizations need to be replicated in your new project structure. What makes your site code unique is your selection of contributed modules and themes, and any custom modules or themes your development team has created. ![]() In the pantheon.yml file, the api_version: 1 and build_step: true values are required.Īdd in the Custom and Contrib Code Needed to Run Your Site Then add build_step: true to pantheon.yml if it is not already included. Remove any values from pantheon.yml that you prefer to keep listed in. Use Terminus to list all available updates: Update the site to the latest Pantheon Drops 8 Upstream and apply all available updates. This folder will contain two subdirectories that you'll create in the next sections, one for the site on the former platform, and one for the Pantheon site. In this example, the site name is anita-drupal.Ĭreate a new folder to use while working on the migration. Refer to the Trusted Host Setting documentation for more information. The site owner should ensure the trusted host setting is up-to-date. Pantheon support is not available to users who avoid the Multidev steps. This guide is written for users with access to Pantheon's Multidev feature. The site does not use another package and library manager like Ludwig. Refer to the documentation on Serving Sites from the Web Subdirectory for information about nested docroots. The process outlined in this guide will not work if the site repository has a /web folder at its root. The site cannot be set to use an empty upstream. The following values indicate that a site is using a drops-8 upstream: The following is an abridged example of the output for a site upstream set to drops-8: Run the command terminus site:info $SITE to display the site's basic information and properties. ![]() ![]() Use Terminus to Confirm the drops-8 Upstream Will This Guide Work for Your Site?Ĭonfirm that your site meets the following requirements before you continue:Įnsure your site has the Pantheon drops-8 repo in its upstream. The drupal-composer-managed Integrated Composer upstream works with Drupal 8, and following the drupal-composer-managed upstream will help keep your site up to date with any general configuration changes recommended by Pantheon.Īdd Drupal 8 core dependency instructions to drupal/core-recommended, to keep the site on Drupal 8 until you are ready to upgrade to Drupal 9. Switch to the drupal-composer-managed Integrated Composer upstream. Remove dependencies that Composer will manage from the existing Drupal 8 site's Git repository, and have Composer manage those dependencies instead. Overviewĭrupal 9 sites on Pantheon have Integrated Composer built-in to manage site dependencies. If this is not your scenario, see Drupal 9 Migration Guides for additional upgrade paths. Finally, after testing and confirming everything looks good, you'll use Terminus to switch the site over to the new upstream. When everything is working correctly in the Multidev environment, you'll deploy the changes to the Dev environment by replacing your site's master branch with the new branch you've created. You'll then re-add the contrib and custom code for your site to the new branch, and test it on a Multidev environment. In this guide, we'll convert a standard Drupal 8 site to use Composer to manage deployments and dependencies, then switch from drops-8 to the new Integrated Composer drupal-composer-managed upstream while remaining on Drupal 8.ĭuring this process, you will create a new branch based on the Git history of the new upstream. ![]()
0 Comments
Leave a Reply. |
AuthorWrite something about yourself. No need to be fancy, just an overview. ArchivesCategories |