meo-environments

MEO Environment Management

Platform: This skill applies to MEO (Multi-site Enterprise Operations) subscriptions only. For ACE environment management, see Environment Management.

Use when:

Getting environment details in a MEO subscription
Enabling or disabling environment protection mode
Clearing caches across domains
Creating, listing, or reordering site instances in an environment
Managing deployments, egress IPs, private network, or trusted proxies
Managing environment-level domain patterns

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

Get Environment Details

acli api:v3:environments:find <environmentId>

Returns environment label, status, PHP version, region, codebase link, and server configuration.

# List environments for a codebase
acli api:v3:codebases:list-environments <codebaseId>

# List environments for a site
acli api:v3:sites:list-environments <siteId>

Update Environment Properties

acli api:v3:environments:update <environmentId> \
  --label="Staging" \
  --description="..." \
  --properties='{"php_version":"8.2"}'

Protection Mode

Protection mode prevents destructive operations from being performed on the environment.

# Enable — locks environment against wipes, deletes, and risky deployments
acli api:v3:environments:enable-protection-mode <environmentId>

# Disable — allows destructive operations to proceed
acli api:v3:environments:disable-protection-mode <environmentId>

Clear Caches

acli api:v3:environments:clear-caches <environmentId> <domains>

domains is a space-separated list of domain names to clear:

acli api:v3:environments:clear-caches <environmentId> example.com www.example.com

Site Instance Management

# List site instances in this environment
acli api:v3:environments:list-site-instances <environmentId>

# Associate a site with this environment (creates a site instance)
acli api:v3:environments:create-site-instance <environmentId> <site_id>

# Optional: copy files and database from a source environment during creation
acli api:v3:environments:create-site-instance <environmentId> <site_id> \
  --source_environment_id=<srcEnvId> \
  --source_site_id=<srcSiteId>

# Reorder site instances (affects display order)
acli api:v3:environments:reorder-site-instances <environmentId> ...

Deployments

# List deployments for this environment
acli api:v3:environments:list-deployments <environmentId>

# Start a deployment (deploy a branch or tag)
acli api:v3:environments:create-deployment <environmentId> <run_hooks> <code_reference>

Argument	Description
`run_hooks`	`true` or `false` — whether to execute deployment hooks
`code_reference`	Branch or tag name (e.g. `refs/heads/main`)

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

Returns a deploymentId. Track progress with acli api:v3:deployments:find <deploymentId>.

Code Deploy Concurrency

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

# Update concurrency (max concurrent site deployments)
acli api:v3:environments:update-code-deploy <environmentId> <concurrency>

CDN Purge

# Purge CDN cache for specific content
acli api:v3:environments:purge-cdn <environmentId> <resource_type> --values='["value1","value2"]'

resource_type options: url, tag, all

Egress IPs

acli api:v3:environments:list-egress-ips <environmentId>

Returns the outbound IP addresses for this environment (useful for allowlisting).

Private Network

# Check private network association
acli api:v3:environments:find-private-network <environmentId>

# Associate with a private network
acli api:v3:environments:associate-private-network <environmentId> <private_network_id>

Caution: Disassociating removes network isolation. Confirm with the user before executing.

acli api:v3:environments:disassociate-private-network <environmentId>

Trusted Proxies

# Get trusted proxy configuration
acli api:v3:environments:find-trusted-proxies <environmentId>

# Update trusted proxies
acli api:v3:environments:update-trusted-proxies <environmentId> ...

Domain Patterns

# List domain patterns
acli api:v3:environments:list-domain-patterns <environmentId>

# Create a domain pattern
acli api:v3:environments:create-domain-pattern <environmentId> ...

# Find, update a pattern
acli api:v3:environments:find-domain-pattern <environmentId> <patternId>
acli api:v3:environments:update-domain-pattern <environmentId> <patternId> ...

Destructive operation — explicit approval required. Deleting a domain pattern removes URL routing rules and may break site access. Confirm with the user before executing.

acli api:v3:environments:delete-domain-pattern <environmentId> <patternId>

Multi-Region Failover

# Get failover status
acli api:v3:environments:find-multi-region-failover <environmentId>

# Enable multi-region failover
acli api:v3:environments:update-multi-region-failover <environmentId>

# Disable multi-region failover
acli api:v3:environments:delete-multi-region-failover <environmentId>

Typical Workflows

Deploy a new release

# 1. Start the deployment
acli api:v3:environments:create-deployment <environmentId> true refs/heads/release/1.5

# 2. Track the deployment
acli api:v3:deployments:find <deploymentId>

Lock an environment before maintenance

acli api:v3:environments:enable-protection-mode <environmentId>
# ... perform maintenance ...
acli api:v3:environments:disable-protection-mode <environmentId>

Discover More Commands

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

About this skill