agentleFS
acquiaacquia/acquia-skills/skills/acli/meo-site-instances/SKILL.md

meo-site-instances

Skill10 starsChanged 38 days agoMITView on GitHub

Use when managing MEO site instances: inspecting a site in a specific environment, managing domains, databases, backups, protection mode, or scheduling a site instance for deletion.

The file

We split this skill into the rules it gives an agent

1 rule. About 0 are common, 0 are distinctive, and 1 is very specific to this project.

  • ≈0

    Common · estimate

    Many files like this have a rule of this kind.

  • ≈0

    Distinctive · estimate

    This author's own choices. Worth a look.

  • 1

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Very specific:

    Note: All commands use acli api:v3:*.

    line 31

≈ “Common” is an estimate: at least 1 in 5 of the 364,980 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

MEO Site Instance Management

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

A site instance is a specific Site running inside a specific Environment. Each site instance has its own domain(s), database, and protection mode state.

Use when:

  • Inspecting a site's status within a specific environment
  • Managing domains for a site instance
  • Accessing database details or managing backups
  • Enabling, disabling, or inheriting protection mode
  • Scheduling a site instance for deletion or recovering it
  • Wiping a site instance (database + files reset)

Addressing site instances: Commands require both <siteId> and <environmentId> as separate arguments.

Note: All commands use acli api:v3:*. Run acli list api:v3:site-instances to see all current commands.


Get Site Instance Details

acli api:v3:site-instances:find <siteId> <environmentId>

Returns status, domains, protection mode, database connection, and deployment info.


List Site Instances in an Environment

acli api:v3:environments:list-site-instances <environmentId>

Protection Mode

Protection mode prevents destructive operations (wipe, deletion) on the site instance.

# Enable protection on this site instance
acli api:v3:site-instances:enable-protection-mode <siteId> <environmentId>

# Disable protection
acli api:v3:site-instances:disable-protection-mode <siteId> <environmentId>

# Inherit protection mode from the parent environment
acli api:v3:site-instances:inherit-protection-mode <siteId> <environmentId>

Domains

# List domains assigned to this site instance
acli api:v3:site-instances:list-domains <siteId> <environmentId>

# Get details for a specific domain
acli api:v3:site-instances:find-domain <siteId> <environmentId> <domainName>

# Check domain provisioning status
acli api:v3:site-instances:find-domain-status <siteId> <environmentId> <domainName>

Database

# Get database connection details
acli api:v3:site-instances:find-database <siteId> <environmentId>
acli api:v3:site-instances:find-database-connection <siteId> <environmentId>

Database Backups

# List available backups
acli api:v3:site-instances:list-database-backups <siteId> <environmentId>

# Get details for a specific backup
acli api:v3:site-instances:find-database-backup <siteId> <environmentId> <backupId>

# Create a backup
acli api:v3:site-instances:create-database-backup <siteId> <environmentId>

# Restore a backup
acli api:v3:site-instances:restore-database-backup <siteId> <environmentId> <backupId>

Caution: Restoring a backup overwrites the current database. This cannot be undone. Confirm with the user before executing.


Copy Files or Database from Another Environment

# Copy files from another environment
acli api:v3:site-instances:copy-files <siteId> <environmentId> <source_environment_id>

# Copy database from another environment
acli api:v3:site-instances:copy-database <siteId> <environmentId> <source_environment_id>

Caution: These operations overwrite the current files or database. Confirm with the user before executing.


Cancel or Delete a Site Instance

# Dissociate a site from an environment (with grace period)
acli api:v3:site-instances:cancel <siteId> <environmentId>

Schedule Deletion

Caution: Schedules the site instance for deletion. Use acli api:v3:site-instances:recover within the grace period to cancel.

acli api:v3:site-instances:schedule-delete <siteId> <environmentId>

Recover from Scheduled Deletion

acli api:v3:site-instances:recover <siteId> <environmentId>

Wipe a Site Instance

Destructive operation — explicit approval required. Resets the site instance database and files to a clean state. All content and configuration will be lost. This cannot be undone. Confirm with the user before executing.

acli api:v3:site-instances:wipe <siteId> <environmentId>

Typical Workflows

Refresh a staging site from production

# Copy database from prod environment
acli api:v3:site-instances:copy-database <siteId> <stagingEnvId> <prodEnvId>

# Copy files from prod environment
acli api:v3:site-instances:copy-files <siteId> <stagingEnvId> <prodEnvId>

Create a backup before a risky operation

# Create backup
acli api:v3:site-instances:create-database-backup <siteId> <environmentId>

# List to get the backup ID
acli api:v3:site-instances:list-database-backups <siteId> <environmentId>

# If something goes wrong, restore
acli api:v3:site-instances:restore-database-backup <siteId> <environmentId> <backupId>

Lock a site instance for maintenance

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

Discover More Commands

acli list api:v3:site-instances
acli api:v3:site-instances:find --help

Related Topics

  • MEO Overview — ACE vs MEO, data model
  • MEO Sites — Manage the site definition
  • MEO Environments — Manage the environment containing this site instance
  • MEO Deployments — Track code deployment into this environment

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.