This Quicksilver project is used in conjunction with the various suite of Terminus Build Tools-based example repositories to push any commits made on the Pantheon dashboard back to the original Git repository for the site. This allows developers (or other users) to work on the Pantheon dashboard in SFTP mode and commit their code, through Pantheon, back to the canonical upstream repository via a PR. This is especially useful in scenarios where you want to export configuration (Drupal, WP-CFM).
It is recommended that you use one of the example PR workflow projects (Drupal 8, WordPress) as a starting point for leveraging this tool.
- Support is only provided for the
2.x
version of Terminus Build Tools. - The project currently supports Github, GitLab (including self-hosted), and BitBucket providers.
- This Quicksilver script only works with Pantheon sites that have been configured to use a Git PR workflow.
This project is designed to be included from a site's composer.json
file, and placed in its appropriate installation directory by Composer Installers.
In order for this to work, you should have the following in your composer.json file:
{
"require": {
"composer/installers": "^1.0.20"
},
"extra": {
"installer-paths": {
"web/private/scripts/quicksilver": ["type:quicksilver-script"]
}
}
}
The project can be included by using the command:
composer require pantheon-systems/quicksilver-pushback:^2
If you are using one of the example PR workflow projects (Drupal 8, WordPress) as a starting point for your site, these entries should already be present in your composer.json
.
Here's an example of what your pantheon.yml
would look like if this were the only Quicksilver operation you wanted to use.
api_version: 1
workflows:
sync_code:
after:
- type: webphp
description: Push changes back to Git repository if needed
script: private/scripts/quicksilver/quicksilver-pushback/push-back.php
If you are using one of the example PR workflow projects as a starting point for your site, this entry should already be present in your pantheon.yml.
Quicksilver pushback requires a build-providers.json
file in the git root that specifies the git provider used for the project.
Valid git
provider values are github
, gitlab
and bitbucket
.
Example contents of build-providers.json
created by Terminus Build Tools for a GitHub and CircleCI project are below:
{"git":"github","ci":"circleci"}
Existing projects will have been created at different points in time, making the steps to upgrade slightly different for each project. In general, we have found success with the following:
- Update to Quicksilver Pushback
2.x
- Copy
files/private/github-secrets.json
on the Pantheon site tofiles/private/.build-secrets/tokens.json
- This must be done for all environments
- Ensure
build-providers.json
exists in the code base- Projects created from an older version of Terminus Build Tools may have this missing
- Update the Quicksilver Pushback script path in
pantheon.yml
fromprivate/scripts/quicksilver/quicksilver-pushback/push-back-to-github.php
toprivate/scripts/quicksilver/quicksilver-pushback/push-back.php