acquia MEO Codebase Management
Platform: This skill applies to MEO (Multi-site Enterprise Operations) subscriptions only.
Use when:
- Listing or inspecting codebases for a subscription
- Browsing git branches and tags (references) available in a codebase
- Creating a new codebase for a subscription
- Managing domain routing patterns on a codebase
Note: All commands use acli api:v3:*. Run acli list api:v3:codebases to see all current codebase commands.
List Codebases
# Codebases for a subscription
acli api:v3:subscriptions:list-codebases <subscriptionId>
# All codebases you have access to
acli api:v3:codebases:list
Get Codebase Details
acli api:v3:codebases:find <codebaseId>
Returns id, label, region, vcs_url, status, and linked subscription.
Create a Codebase
acli api:v3:subscriptions:create-codebase <subscriptionId> <codebase_id> <label> <region>
| Argument | Required | Description |
|---|---|---|
subscriptionId |
Yes | UUID of the subscription |
codebase_id |
Yes | Client-supplied UUID for the new codebase |
label |
Yes | Human-readable name |
region |
Yes | AWS region (e.g. us-east-1) |
Update a Codebase
acli api:v3:codebases:update <codebaseId> --label="New Label" --description="..."
Delete a Codebase
Destructive operation — explicit approval required. Permanently deletes the codebase. All sites referencing this codebase must be deleted first. This cannot be undone. Confirm with the user before executing.
acli api:v3:codebases:delete <codebaseId>
List Environments for a Codebase
acli api:v3:codebases:list-environments <codebaseId>
Returns all environments that have site instances built from this codebase.
List Sites for a Codebase
acli api:v3:codebases:list-sites <codebaseId>
Browse Git References (Branches & Tags)
# List all branches and tags
acli api:v3:codebases:list-references <codebaseId>
# Get details for a specific reference
acli api:v3:codebases:find-reference <codebaseId> <referenceName>
referenceName examples: refs/heads/main, refs/tags/1.2.0
Domain Patterns
Domain patterns define URL routing rules for sites in this codebase.
# List domain patterns
acli api:v3:codebases:list-domain-patterns <codebaseId>
# Create a domain pattern
acli api:v3:codebases:create-domain-pattern <codebaseId> ...
# Update a domain pattern
acli api:v3:codebases:update-domain-pattern <codebaseId> <patternId> ...
# Get a specific pattern
acli api:v3:codebases:find-domain-pattern <codebaseId> <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:codebases:delete-domain-pattern <codebaseId> <patternId>
Typical Workflows
Inspect a codebase and its git branches
# Find the codebase
acli api:v3:subscriptions:list-codebases <subscriptionId>
# Browse available branches
acli api:v3:codebases:list-references <codebaseId>
# Confirm the branch you want to deploy exists
acli api:v3:codebases:find-reference <codebaseId> refs/heads/main
Provision a new codebase
# Generate a UUID (or use your own)
CODEBASE_UUID=$(python3 -c "import uuid; print(uuid.uuid4())")
acli api:v3:subscriptions:create-codebase <subscriptionId> \
"$CODEBASE_UUID" \
"My Codebase" \
us-east-1
Discover More Commands
acli list api:v3:codebases
acli list api:v3:subscriptions
acli api:v3:codebases:list-references --help
Related Topics
- MEO Overview — ACE vs MEO, data model
- MEO Sites — Sites that reference this codebase
- MEO Environments — Where code from this codebase runs
- MEO Deployments — Deploy a branch from this codebase