meo-deployments

MEO Deployment Management

Platform: This skill applies to MEO (Multi-site Enterprise Operations) subscriptions only.

Use when:

Checking the status of a running or completed deployment
Stopping a deployment gracefully
Listing all deployments for an environment
Terminating a stuck deployment immediately

Starting a deployment: See MEO Environments — use acli api:v3:environments:create-deployment.

Note: All commands use acli api:v3:*. Run acli list api:v3:deployments to see all current deployment commands.

Start a Deployment

Deployments are started from the environment, not the deployment resource:

acli api:v3:environments:create-deployment <environmentId> <run_hooks> <code_reference>

# Deploy main branch with hooks enabled
acli api:v3:environments:create-deployment <environmentId> true refs/heads/main

# Deploy a tag without hooks
acli api:v3:environments:create-deployment <environmentId> false refs/tags/1.5.0

# Deploy with hook argument
acli api:v3:environments:create-deployment <environmentId> true refs/heads/main \
  --hooks_argument="production"

Returns a deploymentId to track progress.

Check Deployment Status

acli api:v3:deployments:find <deploymentId>

Returns status (pending, running, completed, failed, stopped, terminated), start time, and any error messages.

List Deployments for an Environment

acli api:v3:environments:list-deployments <environmentId>

Supports pagination and filtering:

acli api:v3:environments:list-deployments <environmentId> --limit=10 --sort=-created

Stop a Deployment

Sends a graceful stop request. The deployment finishes its current step and halts.

acli api:v3:deployments:stop <deploymentId>

Use when you want to safely interrupt a deployment that is taking too long or you've noticed an issue.

Terminate a Deployment

Destructive operation — explicit approval required. Immediately kills the deployment process regardless of current state. May leave sites in a partially deployed state. Confirm with the user before executing.

acli api:v3:deployments:terminate <deploymentId>

Use only when stop is insufficient (e.g. deployment is hung and unresponsive).

Code Deploy Concurrency

Controls how many site instances can be deployed in parallel within an environment:

# Get current setting
acli api:v3:environments:find-code-deploy <environmentId>

# Update concurrency
acli api:v3:environments:update-code-deploy <environmentId> <concurrency>

Typical Workflows

Deploy and monitor

# Start deployment
acli api:v3:environments:create-deployment <environmentId> true refs/heads/main

# Poll for completion (deploymentId returned above)
acli api:v3:deployments:find <deploymentId>

CI/CD pipeline deploy step

#!/bin/bash
set -e

DEPLOYMENT=$(acli api:v3:environments:create-deployment \
  "$ENV_ID" true "refs/heads/$BRANCH" --no-interaction)

DEPLOYMENT_ID=$(echo "$DEPLOYMENT" | python3 -c "import json,sys; print(json.load(sys.stdin)['id'])")

# Poll until complete
while true; do
  STATUS=$(acli api:v3:deployments:find "$DEPLOYMENT_ID" | \
    python3 -c "import json,sys; print(json.load(sys.stdin)['status'])")
  echo "Deployment status: $STATUS"
  case "$STATUS" in
    completed) echo "Deployment succeeded"; exit 0 ;;
    failed|stopped|terminated) echo "Deployment failed"; exit 1 ;;
  esac
  sleep 15
done

Discover More Commands

acli list api:v3:deployments
acli list api:v3:environments
acli api:v3:environments:create-deployment --help

About this skill