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>

# 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

Related Topics

• MEO Overview — ACE vs MEO, data model
• MEO Sites — Manage sites
• MEO Site Instances — Per-site operations within this environment
• MEO Deployments — Monitor and control running deployments
• MEO CDN & Security — CDN purge, security rules