Introduction

Learn how to use Integrated Composer.

Discuss in our Forum Discuss in Slack

Integrated Composer is a Pantheon platform feature that extends Composer functionality to WordPress and Drupal's core files, and treats them as a managed dependency. Integrated Composer enables one-click updates from the Dashboard for upstream updates and Composer dependencies on your Composer-managed Pantheon site.

Get Started With Integrated Composer

Drupal with Integrated Composer

  • Follow the Drupal on Pantheon doc to create a new Drupal site with Integrated Composer built in.

  • To upgrade or migrate an existing site to Drupal with Integrated Composer, visit the Migrate to Drupal guide.

  • To convert an existing Drupal site to a Composer-managed site with Integrated Composer, visit the Composer Convert doc.

 Note

drupal-composer-managed is the recommended Composer-based Drupal upstream. The Composer-based Drupal upstreams below have been deprecated.

  • drupal-project
  • drupal-recommended

You can use the Terminus Conversion Tools Plugin if you want to convert your site from one of the deprecated upstreams to the supported drupal-composer-managed upstream.

WordPress with Integrated Composer

  1. Fork the Pantheon-maintained repository from https://github.com/pantheon-upstreams/wordpress-project.

  2. Add a new Custom Upstream on the Pantheon Dashboard.

  3. Create a new WordPress site from the Upstream. Do not customize the upstream as yet.

  4. Navigate to the Dev environment, then click Visit Development Site and follow the prompts to complete the CMS installation.

  5. Clone the site locally and run composer install.

Build and Deploy Terminology

Build and deploy are terms you'll encounter frequently. Your application goes through a build and deploy process every time you push a change to your repository through Git or activate an environment.

The build process runs before deploy and scans configuration files in your repository and assembles the necessary containers. The build then prepares your application, including:

  • Compiling
  • Linking
  • Uploading artifacts

The deploy process uses the build containers to create an updated version of the live application.

More Resources