Command Line Interface
Manage automations, scripts, run tests, view logs, download, watch, publish and more from the command line.
Commands
Type mesa
to get a list of available commands:
mesa export
mesa push [params]
mesa pull [params]
mesa watch
mesa install [version]
mesa test
mesa replay mesa logs [-v] [-n 50]
Optional Parameters:
-e, --env [value] : Environment to use (filename in ./config/).
-a, --automation [value] : Automation key. Automatically determined by the mesa.json file if not specified.
-f, --force : Force, overwrite config for inputs/outputs/storage.
-n, --number [value] : Number.
-v, --verbose : Verbose: Show log metadata.
Installing
With yarn
yarn global add mesa-cli
Or with NPM
npm install -g mesa-cli
Upgrading
To upgrade to the latest version
yarn global upgrade mesa-cli@latest
Configuring sites
Create a new directory with a config.yml file:
uuid: mystoreuuid
key: J0lSB0PIuw145xhk610Ud6dLA7A****B7LnfUjaL
The config.yml file can be in your current working directory, or in ~/.mesa/config.yml
so you can run mesa
from any working directory.
uuid
is your myshopify.com subdomain: UUID.myshopify.com
key
is your site's MESA Key from the bottom of the Reports tab of the MESA Dashboard .
Optional parameter: api_url
.
Specifying environments
Delete your global
~/.mesa/config.yml
fileSave configuration files in
~/.mesa/config
. For example:~/.mesa/config/mystoreuuid.yml
Pass the environment with the
--env
or-e
flags, or by setting theENV
envvar:
mesa watch --env mystoreuuid
mesa watch -e mystoreuuid
ENV=mystoreuuid
mesa watch export ENV=mystoreuuid && mesa watch
Editing Automations
To get started, export an automation to download the scripts and configuration into the current directory:
mesa export <automationkey>
Then use the utility functions to keep your local code in sync with MESA:
mesa watch <...files>
mesa push <...files>
mesa pull <...files>
<...files>
can be:
Specific path(s) to files: tracktor/in-webhook.js tracktor/out-webhook.js
Or for multiple files: tracktor/*
Local development
To clone mesa-cli
locally and install it globally:
git clone [email protected]:shoppad/mesa-cli.git
cd mesa-cli
yarn link
Last updated
Was this helpful?