Skip to content

Terminus plugin that allows for users to deploy tests from their upstream without merging those changes into the upstream ahead of time.

Notifications You must be signed in to change notification settings

terminus-plugin-project/terminus-upstream-testing-plugin

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

21 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Terminus Upstream Testing

Terminus v1.x Compatible

Option Description
--repo Repository to use and pull code from. When omitted this will use the sites upstream
--branch Branch from the repository to use.
--env Environment to use for testing
--copy Environment to copy database and files from
--teardown Tear down the environment before applying any changes
--rebuild Rebuild the database and files
--username Change user 1's username
--password Change user 1's password
--notify Run a script after the process has been completed
--skipautocommit Skip files that were not autocommitted

Slack Integration

Integration with Slack using incoming webhooks

Option Description
--slack_url Slack URL to post to
--slack_channel Slack Channel to post message to. Should be prefixed with #
--slack_message Message to post to slack. Following variables are available {env} {site_id} {site_name} {url}
--slack_username Username to push through as slack message
--slack_icon Icon to use for slack message

Examples

Default Running

The following will apply all updates from the master branch of the site's upstream to the upstream multi-dev

$ terminus site:upstream:test companysite-33

Separate Upstream

If the --repo argument is omitted the plugin with default to the site's upstream git repository. Otherwise a git url could be used to pull from a completely different repo.

$ terminus site:upstream:test companysite-33 --repo="https://github.com/pantheon-systems/drops-7.git"

Specifying the environment to copy database and files

The --copy argument will allow you to specify the environment to bring the database and files from. This environment must already be initialized. Otherwise, the live/test/dev environments will be used respectively

$ terminus site:upstream:test companysite-33 --copy="dev"

Upstream Branch

To specify a particular branch that code would live in the --branch argument could be used. That branch will need to exist within the upstream or --repo repository.

$ terminus site:upstream:test companysite-33 --branch="v1.3.3"

Rebuild

To rebuild or copy the database and files from a particular environment use the --rebuild flag as it will dictate that you want to completely pull new content. In conjunction with --copy these could be helpful in automation if wanting to specify the environment that data should be rebuilt from.

$ terminus site:upstream:test companysite-33 --rebuild

Reset User 1 Username and Password

The following will reset the username and password of the user 1 account. This is helpful if you would like a standard account username and password for any other sort of automated testing like behat. Each argument may be used independently and do not need to be combined.

Reset Username

$ terminus site:upstream:test companysite-33 --username="admin"

Reset Password

$ terminus site:upstream:test companysite-33 --password="admin"

Slack Notification

There is an ability to have a slack message sent to a particular channel to notify when an environment has been updated. This is particularly useful if and when you are using this plugin for any sort of Continuous Integration work.

$ terminus site:upstream.test companysite-33 --slack-url="[REDACTED]" --slack-channel="#general"

Installation

For help installing, see Manage Plugins

mkdir -p ~/.terminus/plugins
composer create-project -d ~/.terminus/plugins terminus-plugin-project/terminus-upstream-testing-plugin:~1

Install Notes

Occasionally you may get this issue:

[Pantheon\Terminus\Exceptions\TerminusException]
  The plugin terminus-plugin-project/terminus-upstream-testing-plugin has installed the project guzzlehttp/psr7: 1.4.2, but Terminus has installed guzzlehttp/psr7: 1.4.1. To resolve this, try running 'com
  poser update' in both the plugin directory, and the terminus directory.

The way to solve this will be to go to your terminus project and run composer update. If you globally require it you will need to go directly into terminus it's self as the lock file within the terminus may contain an older version of guzzle/psr7.

OS X & Linux Fix

The following will only work assuming the following:

  • terminus was installed with composer and not with the phar
  • the terminus executable file is located within vendor/bin folder
cd `dirname $(which terminus)`
cd ../../
composer update
cd ~/.terminus/plugins/terminus-plugin-project
composer update

Help

Run terminus list site:upstream:test for a complete list of available commands. Use terminus help <command> to get help on one command.

About

Terminus plugin that allows for users to deploy tests from their upstream without merging those changes into the upstream ahead of time.

Resources

Stars

Watchers

Forks

Packages

No packages published