The command line has always been the most flexible and powerful way for us humans to communicate with their computers. For web developers, command-line tools have proliferated over recent years: many developers spend most of their time typing commands in a shell.
Our command-line interface, the Platform.sh CLI, is based on the Symfony Console component. It’s convenient to use alongside other command-line tools: you need to use
git to manage the project’s code, so
platform is a natural way to manage the project itself. The CLI also helps you build projects for local development, particularly if you use Drupal.
To install or upgrade, you can use Composer:
composer global require 'platformsh/cli:@stable'
Recent new features (over the past two months) include:
environment:metadatacommand for reading additional environment properties - this also lets you update the environment’s title, and its ‘parent’ and ‘enable_smtp’ properties.
ssh-key:addcommand can now generate an SSH public key for you, before uploading it to your Platform.sh account.
Integration commands, for adding GitHub, HipChat, and other integrations -
integration:update , and
<p>A GitHub integration allows you to create Platform.sh environments for every pull request (and/or every branch) in your GitHub repository:</p> <pre>
platform integration:add –type github –repository example/example –token ExampleToken
<p>A HipChat integration will report Platform.sh activity to your private HipChat room.</p> <pre>
platform integration:add –type hipchat –room 123456 –token ExampleToken
<p>There is also a generic ‘webhook’ integration: Platform.sh will post information about every activity to your own webhook URL.</p> <pre>
platform integration:add –type webhook –url https://example.com/webhook
environment:restorecommand for restoring a backup. You can also now list recent backups using:
platform environment:backup –list
–no-waitoption. You can use
platform activity:listto check the state of previous operations.
For more information about the CLI (and to file issues) see the public GitHub repository. We accept pull requests!