| title | description | tags | categories | type | permalink | contributors | date | ||||
|---|---|---|---|---|---|---|---|---|---|---|---|
Using Terminus to Create and Update Drupal Sites on Pantheon |
Detailed information on creating and updating new Pantheon Drupal sites using Terminus and the command line. |
|
guide |
docs/guides/:basename/ |
|
2/25/2015 |
The latest version of Pantheon's CLI, Terminus, incorporates not only Drush and WP-CLI, but also the vast majority of tasks available to you within the Pantheon Dashboard. You can create new sites, clone one environment to another, create branches, check for upstream updates, and more. By using Terminus, a site administrator can massively reduce the time spent on relatively simple tasks. In this guide, we will walk through the basics of creating a completely new Drupal site on Pantheon, installing some contrib modules, committing code, and cloning from one site environment to another—all through the Terminus CLI.
The following does **not** pertain to Composer managed sites. For information about using Composer to manage Drupal 8 sites, see [Build Tools Guide](/guides/build-tools/).Installing Terminus is a fairly straight forward process. Just follow these instructions.
After you install Terminus, do a quick status check to make sure it works. Depending on your OS, the output may vary, but here's a sample:
$ terminus auth:login --email=<email> --machine-token=<machine_token>
[notice] Logging in via machine token.
Excellent! You've installed Terminus and logged into your Pantheon account. For a full list of commands, refer to this page.
Terminus can be used on any Pantheon hosted website you have, and it can also create new sites! Let's get a list of your current Pantheon sites:
$ terminus site:list
+--------------------------+-----------+---------------+--------------------------+
| Site | Framework | Service Level | UUID |
+--------------------------+-----------+---------------+--------------------------+
| terminus-create | drupal8 | free | terminus-create |
| git-import-example | drupal | free | git-import-example |
+--------------------------+-----------+---------------+--------------------------+
Now let's create a new site:
$ terminus upstream:list | grep "Drupal 7" | grep "core"
21e1fada-199c-492b-97bd-0b36b53a9da0 Drupal 7 vanilla core drupal
$ terminus site:create terminus-cli-create "Terminus CLI Create" 21e1fada-199c-492b-97bd-0b36b53a9da0
[notice] Creating a new site...
$ terminus site:list
+--------------------------+-----------+---------------+--------------------------+
| Site | Framework | Service Level | UUID |
+--------------------------+-----------+---------------+--------------------------+
| terminus-cli-create | drupal | free | terminus-cli-create |
| terminus-create | drupal8 | free | terminus-create |
| git-import-example | drupal | free | git-import-example |
+--------------------------+-----------+---------------+--------------------------+
Now that the site is created, the next step is to run a Drush install command to get a fully functional Drupal set ready to go for development. Terminus will run most available Drush commands by simply adding the word "drush" to the command directly afterward, along with the site's Pantheon machine name.
terminus drush <site>.<env> -- site-install
Running drush site-install on terminus-cli-create-dev
dev.a248f559-fab9-49cd-983c-f5@appserver.dev.a248f559-fab9-49cd-983c-f5c0d11a2464.drush.in's password:
Could not find a Drupal settings.php file at ./sites/default/settings.php.
You are about to create a sites/dev-terminus-cli-create.pantheon.io/files directory and create a sites/dev-terminus-cli-create.pantheon.io/settings.php file and DROP all tables in your 'pantheon' database. Do you want to continue? (y/n): y
Starting Drupal installation. This takes a few seconds ... [ok]
Installation complete. User name: admin User password: ******** [ok]If the command above fails with exception 'Drush\Sql\SqlException' with message 'Unable to find a matching SQL Class. Drush cannot find your database connection details.', you must first create a settings.php file.
You should now be able to open a web browser and see your brand new Drupal site! On Mac, try using the open command to see an environment in your default browser:
open https://dev-terminus-cli-create.pantheon.io
There is also the terminus dashboard <site>.<env> --print command if, at any point in time, you want to open the site's Pantheon Dashboard.
$ terminus dashboard <site>.<env>
Also, the status of each of the environments within the site can be seen using a terminus env:list command.
$ terminus env:list <site>
------ --------------------- ------------------------------------ ----------------- -------- -------------
ID Created Domain Connection Mode Locked Initialized
------ --------------------- ------------------------------------ ----------------- -------- -------------
test 2016-12-20 20:57:03 test-terminus-cli-create.pantheonsite.io git false false
dev 2016-12-20 20:57:01 dev-terminus-cli-create.pantheonsite.io git false true
live 2016-12-20 20:57:05 live-terminus-cli-create.pantheonsite.io git false false
------ --------------------- ------------------------------------ ----------------- -------- -------------
While the site's Dev environment is still in SFTP mode, we can use Drush to download and install some Drupal contrib modules, such as Views and Administration Menu.
$ terminus drush <site>.<env> -- dl admin_menu
Running drush dl admin_menu on terminus-cli-create-dev
dev.a248f559-fab9-49cd-983c-f5@appserver.dev.a248f559-fab9-49cd-983c-f5c0d11a2464.drush.in's password:
Project admin_menu (7.x-3.0-rc5) downloaded to [success]
/srv/bindings/c183403f14224eac8471ec0000f9e653/code/sites/all/modules/admin_menu.
Project admin_menu contains 3 modules: admin_devel, admin_menu_toolbar, admin_menu.
tests-MacBook-Pro:~ erikmathy$ terminus drush <site>.<env> -- en admin_menu,admin_menu_toolbar
Running drush en admin_menu,admin_menu_toolbar on terminus-cli-create-dev
dev.a248f559-fab9-49cd-983c-f5@appserver.dev.a248f559-fab9-49cd-983c-f5c0d11a2464.drush.in's password:
The following extensions will be enabled: admin_menu, admin_menu_toolbar
Do you really want to continue? (y/n): y
admin_menu was enabled successfully. [ok]
admin_menu_toolbar was enabled successfully. [ok]
Not bad, eh? All this without a single GUI or web browser click! If you look at the site's Dashboard, the new code will be displayed there, waiting to be committed.
Let's commit it all into the Git repo with the terminus env:commit command:
$ terminus env:commit <site>.<env> --message="Initial Commit"
Success: Successfully committed.
+---------------------+--------+--------+------------------------------------------+------------------+
| Time | Author | Labels | Hash | Message |
+---------------------+--------+--------+------------------------------------------+------------------+
| 2015-02-05T22:40:14 | Root | dev | 4297d007d1697e1b9a90073510183149dd1c827f | "Initial Commit" |
+---------------------+--------+--------+------------------------------------------+------------------+
Open the Pantheon Dashboard, and you'll see the new files are shown in the Git commit log.
To see what a commit message looks like, let's download Bootstrap and then commit it as well.
$ terminus drush <site>.<env> -- dl bootstrap
Running drush dl bootstrap on terminus-cli-create-dev
dev.a248f559-fab9-49cd-983c-f5@appserver.dev.a248f559-fab9-49cd-983c-f5c0d11a2464.drush.in's password:
Project bootstrap (7.x-3.0) downloaded to [success]
/srv/bindings/c183403f14224eac8471ec0000f9e653/code/sites/all/themes/bootstrap.
$ terminus env:commit <site>.<env> --message="Adding bootstrap"
Success: Successfully commited.
+---------------------+---------+-----------+------------------------------------------+-------------------+
| Time | Author | Labels | Hash | Message |
+---------------------+---------+-----------+------------------------------------------+-------------------+
| 2015-02-11T18:25:44 | E Mathy | dev | 34e988fe427f7dfe9f9af0046c83d49268e1f1ac | Adding bootstrap. |
| 2015-02-05T22:40:14 | Root | dev | 4297d007d1697e1b9a90073510183149dd1c827f | "Initial Commit" |
+---------------------+---------+-----------+------------------------------------------+-------------------+
And finally, let's initialize the Test environment to move the code, files, and DB from Dev onward in the Pantheon workflow using a terminus env:deploy command:
$ terminus env:deploy <site>.test --sync-content --cc --updatedb
You just created a brand new Drupal site on Pantheon! You added modules, committed code, and moved it all from Dev to Test without using a single checkbox, radio button, or colored Ajax slider. To top it off, by using Terminus, it all happened in a third of the time. There is a whole new world of possibility open to you. Now go forth and CLI!
-
Learn more about Drush.
-
After you've mastered Terminus, take it a step further with Continuous Integration.