fourkitchens / pantheon-tools

Tools to run actions against a Pantheon site
GNU General Public License v3.0
16 stars 3 forks source link
pantheon terminus

pantheon-tools

Tools to improve your development workflow on Pantheon sites including:

This includes things like:

Pre-requisites

  1. Install Terminus.
  2. terminus auth:login to store an access token.
  3. Upload your SSH key to the Pantheon dashboard.
  4. Add Terminus to your Path. For example, if Terminus is installed at ~/.composer/vendor/bin/terminus then you need to add ~/.composer/vendor/bin to your path.
  5. Use Git to checkout this pantheon-tools repository, maybe to the same place you store your other code projects.
  6. Add the directory containing pantheon-tools to your Path.

How to add something to your path

E.g.

export PATH="$PATH:$HOME/.composer/vendor/bin"
export PATH="$PATH:$HOME/path/to/pantheon-tools"

Depending on your system, you must add the above paths to ~/.profile, ~/.bash_profile, or ~/.zshrc.

Note that an alias will not work.

Usage

  1. This may be getting a lot of updates, so first ensure that you have the latest version.
    cd /path/to/the/pantheon-tools
    git pull
  2. The scripts are totally interactive. Just run them. E.g.:
    pantheon-security-update

The script will ask you questions along the way (and give you hints when there's ways to add arguments to make things faster).

Scripts (Categories)

Deploy

Command Description
pantheon-quick-deploy Quickly deploy something from dev->test->live
pantheon-commit-and-quick-deploy Commit any local changes and then deploy them
pantheon-deploy Deploy dev->test or test->live

Report

Command Description
pantheon-drupal-status-report Report a summary of the Status Report for every Drupal site
pantheon-sites-report Get a metric about all sites (e.g. PHP version, or Upstream)
pantheon-module-report Get a list of which sites use which version of a module

Update

Command Description
pantheon-security-update Run security updates on a Pantheon site by first creating a new multi-dev environment

Database

Command Description
pantheon-db-dump Dump a database from any Pantheon site. Even VIP clients that require an SSH tunnel to connect to the database
pantheon-db-cli Connect to the database of any Pantheon site. Even VIP clients that require an SSH tunnel to connect to the database

Environment

Command Description
pantheon-multidev-create Create a new multi-dev environment
pantheon-multidev-merge Merge a multi-dev environment into master (the dev environment)
pantheon-move-domains Move custom domains from one site to another

Accounts

Command Description
pantheon-sites-accounts-rename Iterate over all a given list of sites and rename usernames/email addresses
pantheon-offboard Offboard a staff member from your organization