Mass CLI Overview

The Mass CLI is a powerful command line interface for interacting with the Massdriver platform. It is used to build and publish bundles, manage deployments, and more.

Installation

Manual Installation

To install (or update) the Mass CLI manually, download the latest release from the Mass CLI releases page.

Select the file that matches your operating system and architecture, i.e. mass_darwin_amd64.zip for Mac OS users.

Unzip the mass file and move it to a directory in your $PATH, i.e. /usr/local/bin.

note

For Mac OS users, you will need to allow mass to run by opening the System Preferences app, clicking on Security & Privacy, and clicking on the Open Anyway button. You may need to do this a second time after attempting to invoke the mass command.

Commands

Applications

• mass app configure - Configures applications on Massdriver
• mass app deploy - Deploys applications to Massdriver
• mass app patch - Patches application configuration on Massdriver

Bundles

• mass bundle new - Interactive wizard to create a new bundle from a template
• mass bundle build - Hydrates a bundle with necessary schema files and validates the massdriver.yaml file
• mass bundle publish - Publishes a bundle to your Massdriver organization
• mass bundle lint - Validates a bundle's massdriver.yaml file
• mass bundle template list - Lists all available bundle templates
• mass bundle template refresh - Refreshes the list of available bundle templates

Image

• mass image push - Builds and pushes an image to a cloud image registry (e.g. ACR, ECR, or GCR)

Infrastructure

• mass infra configure - Configures infrastructure on Massdriver
• mass infra deploy - Deploys infrastructure to Massdriver
• mass infra patch - Patches infrastructure configuration on Massdriver

Preview

• mass pv decommission - Decommissions an initialized preview in your project
• mass pv deploy - Deploys a preview in your project
• mass pv init - Generates a preview config file