A newer version of this documentation is available: View the Latest Version

CLI Commands

This page introduces the Pacemaker Command Line Interface (CLI) and explains how to configure and run Pacemaker and its components.

What is the Pacemaker CLI?

  • The Pacemaker Command Line Interface (Pacemaker CLI) is a simple tool that allows you to control, run, and optionally configure Pacemaker and all installed components and modules from your terminal application’s command prompt.

  • Pacemaker CLI uses as base command the well known Magento CLI bin/magento command

  • Pacemaker's CLI is the user’s primary entry point into Pacemaker

  • The use of the command line requires a basic knowledge of using a command-line tool (terminal) in general

  • When using the Pacemaker command-line interface, you can specify optional configuration overrides using CLI options or environment variables as needed

Usage

Open the CLI tool of your choice (Terminal, ITerm2,…​), type the desired command in the prompt of your terminal application and then press Enter to execute it.

The command consists of the program name (or the program path), followed by the required command and/or the options and arguments needed for it.

In the next sections we will break these down in basic terms for the Pacemaker command line.

  • Every command starts with the base call (i.e., program name or path)

Example

Pacemaker base call
bin/magento

Command inputs and structure

Basic Pacemaker CLI command structure
bin/magento [command]:[action|shortcut] [--option1 --option2] [optional arguments]

Example

listing and displaying all pipelines with a simple command
bin/magento pacemaker:pipeline:status
Extended Pacemaker CLI command structure
bin/magento [command]:[step][action|shortcut] [--option1 --option2] [optional arguments] (1)
1 For some commands, it is possible to call a more defined command.

Example extended

Detail display of the step, in our example, it is ID 173.
bin/magento pipeline:step:process 173
bin/magento pacemaker:pipeline:details 21