Skip to main content

Multidev Workflow and Configuration

Use Multidev with Front-End Sites.

Discuss in Slack
Edit this page on GitHub Report an issue with this doc

Warning

This documentation is considered deprecated. If you use Front-End Sites today, we encourage you to migrate.

This section provides information on the Front-End Sites Multidev workflow, configuration steps to connect your Front-End Site to a Multidev environment, and information on Multidev branch builds.

Front-End Sites Multidev Development Workflow

The Front-End Sites Multidev workflow is outlined below:

  • Code Push: The external Git provider controls code posts and deployments. Code pushed to the main branch is built and deployed in your Live environment. Code pushed to any other branch generates a new Multidev environment. Updates to existing branches result in the corresponding environment being updated.

  • Pull Request: The Multidev environment is stood up and the preview and backend URL are displayed in the GitHub PR, the GitHub deployment, and in the Front-End Sites Overview section of the dashboard. The build details for a PR are also linked to GitHub.

Connect to a Multidev Environment

Multidev Branch Builds

You can build specific branches by naming the branch to begin with the prefix multi-.

Follow the steps below to observe the build and deployment process for a Multidev branch in real time. Note that the steps below assume that you have already cloned your Front-End Site repository from GitHub to your local.

  1. Check out the main branch of your repository.

  2. Create a new branch using the multi- prefix, for example:

  3. Make a change to a file in your repository.

  4. Add and commit the change to the main branch.

  5. Push the branch:

  6. Open your Site Dashboard, navigate to the Overview page and scroll down to the Multidev Branches section. You should see your Multidev branch begin to build after approximately a minute.

  7. Use the Actions drop-down menu to visit the Multidev version of the site, view the logs, or get more information about the build.

Any commits pushed on this branch will now be built and deployed to the Multidev. This allows you and your team to review the branch as work progresses. Pull requests opened against this branch will also trigger a build.

Delete a Multidev Environment

  1. Open your Site Dashboard, navigate to the Overview page and scroll down to the Multidev Branches section.
  2. Use the Actions drop-down menu to delete the given Multidev.
  3. Type the Multidev name into the text field to complete the confirmation prompt and delete the environment.

More Resources