Pantheon’s Multidev is development environments that allows a developer to fork the entire stack (code and content), work on and test a specific change to there website, then merge the code changes back into the master. Each forked branch will have its own separate development environment, including database and files.

Table of Contents

1 Multidev Management
- - 1.1.1 Creating a Multidev
  - 1.1.2 Launching a Multidev Site
  - 1.1.3 Locking a Multidev
  - 1.1.4 Unlocking a Multidev
  - 1.1.5 Cloning a Multidev Locally Using Git
  - 1.1.6 Deleting a Multidev
  - 1.1.7 Merging Dev changes to a Multidev
- 1.2 Related Articles

Multidev Management

In order to interact with a Multidev you must have a developer account setup for your college website on the Pantheon platform. These accounts are created by the ITS Web Team, the site owner needs to request developer access via email or Slack.

Creating a Multidev

In depth information about Multidev environments is available in the Pantheon documentation. When a Multidev is created, a branch is also created with the same name.

Login the Pantheon dashboard for your college
Click the Multidev tab
Click the Create an Environment button
On the Create Multidev Environment modal that pops up, Name the New Environment and Git Branch and under the Cone Database and Files From: drop-down select a database.
Click the Create Environment button
Wait
Once it is done you will see:
Click the name of your Multidev to open its dashboard

Launching a Multidev Site

You can visit the URL presented when you first created the Multidev, or follow this step below.

On your Multidev dashboard, click the Visit {{ name of your Multidev }} Site button

The URL will work until the Multidev is deleted. The URL is public facing and can be locked if needed.

Locking a Multidev

When a Multidev is created, it is public facing, anyone with the URL can view it unless it is locked. This step is not required and can be used at your discretion.

From your Multidev dashboard, click the Security option on the left menu
In the Environmental Access section, click the Locked button
Enter a Username
Enter a Password
Click the Lock Environment button

Unlocking a Multidev

If your Multidev is locked, only users with the Username and Password you set can view your site.

From your Multidev dashboard, click the Security option on the left menu
In the Environmental Access section, click the Public button

Cloning a Multidev Locally Using Git

To accomplish this step, you must already have installed Git on your computer.

Click the Clone with Git button
Click the Show Detailed Instructions link
Use the steps in the Example section to familiarize yourself with the Git commands required to make your changes and push them back into the Multidev

Visit the Local Development Stack article to read more about testing your changes locally.

Deleting a Multidev

When a Multidev is no longer needed, it is safe to delete the environment.

Navigate to your Pantheon dashboard
Click the drop down arrow on the Multidev tab
Click Multidev overview
Click the Delete Environment button
Type DELETE in the text box
Click the Delete the {{ Name of your Multidev }} Environment button

Merging Dev changes to a Multidev

Expand the ▶There are (n) commits that can be merged from master. accordion on your multidev dashboard
Click the Merge button
Once the merge is complete, click the Clear Caches button

Expand the Workflows to check merge progress

Check for any database updates on updates.php

Multidev